Compartir a través de


ListObject.SetDataBinding (Método) (Object)

Enlaza un control ListObject a un origen de datos.

Espacio de nombres:  Microsoft.Office.Tools.Excel
Ensamblado:  Microsoft.Office.Tools.Excel (en Microsoft.Office.Tools.Excel.dll)

Sintaxis

'Declaración
Sub SetDataBinding ( _
    dataSource As Object _
)
void SetDataBinding(
    Object dataSource
)

Parámetros

Excepciones

Excepción Condición
SetDataBindingFailedException

No se pudo enlazar al origen de datos especificado.

ArgumentException

Argumento no válido.

ArgumentNullException

El argumento dataSource es nullreferencia null (Nothing en Visual Basic).

Comentarios

El origen de datos puede ser cualquier objeto que implemente IList, IListSource, IBindingList o IEnumerable, como DataTable o una matriz unidimensional.

Ejemplos

En el ejemplo de código siguiente se muestra el uso del método SetDataBinding para enlazar ListObject a DataTable.DataTable contiene dos columnas, con los nombres y las edades de los empleados, así como cuatro filas que representan las entradas de los empleados.

Se trata de un ejemplo para una personalización en el nivel del documento.

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

Seguridad de .NET Framework

Vea también

Referencia

ListObject Interfaz

SetDataBinding (Sobrecarga)

Microsoft.Office.Tools.Excel (Espacio de nombres)