Stimulsoft Ultimate是用于創(chuàng)建報表和儀表板的通用工具集。該產(chǎn)品包括用于WinForms、ASP.NET、.NET Core、JavaScript、WPF、PHP、Java和其他環(huán)境的完整工具集。

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

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

此示例顯示如何創(chuàng)建自定義組件并將其添加到報表設(shè)計器。自定義組件提供了在報表設(shè)計器中添加組件及其參數(shù)并在報表中使用的功能。例如，您可以添加 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))]

...

接下來，創(chuàng)建一個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，并設(shè)置它們的默認值。

...

	#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類型的新組件添加必要的構(gòu)造函數(shù)：

...

	#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集合中，現(xiàn)在我們可以在報表設(shè)計器工具欄中找到它：

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();
}

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