報(bào)表生成器FastReport .Net程序員手冊(cè)：注冊(cè)數(shù)據(jù)

---

FastReport .Net是適用于Windows Forms，ASP.NET，MVC和.NET Core的全功能報(bào)表解決方案。它可以在Microsoft Visual Studio 2005-2019中使用。支持.Net Framework 2.0-4.x，.NET Core 3.0及以上版本。

在FastReport .NET 2021.1的新版本中，我們實(shí)現(xiàn)了對(duì).NET 5的支持。添加了新條形碼-Deutsce Post Leitcode。將RTF轉(zhuǎn)換為報(bào)告對(duì)象的算法已得到顯著改進(jìn)。并且還添加了用于轉(zhuǎn)換數(shù)字的新功能。歡迎下載體驗(yàn)。（點(diǎn)擊下方按鈕下載）

立即點(diǎn)擊下載FastReport.NET v2021.1最新版

Fastreport.NET在線購買價(jià)更低，專享85折起！趕緊加入購物清單吧！

注冊(cè)數(shù)據(jù)

如果您的報(bào)表使用來自應(yīng)用程序的數(shù)據(jù)（例如，類型化數(shù)據(jù)集或業(yè)務(wù)對(duì)象），您必須在報(bào)表中注冊(cè)這些數(shù)據(jù)。這可以使用 Report 對(duì)象的 RegisterData 方法來完成。
當(dāng)您按照 "在Visual Studio中使用Report組件 "一節(jié)中的描述使用Report時(shí)，您不需要注冊(cè)數(shù)據(jù)。FastReport.Net會(huì)自動(dòng)做到這一點(diǎn)（它在表單的InitializeComponent方法中添加了RegisterData調(diào)用）。
RegisterData方法必須在您加載報(bào)表后調(diào)用。
report1 = new Report();
report1.Load("report.frx")；
report1.RegisterData(dataSet1, "NorthWind")；
RegisterData方法是重載的，允許注冊(cè)以下數(shù)據(jù)。

方法描述

void RegisterData(DataSet data)
注冊(cè)數(shù)據(jù)集。這個(gè)方法也注冊(cè)所有的表、視圖和關(guān)系。
注意：如果注冊(cè)多個(gè)數(shù)據(jù)集，請(qǐng)使用RegisterData(DataSet data, string name)方法代替。

void RegisterData(DataSet data,string name)
注冊(cè)數(shù)據(jù)集。在name參數(shù)中指定任何名稱（如果注冊(cè)多個(gè)數(shù)據(jù)集，它必須是持久的和唯一的）。

void RegisterData(DataTable data,string name)
注冊(cè)數(shù)據(jù)表。

void RegisterData(DataView data,string name)
注冊(cè)數(shù)據(jù)視圖。

void RegisterDataAsp(IDataSource data,string name)
注冊(cè)ASP.NET數(shù)據(jù)源，如AccessDataSource。

void RegisterData(DataRelation data,string name)
注冊(cè)關(guān)系。

void RegisterData(IEnumerable data,string name,BOConverterFlags,int maxNestingLevel)
注冊(cè)業(yè)務(wù)對(duì)象。在flags參數(shù)中指定應(yīng)該使用哪些項(xiàng)目（屬性、字段）。在m axNestingLevel參數(shù)中指定最大嵌套級(jí)別（通常不需要超過3級(jí)）。多個(gè)嵌套對(duì)象可能會(huì)減慢報(bào)表的速度。

向報(bào)表參數(shù)傳遞一個(gè)值

報(bào)告可能有參數(shù)。在《用戶手冊(cè)》中閱讀更多關(guān)于這方面的內(nèi)容。要向參數(shù)傳遞一個(gè)值，請(qǐng)使用Report對(duì)象的SetParameterValue方法。
report1.Load("report.frx");
report1.SetParameterValue("MyParam", 10);
report1.Show();
該方法聲明如下
public void SetParameterValue(string complexName, object value)
在c om plexNam e參數(shù)中指定參數(shù)的名稱。要訪問一個(gè)嵌套參數(shù)，請(qǐng)使用它的全稱，例如:

"ParentParam eter .ChildParam eter"

運(yùn)行報(bào)告

要運(yùn)行報(bào)告，請(qǐng)使用報(bào)告對(duì)象的以下方法之一。
方法描述
void Show() 

運(yùn)行報(bào)告并在預(yù)覽窗口中顯示。這個(gè)方法等于
if (Prepare())
ShowPrepared();

bool Prepare() 
運(yùn)行一個(gè)報(bào)表，如果報(bào)表編制成功，返回true。如果報(bào)表準(zhǔn)備成功，返回true.在這個(gè)方法之后，你需要調(diào)用以下方法之一。
ShowPrepared, PrintPrepared, SavePrepared, Export:
if(Prepare())

ShowPrepared();

bool Prepare(bool append)
運(yùn)行一個(gè)報(bào)表。如果append參數(shù)設(shè)置為 "true"，則準(zhǔn)備好的報(bào)表將被添加到現(xiàn)有的報(bào)表中。所以你可以建立多個(gè)報(bào)表，并將它們作為一個(gè)報(bào)表在預(yù)覽中顯示。
report1.Load("report1.frx");
report1.Prepare();
report1.Load("report2.frx");
report1.Prepare(true);
report.ShowPrepared();

void ShowPrepared()

在預(yù)覽窗口中顯示已準(zhǔn)備好的報(bào)告。報(bào)告必須使用Prepare方法準(zhǔn)備，或者使用LoadPrepared方法從.FPX文件中加載。
if (Prepare())
ShowPrepared();

void ShowPrepared(bool modal)
在預(yù)覽窗口中顯示已準(zhǔn)備好的報(bào)告。modal參數(shù)決定是否應(yīng)該以模式顯示預(yù)覽。

void ShowPrepared(bool modal,Form owner)

與前面的方法相同。ow ner參數(shù)確定擁有預(yù)覽窗口的窗口。

void ShowPrepared(Form mdiParent)

與前面的方法相同。m diParent參數(shù)決定主MDI窗口。

設(shè)計(jì)報(bào)告

您可以在您的應(yīng)用程序中使用報(bào)表設(shè)計(jì)器。除了Basic版本，所有FastReport.Net版本都可以這樣做。要做到這一點(diǎn)，請(qǐng)使用Report對(duì)象的Design方法。
report1 = new Report().Load("report1.frx");
report1.Load("report1.frx");
report1.Design()。
Design方法是重載的:

bool Design() 
顯示設(shè)計(jì)者

bool Design(bool modal)
顯示設(shè)計(jì)器。m odal參數(shù)決定是否需要以模式顯示設(shè)計(jì)器。

bool Design(Form mdiParent)
顯示設(shè)計(jì)器。m diParent參數(shù)定義主MDI窗口。

還想要更多嗎？您可以點(diǎn)擊閱讀【FastReport 報(bào)表2020最新資源盤點(diǎn)】，查找需要的教程資源。讓人興奮的是FastReport .NET報(bào)表正在慧都網(wǎng)火熱銷售中！慧都17周年慶惠享超低折扣，低至3701元起！>>查看價(jià)格詳情