Metodo ListObject.SetDataBinding (Object)

Articolo
01/06/2014

Associa un controllo ListObject a un'origine dati.

Spazio dei nomi: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Sintassi

'Dichiarazione
Sub SetDataBinding ( _
    dataSource As Object _
)

void SetDataBinding(
    Object dataSource
)

Parametri

dataSource
Tipo: System.Object
Oggetto da utilizzare come origine dati per il controllo ListObject.

Eccezioni

Eccezione	Condizione
SetDataBindingFailedException	Impossibile eseguire l'associazione all'origine dati specificata.
ArgumentException	L'argomento non è valido.
ArgumentNullException	L'argomento dataSource è nullriferimento null (Nothing in Visual Basic).

Note

L'origine dati può essere qualsiasi oggetto che implementa IList, IListSource, IBindingList o IEnumerable, quali una matrice unidimensionale o un oggetto DataTable.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato l'utilizzo del metodo SetDataBinding per associare un controllo ListObject a un oggetto DataTable. L'oggetto DataTable include due colonne, che contengono i nomi e le età dei dipendenti, nonché quattro righe che rappresentano le voci relative ai dipendenti.

Questo esempio è valido per una personalizzazione a livello di 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);
}

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

ListObject Interfaccia

Overload SetDataBinding

Spazio dei nomi Microsoft.Office.Tools.Excel

Condividi tramite