Stimulsoft Ultimate是用于創建報表和儀表板的通用工具集。該產品包括用于WinForms、ASP.NET、.NET Core、JavaScript、WPF、PHP、Java和其他環境的完整工具集。

Stimulsoft Reports不僅擁有強大的報表導出系統，而且還支持多種報表導出格式，擁有簡單且強大的報表引擎。Stimulsoft Reports基本原則是，用簡單常規的方法創建報表，將不同的技術應用于應用程序。Stimulsoft Reports ..NET一個基于.NET框架的報表生成器，能夠幫助你創建結構、功能豐富的報表。不僅界面友好，而且使用便捷，能夠讓你輕松創建所有報表。

點擊下載Stimulsoft Reports .NET v2021.3.1最新版

此示例顯示如何創建自定義組件并將其添加到報表設計器。自定義組件提供了在報表設計器中添加組件及其參數并在報表中使用的功能。例如，您可以添加 stimulsoft 報告中不存在的圖表。

首先，指定屬性及其值：

[StiServiceBitmap(typeof(MyCustomComponent), "CustomComponent.MyCustomComponent1.gif")]
[StiToolbox(true)]
[StiContextTool(typeof(IStiShift))]
[StiContextTool(typeof(IStiGrowToHeight))]
[StiDesigner(typeof(MyCustomComponentDesigner))]
[StiV1Builder(typeof(MyCustomComponentV1Builder))]
[StiV2Builder(typeof(MyCustomComponentV2Builder))]
[StiGdiPainter(typeof(MyCustomComponentGdiPainter))]

...

接下來，創建一個MyCustomComponent類并指定繼承的類。此外，覆蓋所需的組件屬性：

...

public class MyCustomComponent : StiComponent, IStiBorder, IStiBrush
{
	#region StiComponent override
	/// <summary>
	/// Gets value to sort a position in the toolbox.
	/// </summary>
	public override int ToolboxPosition
	{
		get
		{
			return 500;
		}
	}
	
	/// <summary>
	/// Gets a localized name of the component category.
	/// </summary>
	public override string LocalizedCategory
	{
		get
		{
			return StiLocalization.Get("Report", "Components");
		}
	}
	
	/// <summary>
	/// Gets a localized component name.
	/// </summary>
	public override string LocalizedName
	{
		get
		{
			return "MyCustomComponent1";
		}
	}
	#endregion

...

向組件添加新屬性 -Border和Brush，并設置它們的默認值。

...

	#region IStiBorder
	private StiBorder border = new StiBorder();
	/// <summary>
	/// Gets or sets a frame of the component.
	/// </summary>
	[StiCategory("Appearance")]
	[StiSerializable]
	[Description("Gets or sets frame of the component.")]
	public StiBorder Border
	{
		get
		{
			return border;
		}
		set
		{
			border = value;
		}
	}
	#endregion
	
	#region IStiBrush
	private StiBrush brush = new StiSolidBrush(Color.Transparent);
	/// <summary>
	/// Gets or sets a brush to fill a component.
	/// </summary>
	[StiCategory("Appearance")]
	[StiSerializable]
	[Description("Gets or sets a brush to fill a component.")]
	public StiBrush Brush
	{
		get
		{
			return brush;
		}
		set
		{
			brush = value;
		}
	}
	#endregion
	
...

向該MyCustomComponent類型的新組件添加必要的構造函數：

...

	#region this
	/// <summary>
	/// Creates a new component of the type MyCustomComponent.
	/// </summary>
	public MyCustomComponent() : this(RectangleD.Empty)
	{
	
	}
	
	/// <summary>
	/// Creates a new component of the type MyCustomComponent.
	/// </summary>
	/// <param name="rect">The rectangle describes size and position of the component.</param>
	public MyCustomComponent(RectangleD rect) : base(rect)
	{
		PlaceOnToolbox = true;
	}
	#endregion
}

該AddCustomComponent()方法將自定義組件添加到StiConfig.Services集合中，現在我們可以在報表設計器工具欄中找到它：

private static void AddCustomComponent()
{
	StiConfig.Load();
	
	StiOptions.Engine.ReferencedAssemblies = new string[] {
		"System.Dll",
		"System.Drawing.Dll",
		"System.Windows.Forms.Dll",
		"System.Data.Dll",
		"System.Xml.Dll",
		"Stimulsoft.Controls.Dll",
		"Stimulsoft.Base.Dll",
		"Stimulsoft.Report.Dll",
		
		#region Add reference to your assembly
		"CustomComponent.exe"
		#endregion
	};
	
	StiConfig.Services.Add(new MyCustomComponent());
	StiConfig.Services.Add(new MyCustomComponentWithDataSource());
	StiConfig.Services.Add(new MyCustomComponentWithExpression());
	StiConfig.Save();
}

在下面的屏幕截圖中，您可以看到示例代碼的結果：