之前一直使用各種報表工具，如RDLC、DevExpress套件的XtraReport報表护昧，在之前一些隨筆也有介紹莫其，最近接觸銳浪的Grid++報表癞尚，做了一些測試例子和輔助類來處理報表內(nèi)容，覺得還是很不錯的乱陡，特別是它的作者提供了很多報表的設(shè)計模板案例浇揩，功能還是非常強大的。試著用來做一些簡單的報表憨颠，測試下功能胳徽，發(fā)現(xiàn)常規(guī)的二維表、套打爽彤、條形碼二維碼等我關(guān)注的功能都有养盗，是一個比較強大的報表控件，本篇隨筆主要介紹在Winform開發(fā)中使用Grid++報表設(shè)計報表模板适篙，以及綁定數(shù)據(jù)的處理過程往核。
1、報表模板設(shè)計
這個報表系統(tǒng)嚷节，報表模板提供了很多案例聂儒，我們可以大概瀏覽下其功能蝶缀。
它對應(yīng)在相應(yīng)的文件目錄里面，我們可以逐一查看了解下薄货，感覺提供這么多報表還是很贊的翁都，我們可以參考著來用，非常好谅猾。
整個報表主要是基于現(xiàn)有數(shù)據(jù)進行一個報表的模板設(shè)計的沼溜，如果要預(yù)覽效果冗美，我們一般是需要綁定現(xiàn)有的數(shù)據(jù)，可以從各種數(shù)據(jù)庫提供數(shù)據(jù)源，然后設(shè)計報表模板拳氢，進行實時的數(shù)據(jù)和格式查看及調(diào)整撵术。
空白的報表模板大概如下所示嚼黔，包含頁眉頁腳盖呼，以及明細表格的內(nèi)容。
根據(jù)它的教程弧岳，模仿著簡單的做了一個報表凳忙，也主要是設(shè)計報表格式的調(diào)整，和數(shù)據(jù)源的處理的關(guān)系禽炬，我們做一個兩個報表就可以很快上手了涧卵。
為了動態(tài)的加入我們表格所需要的列，我們可以通過數(shù)據(jù)庫里面的字段進行加入腹尖，首先提供數(shù)據(jù)源柳恐，指定我們具體的表即可（如果是自定義的信息，則可以手工添加字段）
這個里面就是配置不同的數(shù)據(jù)庫數(shù)據(jù)源了
如SQLServer數(shù)據(jù)庫的配置信息如下热幔。
為了方便乐设，我們可以利用案例的Access數(shù)據(jù)庫，也就是Northwind.mdb來測試我們的報表绎巨，弄好這些我們指定對應(yīng)的數(shù)據(jù)表數(shù)據(jù)即可近尚。
這里面配置好數(shù)據(jù)庫表信息后，我們就可以用它生成相關(guān)的字段和對應(yīng)的列信息了
修改列的表頭认烁，讓它符合中文的表頭列肿男，如下所示。
我們在頁腳出却嗡，加入了打印時間，頁碼的一些系統(tǒng)變量嘹承，具體操作就是添加一個綜合文本窗价，然后在內(nèi)容里面插入指定的域內(nèi)容即可，如下所示
預(yù)覽報表叹卷，我們就可以看到具體的報表格式顯示了撼港。
通過上面的操作坪它，感覺生成一個報表還是很方便的，接著我有根據(jù)需要做了一個二維碼的報表顯示帝牡，方便打印資產(chǎn)標簽往毡。
綁定數(shù)據(jù)源顯示的報表視圖如下所示，看起來還是蠻好的靶溜。
2开瞭、數(shù)據(jù)綁定
一般我們綁定數(shù)據(jù)源，有的時候可以直接指定數(shù)據(jù)庫連接罩息，有時候可以綁定具體的數(shù)據(jù)列表嗤详，如DataTable或者List<T>這樣的數(shù)據(jù)源，不同的方式報表控件的代碼綁定不同瓷炮。
直接綁定數(shù)據(jù)表的路徑如下所示葱色。
/// <summary>
/// 普通連接數(shù)據(jù)庫的例子-打印預(yù)覽
/// </summary>
private void btnNormalDatabase_Click(object sender, EventArgs e)
{
Report = new GridppReport();
string reportPath = Path.Combine(Application.StartupPath, "Reports\\testgrid++.grf");
string dbPath = Path.Combine(Application.StartupPath, "Data\\NorthWind.mdb");
//從對應(yīng)文件中載入報表模板數(shù)據(jù)
Report.LoadFromFile(reportPath);
//設(shè)置與數(shù)據(jù)源的連接串，因為在設(shè)計時指定的數(shù)據(jù)庫路徑是絕對路徑娘香。
if (Report.DetailGrid != null)
{
string connstr = Utility.GetDatabaseConnectionString(dbPath);
Report.DetailGrid.Recordset.ConnectionString = connstr;
}
Report.PrintPreview(true);
}
而如果需要綁定和數(shù)據(jù)庫無關(guān)的動態(tài)數(shù)據(jù)源苍狰，那么就需要通過控件的FetchRecord進行處理了，如下代碼所示烘绽。
Report.FetchRecord += new _IGridppReportEvents_FetchRecordEventHandler(ReportFetchRecord);
通過這樣我們增加每一個對應(yīng)的列單元格信息舞痰，如下是隨帶案例所示
//在C#中一次填入一條記錄不能成功，只能使用一次將記錄全部填充完的方式
private void ReportFetchRecord()
{
//將全部記錄一次填入
Report.DetailGrid.Recordset.Append();
FillRecord1();
Report.DetailGrid.Recordset.Post();
Report.DetailGrid.Recordset.Append();
FillRecord2();
Report.DetailGrid.Recordset.Post();
Report.DetailGrid.Recordset.Append();
FillRecord3();
Report.DetailGrid.Recordset.Post();
}
private void FillRecord1()
{
C1Field.AsString = "A";
I1Field.AsInteger = 1;
F1Field.AsFloat = 1.01;
}
private void FillRecord2()
{
C1Field.AsString = "B";
I1Field.AsInteger = 2;
F1Field.AsFloat = 1.02;
}
private void FillRecord3()
{
C1Field.AsString = "C";
I1Field.AsInteger = 3;
F1Field.AsFloat = 1.03;
}
這樣處理肯定很麻煩诀姚，我們常規(guī)做法是弄一個輔助類响牛，來處理DataTable和List<T>等這樣類型數(shù)據(jù)的動態(tài)增加操作。
/// <summary>
/// 綁定實體類集合的例子-打印預(yù)覽
/// </summary>
private void btnBindList_Click(object sender, EventArgs e)
{
Report = new GridppReport();
//從對應(yīng)文件中載入報表模板數(shù)據(jù)
string reportPath = Path.Combine(Application.StartupPath, "Reports\\testList.grf");
Report.LoadFromFile(reportPath);
Report.FetchRecord += ReportList_FetchRecord;
Report.PrintPreview(true);
}
/// <summary>
/// 綁定DataTable的例子-打印預(yù)覽
/// </summary>
private void btnBindDatatable_Click(object sender, EventArgs e)
{
Report = new GridppReport();
//從對應(yīng)文件中載入報表模板數(shù)據(jù)
string reportPath = Path.Combine(Application.StartupPath, "Reports\\testList.grf");
Report.LoadFromFile(reportPath);
Report.FetchRecord += ReportList_FetchRecord2;
Report.PrintPreview(true);
}
private void ReportList_FetchRecord()
{
List<ProductInfo> list = BLLFactory<Product>.Instance.GetAll();
GridReportHelper.FillRecordToReport<ProductInfo>(Report, list);
}
private void ReportList_FetchRecord2()
{
var dataTable = BLLFactory<Product>.Instance.GetAllToDataTable();
GridReportHelper.FillRecordToReport(Report, dataTable);
}
其中輔助類 GridReportHelper 代碼如下所示赫段。
/// <summary>
/// Gird++報表的輔助類
/// </summary>
public class GridReportHelper
{
private struct MatchFieldPairType
{
public IGRField grField;
public int MatchColumnIndex;
}
/// <summary>
/// 將 DataReader 的數(shù)據(jù)轉(zhuǎn)儲到 Grid++Report 的數(shù)據(jù)集中
/// </summary>
/// <param name="Report">報表對象</param>
/// <param name="dr">DataReader對象</param>
public static void FillRecordToReport(IGridppReport Report, IDataReader dr)
{
MatchFieldPairType[] MatchFieldPairs = new MatchFieldPairType[Math.Min(Report.DetailGrid.Recordset.Fields.Count, dr.FieldCount)];
//根據(jù)字段名稱與列名稱進行匹配呀打，建立DataReader字段與Grid++Report記錄集的字段之間的對應(yīng)關(guān)系
int MatchFieldCount = 0;
for (int i = 0; i < dr.FieldCount; ++i)
{
foreach (IGRField fld in Report.DetailGrid.Recordset.Fields)
{
if (string.Compare(fld.RunningDBField, dr.GetName(i), true) == 0)
{
MatchFieldPairs[MatchFieldCount].grField = fld;
MatchFieldPairs[MatchFieldCount].MatchColumnIndex = i;
++MatchFieldCount;
break;
}
}
}
// 將 DataReader 中的每一條記錄轉(zhuǎn)儲到Grid++Report 的數(shù)據(jù)集中去
while (dr.Read())
{
Report.DetailGrid.Recordset.Append();
for (int i = 0; i < MatchFieldCount; ++i)
{
var columnIndex = MatchFieldPairs[i].MatchColumnIndex;
if (!dr.IsDBNull(columnIndex))
{
MatchFieldPairs[i].grField.Value = dr.GetValue(columnIndex);
}
}
Report.DetailGrid.Recordset.Post();
}
}
/// <summary>
/// 將 DataTable 的數(shù)據(jù)轉(zhuǎn)儲到 Grid++Report 的數(shù)據(jù)集中
/// </summary>
/// <param name="Report">報表對象</param>
/// <param name="dt">DataTable對象</param>
public static void FillRecordToReport(IGridppReport Report, DataTable dt)
{
MatchFieldPairType[] MatchFieldPairs = new MatchFieldPairType[Math.Min(Report.DetailGrid.Recordset.Fields.Count, dt.Columns.Count)];
//根據(jù)字段名稱與列名稱進行匹配，建立DataReader字段與Grid++Report記錄集的字段之間的對應(yīng)關(guān)系
int MatchFieldCount = 0;
for (int i = 0; i < dt.Columns.Count; ++i)
{
foreach (IGRField fld in Report.DetailGrid.Recordset.Fields)
{
if (string.Compare(fld.Name, dt.Columns[i].ColumnName, true) == 0)
{
MatchFieldPairs[MatchFieldCount].grField = fld;
MatchFieldPairs[MatchFieldCount].MatchColumnIndex = i;
++MatchFieldCount;
break;
}
}
}
// 將 DataTable 中的每一條記錄轉(zhuǎn)儲到 Grid++Report 的數(shù)據(jù)集中去
foreach (DataRow dr in dt.Rows)
{
Report.DetailGrid.Recordset.Append();
for (int i = 0; i < MatchFieldCount; ++i)
{
var columnIndex = MatchFieldPairs[i].MatchColumnIndex;
if (!dr.IsNull(columnIndex))
{
MatchFieldPairs[i].grField.Value = dr[columnIndex];
}
}
Report.DetailGrid.Recordset.Post();
}
}
/// <summary>
/// List加載數(shù)據(jù)集
/// </summary>
/// <typeparam name="T"></typeparam>
/// <param name="Report">報表對象</param>
/// <param name="list">列表數(shù)據(jù)</param>
public static void FillRecordToReport<T>(IGridppReport Report, List<T> list)
{
Type type = typeof(T); //反射類型
MatchFieldPairType[] MatchFieldPairs = new MatchFieldPairType[Math.Min(Report.DetailGrid.Recordset.Fields.Count, type.GetProperties().Length)];
//根據(jù)字段名稱與列名稱進行匹配糯笙，建立字段與Grid++Report記錄集的字段之間的對應(yīng)關(guān)系
int MatchFieldCount = 0;
int i = 0;
MemberInfo[] members = type.GetMembers();
foreach (MemberInfo memberInfo in members)
{
foreach (IGRField fld in Report.DetailGrid.Recordset.Fields)
{
if (string.Compare(fld.Name, memberInfo.Name, true) == 0)
{
MatchFieldPairs[MatchFieldCount].grField = fld;
MatchFieldPairs[MatchFieldCount].MatchColumnIndex = i;
++MatchFieldCount;
break;
}
}
++i;
}
// 將 DataTable 中的每一條記錄轉(zhuǎn)儲到 Grid++Report 的數(shù)據(jù)集中去
foreach (T t in list)
{
Report.DetailGrid.Recordset.Append();
for (i = 0; i < MatchFieldCount; ++i)
{
object objValue = GetPropertyValue(t, MatchFieldPairs[i].grField.Name);
if (objValue != null)
{
MatchFieldPairs[i].grField.Value = objValue;
}
}
Report.DetailGrid.Recordset.Post();
}
}
/// <summary>
/// 獲取對象實例的屬性值
/// </summary>
/// <param name="obj">對象實例</param>
/// <param name="name">屬性名稱</param>
/// <returns></returns>
public static object GetPropertyValue(object obj, string name)
{
//這個無法獲取基類
//PropertyInfo fieldInfo = obj.GetType().GetProperty(name, bf);
//return fieldInfo.GetValue(obj, null);
//下面方法可以獲取基類屬性
object result = null;
foreach (PropertyDescriptor prop in TypeDescriptor.GetProperties(obj))
{
if (prop.Name == name)
{
result = prop.GetValue(obj);
}
}
return result;
}
}
綁定數(shù)據(jù)的報表效果如下所示
導(dǎo)出報表為PDF也是比較常規(guī)的操作贬丛，這個報表控件也可以實現(xiàn)PDF等格式文件的導(dǎo)出，如下所示给涕。
private void btnExportPdf_Click(object sender, EventArgs e)
{
List<ProductInfo> list = BLLFactory<Product>.Instance.GetAll();
//從對應(yīng)文件中載入報表模板數(shù)據(jù)
string reportPath = Path.Combine(Application.StartupPath, "Reports\\testList.grf");
GridExportHelper helper = new GridExportHelper(reportPath);
string fileName = "d:\\my.pdf";
var succeeded = helper.ExportPdf(list, fileName);
if(succeeded)
{
Process.Start(fileName);
}
}
以上就是利用這個報表控件做的一些功能測試和輔助類封裝豺憔，方便使用。
