ListObject.SetDataBinding, méthode (Object, String)

Article
01/06/2014

Lie un contrôle ListObject à une donnée membre spécifiée d'une source de données.

Espace de noms : Microsoft.Office.Tools.Excel
Assembly : Microsoft.Office.Tools.Excel (dans Microsoft.Office.Tools.Excel.dll)

Syntaxe

'Déclaration
Sub SetDataBinding ( _
    dataSource As Object, _
    dataMember As String _
)

void SetDataBinding(
    Object dataSource,
    string dataMember
)

Paramètres

dataSource
Type : System.Object
Objet à utiliser comme source de données pour le contrôle ListObject.

dataMember
Type : System.String
DataMember qui spécifie la propriété à laquelle établir la liaison dans l'objet retourné par DataSource.

Exceptions

Exception	Condition
SetDataBindingFailedException	Impossible d'établir une liaison à la source de données spécifiée.
ArgumentException	Un ou plusieurs arguments ne sont pas valides.
ArgumentNullException	L'argument dataSource a la valeur nullune référence null (Nothing en Visual Basic).

Notes

La source de données peut être tout objet qui implémente IList, IListSource, IBindingList ou IEnumerable.

La donnée membre doit être une propriété de la source de données qui retourne une collection pouvant être liée. Par exemple, une source DataSet a des tables comme données membres.

Exemples

L'exemple de code suivant crée un DataSet, un DataTable et un ListObject. Il lie ensuite l'objet de liste à DataSet et à DataTable.

Cet exemple illustre une personnalisation au niveau du document.

    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

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

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

ListObject Interface

SetDataBinding, surcharge

Microsoft.Office.Tools.Excel, espace de noms

Partager via