Método ListObject.SetDataBinding (Object)

Artigo
01/09/2014

Associa um controle de ListObject a uma fonte de dados.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)

Sintaxe

'Declaração
Sub SetDataBinding ( _
    dataSource As Object _
)

void SetDataBinding(
    Object dataSource
)

Parâmetros

dataSource
Tipo: System.Object
O objeto para usar como uma fonte de dados para o controle de ListObject .

Exceções

Exceção	Condição
SetDataBindingFailedException	Não foi possível associar à fonte de dados especificada.
ArgumentException	O argumento não é válido.
ArgumentNullException	O argumento de dataSource é nulluma referência nula (Nothing no Visual Basic).

Comentários

A fonte de dados pode ser qualquer objeto que implementa IList, IListSource, IBindingList, ou IEnumerable, como DataTable ou uma matriz unidimensional.

Exemplos

O exemplo de código demonstra como usar o método de SetDataBinding para associar ListObject a DataTable. DataTable contém duas colunas, que contêm os nomes e idades de funcionários, e quatro linhas que representam entradas de funcionários.

Este exemplo é para uma personalização de um documento nível.

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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

ListObject Interface

Sobrecargas SetDataBinding

Namespace Microsoft.Office.Tools.Excel

Compartilhar via