ListObject.SetDataBinding 方法 (Object, String, array<String )
将 ListObject 控件绑定到数据源的指定数据成员,并且仅显示该数据成员的指定列。
命名空间: Microsoft.Office.Tools.Excel
程序集: Microsoft.Office.Tools.Excel(在 Microsoft.Office.Tools.Excel.dll 中)
声明
Sub SetDataBinding ( _
dataSource As Object, _
dataMember As String, _
ParamArray mappedColumns As String() _
)
void SetDataBinding(
Object dataSource,
string dataMember,
params string[] mappedColumns
)
- dataSource
类型:System.Object
要用作 ListObject 控件的数据源的对象。
- dataMember
类型:System.String
由 DataSource 返回的对象中用来指定要绑定到的属性的 DataMember。
- mappedColumns
类型:array<System.String[]
数据成员中要显示在 ListObject 控件中的列名。若要添加未映射的列,请在该数组中包括一个空字符串。
异常 | 条件 |
---|---|
SetDataBindingFailedException | 未能绑定到指定的数据源。 |
ArgumentException | 一个或多个参数无效。 |
ArgumentNullException | dataSource 参数为 nullnull 引用(在 Visual Basic 中为 Nothing)。 |
dataSource 参数可以是实现 IList、IListSource、IBindingList 或 IEnumerable 的任何对象。
dataMember 参数必须是返回可绑定集合的数据源的属性。 例如,DataSet 源将表用作数据成员。
下面的代码示例创建一个 DataSet、一个 DataTable 和一个 ListObject。 然后将 ListObject 绑定到 DataSet 和 DataTable,但是仅包括 ListObject 中两个可能的表列之一。
此示例针对的是文档级自定义项。
Private Sub ListObject_SetDataBinding3()
Dim Ages As Integer() = {32, 44, 28, 61}
Dim Names As String() = {"Reggie", "Sally", _
"Henry", "Christine"}
' Create a data table with two columns.
Dim ds As New DataSet()
Dim table As DataTable = ds.Tables.Add("Customers")
Dim column1 As New DataColumn("Names", GetType(String))
Dim column2 As New DataColumn("Ages", GetType(Integer))
table.Columns.Add(column1)
table.Columns.Add(column2)
' Add the four rows of data to the table.
Dim row As DataRow
Dim i As Integer
For i = 0 To 3
row = table.NewRow()
row("Names") = Names(i)
row("Ages") = Ages(i)
table.Rows.Add(row)
Next i
' Create the list object.
Dim List1 As Microsoft.Office.Tools.Excel.ListObject = _
Me.Controls.AddListObject(Me.Range("A1", "B4"), "List1")
' Bind the list object to the table.
Dim mappedColumn As String() = {"Names"}
List1.SetDataBinding(ds, "Customers", mappedColumn)
End Sub
private void ListObject_SetDataBinding3()
{
int[] Ages = { 32, 44, 28, 61 };
string[] Names = { "Reggie", "Sally", "Henry", "Christine" };
// Create a data table with two columns.
DataSet ds = new DataSet();
DataTable table = ds.Tables.Add("Customers");
DataColumn column1 = new DataColumn("Names", typeof(string));
DataColumn column2 = new DataColumn("Ages", typeof(int));
table.Columns.Add(column1);
table.Columns.Add(column2);
// Add the four rows of data to the table.
DataRow row;
for (int i = 0; i < 4; i++)
{
row = table.NewRow();
row["Names"] = Names[i];
row["Ages"] = Ages[i];
table.Rows.Add(row);
}
Microsoft.Office.Tools.Excel.ListObject list1 =
this.Controls.AddListObject(this.Range["A1", "B4"], "list1");
// Bind the list object to the table.
string[] mappedColumn = { "Names" };
list1.SetDataBinding(ds, "Customers", mappedColumn);
}
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。