ListObject.SetDataBinding Metoda

Definice

Přetížení

SetDataBinding(Object, String, String[])

Vytvoří vazby ListObject ovládacího prvku na zadaného datového člena zdroje dat a zobrazí pouze zadané sloupce daného datového člena.

SetDataBinding(Object, String)

Vytvoří vazby ListObject ovládacího prvku na zadaného datového člena zdroje dat.

SetDataBinding(Object)

Vytvoří vazby ListObject ovládacího prvku na zdroj dat.

SetDataBinding(Object, String, String[])

Vytvoří vazby ListObject ovládacího prvku na zadaného datového člena zdroje dat a zobrazí pouze zadané sloupce daného datového člena.

public void SetDataBinding (object dataSource, string dataMember, params string[] mappedColumns);

Parametry

dataSource
Object

Objekt, který má být použit jako zdroj dat pro ListObject ovládací prvek.

dataMember
String

DataMemberUrčuje vlastnost, která má být vytvořena, v rámci objektu vráceného DataSource .

mappedColumns
String[]

Názvy sloupců v datovém členu, které chcete zobrazit v ListObject ovládacím prvku. Chcete-li přidat Nemapovaný sloupec, zahrňte do pole prázdný řetězec.

Výjimky

Nelze vytvořit vazby k zadanému zdroji dat.

Jeden nebo více argumentů je neplatných.

dataSourceArgument je null .

Příklady

Následující příklad kódu vytvoří, a DataSet DataTable , a ListObject . Poté váže na ListObject DataSet a DataTable , ale obsahuje pouze jeden ze dvou možných sloupců tabulky v ListObject .

Tento příklad je pro přizpůsobení na úrovni dokumentu.

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);
}
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

Poznámky

dataSourceParametr může být libovolný objekt, který implementuje IList , IListSource , IBindingList nebo IEnumerable .

dataMemberParametr musí být vlastnost zdroje dat, která vrací kolekci s možností vazby. Například DataSet zdroj má tabulky jako datové členy.

Platí pro

SetDataBinding(Object, String)

Vytvoří vazby ListObject ovládacího prvku na zadaného datového člena zdroje dat.

public void SetDataBinding (object dataSource, string dataMember);

Parametry

dataSource
Object

Objekt, který má být použit jako zdroj dat pro ListObject ovládací prvek.

dataMember
String

DataMemberUrčuje vlastnost, která má být vytvořena, v rámci objektu vráceného DataSource .

Výjimky

Nelze vytvořit vazby k zadanému zdroji dat.

Jeden nebo více argumentů je neplatných.

dataSourceArgument je null .

Příklady

Následující příklad kódu vytvoří, a DataSet DataTable , a ListObject . Potom sváže objekt seznamu s DataSet a DataTable .

Tento příklad je pro přizpůsobení na úrovni dokumentu.

private void ListObject_SetDataBinding2()
{
    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.
    list1.SetDataBinding(ds, "Customers");
}
Private Sub ListObject_SetDataBinding2()
    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.
    List1.SetDataBinding(ds, "Customers")

End Sub

Poznámky

Zdroj dat může být libovolný objekt, který implementuje IList , IListSource , IBindingList nebo IEnumerable .

Datový člen musí být vlastnost zdroje dat, která vrací kolekci s možností vazby. Například DataSet zdroj má tabulky jako datové členy.

Platí pro

SetDataBinding(Object)

Vytvoří vazby ListObject ovládacího prvku na zdroj dat.

public void SetDataBinding (object dataSource);

Parametry

dataSource
Object

Objekt, který má být použit jako zdroj dat pro ListObject ovládací prvek.

Výjimky

Nelze vytvořit vazby k zadanému zdroji dat.

Argument je neplatný.

dataSourceArgument je null .

Příklady

Následující příklad kódu ukazuje, jak použít SetDataBinding metodu pro svázání s ListObject DataTable . DataTableObsahuje dva sloupce, které obsahují jména a stáří zaměstnanců, a čtyři řádky, které reprezentují záznamy zaměstnanců.

Tento příklad je pro přizpůsobení na úrovni dokumentu.

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);
}
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

Poznámky

Zdroj dat může být libovolný objekt, který implementuje IList , IListSource , IBindingList nebo IEnumerable , jako například nebo jednorozměrné DataTable pole.

Platí pro