Metodo ListObject.SetDataBinding (Object, String)

Articolo
01/06/2014

Associa un controllo ListObject a un membro dati specificato di 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, _
    dataMember As String _
)

void SetDataBinding(
    Object dataSource,
    string dataMember
)

Parametri

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

dataMember
Tipo: System.String
Oggetto DataMember che specifica la proprietà da associare all'interno dell'oggetto restituito dalla proprietà DataSource.

Eccezioni

Eccezione	Condizione
SetDataBindingFailedException	Impossibile eseguire l'associazione all'origine dati specificata.
ArgumentException	Uno o più argomenti non sono validi.
ArgumentNullException	L'argomento dataSource è nullriferimento null (Nothing in Visual Basic).

Note

L'origine dati può essere un qualsiasi oggetto che implementa IList, IListSource, IBindingList o IEnumerable.

Il membro dati deve essere una proprietà dell'origine dati che restituisce una raccolta associabile. I membri dati di un'origine DataSet sono ad esempio rappresentati da tabelle.

Esempi

Nell'esempio di codice riportato di seguito vengono creati un oggetto DataSet, un oggetto DataTable e un controllo ListObject. Viene quindi associato l'oggetto List agli oggetti DataSet e DataTable.

Questo esempio è valido per una personalizzazione a livello di documento.

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

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

Share via