ListObject.SetDataBinding-Methode (Object)
Bindet ein ListObject-Steuerelement an eine Datenquelle.
Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)
Syntax
'Declaration
Sub SetDataBinding ( _
dataSource As Object _
)
void SetDataBinding(
Object dataSource
)
Parameter
- dataSource
Typ: System.Object
Das Objekt, das als Datenquelle für das ListObject-Steuerelement verwendet werden soll.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| SetDataBindingFailedException | Konnte keine Bindung zur angegeben Datenquelle herstellen. |
| ArgumentException | Das Argument ist ungültig. |
| ArgumentNullException | Das dataSource-Argument ist nullNULL-Verweis (Nothing in Visual Basic). |
Hinweise
Die Datenquelle kann jedes Objekt sein, das IList, IListSource, IBindingList oder IEnumerable implementiert, z. B. eine DataTable oder ein eindimensionales Array.
Beispiele
Das folgende Codebeispiel veranschaulicht die Verwendung der SetDataBinding-Methode, um ein .ListObject an eine DataTable zu binden. Die DataTable enthält zwei Spalten mit Name und Alter der Mitarbeiter sowie vier Spalten mit Mitarbeitereinträgen.
Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.
Private Sub ListObject_SetDataBinding()
Dim Ages As Integer() = {32, 44, 28, 61}
Dim Names As String() = {"Reggie", "Sally", _
"Henry", "Christine"}
' Create a data table with two columns.
Dim table = New DataTable()
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
Dim List1 As Microsoft.Office.Tools.Excel.ListObject = _
Me.Controls.AddListObject(Me.Range("A1", "B4"), "List1")
' Bind the list object to the table.
List1.SetDataBinding(table)
End Sub
private void ListObject_SetDataBinding()
{
int[] Ages = { 32, 44, 28, 61 };
string[] Names = { "Reggie", "Sally", "Henry", "Christine" };
// Create a data table with two columns.
System.Data.DataTable table = new DataTable();
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.
list1.SetDataBinding(table);
}
.NET Framework-Sicherheit
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.