Método ListObject.SetDataBinding (Object, String)

Artigo
05/21/2013

Associa um controle de ListObject a um membro especificado de dados de 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, _
    dataMember As String _
)

void SetDataBinding(
    Object dataSource,
    string dataMember
)

Parâmetros

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

dataMember
Tipo: System.String
DataMember que especifica a propriedade para associar dentro do objeto retornado por DataSource.

Exceções

Exceção	Condição
SetDataBindingFailedException	Não foi possível associar à fonte de dados especificada.
ArgumentException	Um ou mais dos argumentos são inválidos.
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.

O membro de dados deve ser uma propriedade de fonte de dados que retorna uma coleção ligáveis.Por exemplo, uma fonte de DataSet tem tabelas como membros de dados.

Exemplos

O exemplo de código a seguir cria DataSet, DataTable, e ListObject.Associar o objeto da lista DataSet e a DataTable.

Este exemplo é para uma personalização da nível.

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

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áveis.

Consulte também

Referência

ListObject Interface

Sobrecargas SetDataBinding

Namespace Microsoft.Office.Tools.Excel

Compartilhar via