XtraGrid的若干种用法

Posted 2020-09-20 赵哲丽

支持多种类型的数据集合作为数据源

　　XtraGrid与传统的DataGridView一样,支持多种类型作为其数据源。下面例子是将DataTable, List<T>和数组分别绑定到XtraGrid里面。

　　

//定义数据源
List<Person> peopleList=new List<Person>
{
    { ID = 1, FirstName = "Magnus", LastName = "Hedlund", Sex = true, Birth = new DateTime(1999, 9, 9), Chinese = 60, English = 80, Math = 79 },
    { ID = 2, FirstName = "Terry", LastName = "Adams", Sex = false, Birth = new DateTime(1999, 9, 9), Chinese = 60, English = 80, Math = 79 },
    { ID = 3, FirstName = "Charlotte", LastName = "Weiss", Sex = false, Birth = new DateTime() },
    { ID = 4, FirstName = "Arlene", LastName = "Huff", Sex = true, Birth = new DateTime(1999, 9, 9), Chinese = 60, English = 80, Math = 79 },
    { ID = 5, FirstName = "FirstName1", LastName = "LastName1", Sex = true, Birth = new DateTime(1999, 9, 9), Chinese=60, English=80, Math=79 },
 　　{ ID = 6, FirstName = "FirstName2", LastName = "LastName2", Sex = true, Birth = new DateTime(1999, 9, 19), Chinese = 60, English = 80, Math = 79 },
　　 { ID = 7, FirstName = "FirstName3", LastName = "LastName3", Sex = true, Birth = new DateTime(1999, 9, 29) },
　　 { ID = 8, FirstName = "FirstName4", LastName = "LastName4", Sex = true, Birth = new DateTime(1999, 2, 9), Chinese = 60, English = 80, Math = 79 },
　　 { ID = 9, FirstName = "FirstName5", LastName = "LastName5", Sex = true, Birth = new DateTime(1999, 4, 9) }
};
//将list<T>绑定到grid中
gridControl1.DataSource = peopleList;




People[] peopleArray=peopleList.ToArray();
//将数组绑定到grid中
gridControl1.DataSource = peopleArray;




DataTable peopleTable=new DataTable();

peopleTable.Columns.Add("FirstName");
peopleTable.Columns.Add("LastName");
peopleTable.Columns.Add("Sex");
peopleTable.Columns.Add("Birth");
peopleTable.Columns.Add("Chinese");
peopleTable.Columns.Add("English");
peopleTable.Columns.Add("Math");
peopleTable.Columns.Add("ID");

foreach (Person pi in people)
{
    DataRow row = peopleTable.Rows.Add();
    row["FirstName"] = pi.FirstName;
    row["LastName"] = pi.LastName;
    row["Sex"] = pi.Sex;
    row["Birth"] = pi.Birth;
    row["Chinese"] = pi.Chinese;
    row["English"] = pi.English;
    row["Math"] = pi.Math;
    row["ID"]=pi.ID;
}

//将DataTable绑定到grid中
gridControl1.DataSource = peopleTable;

 

 

统计运算的功能

 　　XtraGrid提供的统计运算的功能，包括求和，求平均值，最大值，最小值，行数，自定义统计。

　　做法是打开属性编辑器，在Columns ——> Columns properties下的 SummaryItem的SummaryType选择。

　　或者通过代码设置,例如：

this.bandedGridColumn2.SummaryItem.SummaryType= DevExpress.Data.SummaryItemType.Average;

DevExpress.Data.SummaryItemType是一个枚举，它的值有 Sum,Average,Max,Min,Count,Custom和None。

 

排序

 　　只要该列的ColumnsOptions的AllowSort属性不为False就可以根据那一列的数据进行排序。（AllowSort属性在属性编辑器的Columns的Columns Options选项卡。）设置Column properties下的SortOrder值。

　　或者通过代码，例如：

this.bandedGridColumn2.OptionsColumn.AllowSort=  DevExpress.Utils.DefaultBoolean.Default| DevExpress.Utils.DefaultBoolean.True;

this.bandedGridColumn2.SortOrder= DevExpress.Data.ColumnSortOrder.Ascending

　　另外在程序运行时，单击某列的列头也可以对该列进行排序。

 

分组

GridView view = gridControl1.MainView as GridView;
[] sortInfo = { 
        new GridColumnSortInfo(view.Columns["Chinese"], ColumnSortOrder.Ascending)
      };
view.SortInfo.(sortInfo, 2);

　　GridColumnSortInfo 数组存放的是分组的列的信息，调用ClearAndAddRange清除结果并进行分组。

 

筛选

 　　只要该列的Filter Options选项卡的AllowFilter属性不为False就可以进行筛选。

　　该属性通过代码设置是

this.bandedGridColumn2.OptionsFilter.AllowFilter = false;

　　运行程序后，鼠标指针移动到列标题，单击漏斗状图形经行筛选操作。

 

分页栏

 　　XtraGrid提供分页栏。通过这个设置可以显示出来。

gridControl1.UseEmbeddedNavigator = true;

　　如果要根据滚动条滚动实现翻页功能的，那得依靠Scroll事件。它又没像DataGridView那样开放滚动条事件，不过里面有一个事件可以替代Scroll事件，那就是TopRowChanged，例子如下：

        private void gridView1_TopRowChanged(object sender, EventArgs e)
        {

            if (gridView1.IsRowVisible(gridView1.RowCount - 1) == RowVisibleState.Visible) //如果滚到了底端
            {
                people.AddRange(new Person[] { Person1, Person2, Person3, Person4, Person5 });
            }
        }

如果硬要获取滚动条对象来设置，则可以用下面这段代码获取gridView的滚动条。

            Type type = gridView1.GetType();

            FieldInfo fi = type.GetField("fViewInfo", BindingFlags.NonPublic | BindingFlags.Instance);

            GridViewInfo info = gridView1.GetViewInfo() as GridViewInfo;

            fi = type.GetField("scrollInfo", BindingFlags.NonPublic | BindingFlags.Instance);

            ScrollInfo scrollInfo = fi.GetValue(gridView1) as ScrollInfo;

 

 

父子表

 　　当绑定的数据源中的子项再存在集合时，XtraGrid会自动启用子表。例如上面的在Person类里多添加一个成员 List<Person> Friends{get;set;}表示那个人的朋友圈子，在任意一个实例中把Person实例添加进去，再启动程序时，就会发现父子表的效果实现了。

　　若要对子表的进行设置，可以给MainView添加MasterRowExpanded事件，例如：

private void gridView1_MasterRowExpanded(object sender, CustomMasterRowEventArgs e)
        {
            //获取子表
            AdvBandedGridView gv = (AdvBandedGridView)gridView1.GetDetailView(e.RowHandle, e.RelationIndex);
            //第一个参数是行号，第二个参数是父子表关联索引
            
            if (gv != null)
            {
                //对子表设置
            }
        }

 

 

Get/Set 单元格的值

 　　通过调用GetRowCellValue获取单元格的值

public override object GetRowCellValue( 
   int rowHandle,  
   GridColumn column 
);

 

rowHandle是行的索引，column列的对象。

　　通过调用SetRowCellValue设置单元格的值

public void SetRowCellValue( 
   int rowHandle,  
   GridColumn column,  
   object _value 
);

rowHandle是行的索引，column列的对象。_value是单元格新的值。

以peopleList为例

int englishS=Convert.ToDouble(0,gridView1.Columns["English"])+60;
SetRowCellValue(0,gridView1.Columns["English"],englishS);

在XtraGrid有另一种方式，就是直接设置数据源的值。对于上面这个例子，直接找到grid里第一行数据对应的Person对象，设置它的English值。

 

数据验证

有两种方法来实现基于单元格的验证：
1、使用RepositoryItem.Validating事件
事件的"sender" 必须转换为BaseEdit类型，使用EditValue来获取当前输入的值并进行校验，如果校验不通过，把e.Cancel设置True。这种方法一般用来对内置控件的单元格进行数据验证。

2、使用 GridView.ValidatingEditor 事件
事件的"sender"必须转换为GridView类型，当前列可以从GridView.FocusedColumn属性获得，值可以从e.Value获取，如果校验不通过，需要把e.Valid设置为False。
这种方法一般用于对整个Grid内的文本框进行数据验证
在设置完事件之后需要写一个GridView.InvalidValueException 的事件委托，如

private void gridView1_InvalidValueException(object sender, DevExpress.XtraGrid.Views.Base.InvalidValueExceptionEventArgs e) {
  e.ThrowException = false;
  e.WindowText = "验证通过";
  e.DisplayError = true;
}

 

表格数据与数据源的数据同步

 　　XtraGrid与DataGridView在数据源方面不同的是，对grid里的数据进行任何改动(增、删、改)之后，原本的数据源也相应的改动。通过下面例子可以得出此结论，在窗体添加删，改两个按钮并绑定下面相应的事件。

        /// <summary>
        /// 更改
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void btEdit_Click(object sender, EventArgs e)
        {
            Person p = (Person)gridView1.GetRow(gridView1.FocusedRowHandle);
        }

        /// <summary>
        /// 删除
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void btDelete_Click(object sender, EventArgs e)
        {if (gridView1.SelectedRowsCount != 0)
                gridView1.DeleteSelectedRows();
            MessageBox.Show(people.Count.ToString());
        }

只要对grid的数据经过改动之后，单击相应的按钮就可以查看数据源的信息。

 

数据导入导出

 　　XtraGrid支持html、Xml、Txt、Xsl导出，对应的导出器是ExportHtmlProvider、ExportXmlProvider、ExportTxtProvider、ExportXslProvider。都在命名空间DevExpress.XtraExport里面。

　　这里封装了一个数据导出的方法，可以导出上述列举的类型，只需要传入相应类型的provider就可以了。

        private void ExportTo(IExportProvider provider)
        {
            Cursor currentCursor = Cursor.Current;
            Cursor.Current = Cursors.WaitCursor;

            this.FindForm().Refresh();
            BaseExportLink link = gridView1.CreateExportLink(provider);
            (link as GridViewExportLink).ExpandAll = false;
            link.ExportTo(true);
            provider.Dispose();

            Cursor.Current = currentCursor;
        }

调用时只需要创建一个相应的provider

IExportProvider provider = new ExportXlsProvider(FullFileName); //这里可以是ExportHtmlProvider、ExportXmlProvider、ExportTxtProvider
ExportTo(provider);

  

　　导入数据只尝试了导入Excel的导入，利用ODBC读取Excel的数据到DataTable中，再把DataTable绑定到XtraGrid中。

　　这里也是封装了一个读取Excel数据的方法

        private DataSet GetDataFromExcelWithAppointSheetName(string Path)
        {
            String strConn = "Provider=Microsoft.Jet.OLEDB.4.0;" +
                     "Data Source=" + Path + ";" +
                     "Extended Properties=Excel 8.0;";
            OleDbConnection conn = new OleDbConnection(strConn);
            conn.Open();
            //返回Excel的架构，包括各个sheet表的名称,类型，创建时间和修改时间等　
            DataTable dtSheetName = conn.GetOleDbSchemaTable(OleDbSchemaGuid.Tables, new object[] { null, null, null, "Table" });
            //包含excel中表名的字符串数组
            string[] strTableNames = new string[dtSheetName.Rows.Count];
            for (int k = 0; k < dtSheetName.Rows.Count; k++)
            {
                strTableNames[k] = dtSheetName.Rows[k]["TABLE_NAME"].ToString();
            }
            OleDbDataAdapter da = null;
            DataSet ds = new DataSet();
            //从指定的表明查询数据,可先把所有表明列出来供用户选择
            string strExcel = "select * from[" + strTableNames[0] + "]";
            da = new OleDbDataAdapter(strExcel, conn);
            da.Fill(ds);

            return ds;
        }

以这样方式调用

 DataSet ds = GetDataFromExcelWithAppointSheetName(FullFileName);

 

设置条带状的列

 　　在选择视图时，选择BandedGridView和AdvBandedGridView都是支持设置条带状的列。在属性编辑器的Bands处可以对条带进行管理，直接拖动列标题可以设置该列属于哪个条带。通过Bands属性可以对各个条带进行管理。

 

编辑器

 　　XtraGrid提供了多种编辑器。这些能够在Grid/CardView/BandedView中使用。在属性编辑器中的In-place Editor Repository可以对编辑器进行管理。在Columns的ColumnEdit中选择该列使用哪个编辑器。

　　也可以通过代码实现：

            RepositoryItemComboBox repositoryItemComboBox_abc=new RepositoryItemComboBox();
            // 
            // 对编辑器进行设置
            // 

            this.gridColumn1.ColumnEdit = repositoryItemComboBox_abc;  //在需要的列里使用定义好的编辑器

  

单元格编辑

 　　这个效果发现只使用与gridView这种视图，同样通过上，下，左，右四个方向的导航键控制光标移动，按回车进入编辑状态，按Esc键不保存更改内容，按回车保存更改内容。

            this.gridView1.OptionsSelection.MultiSelect = true;
            this.gridView1.OptionsSelection.MultiSelectMode = DevExpress.XtraGrid.Views.Grid.GridMultiSelectMode.CellSelect;
            this.gridView1.OptionsSelection.UseIndicatorForSelection = false;

 

列拖动

 　　只要是在列属性里把AllowMove设置了True（它的默认值本身是True）,在程序运行时，用户都可以拖动列标题来改变列的位置。该属性可以通过属性编辑器设置，在Columns-->Columns Options选项卡下的AllowMove。也可以通过代码设置，如：

gridView1.Columns[0].OptionsColumn.AllowMove = true;