Proprietà ListObject.DataSource (System 2007)

Articolo
09/12/2008

Aggiornamento: novembre 2007

Ottiene o imposta l'origine che contiene un elenco di valori utilizzati per popolare gli elementi all'interno del controllo.

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

Sintassi

Public Property DataSource As Object

Dim instance As ListObject
Dim value As Object

value = instance.DataSource

instance.DataSource = value

public Object DataSource { get; set; }

Valore proprietà

Tipo: System.Object

Origine che contiene un elenco di valori utilizzati per popolare gli elementi all'interno del controllo. Il valore predefinito è nullriferimento null (Nothing in Visual Basic).

Note

In fase di esecuzione utilizzare il metodo SetDataBinding per impostare le proprietà DataSource e DataMember.

Di seguito sono riportate le origini dati valide:

Oggetto DataTable.
Oggetto DataView.
Oggetto DataSet.
Oggetto DataViewManager.
Qualsiasi componente che implementa l'interfaccia IListSource.
Qualsiasi componente che implementa l'interfaccia IList.

Per ulteriori informazioni sulle origini dati, vedere i cenni preliminari sulla classe Binding.

Se il riferimento alla proprietà DataSource contiene più di una tabella o di una proprietà, è necessario impostare la proprietà DataMember su una stringa in cui è specificata la tabella cui deve essere associato. Se ad esempio la proprietà DataSource è impostata su un oggetto DataSet o DataViewManager che contiene tre tabelle denominate Clienti, Ordini e DettagliOrdine, è necessario specificare la tabella da utilizzare per l'associazione.

Se la proprietà DataSource viene impostata su un oggetto che non implementa l'interfaccia IList o un oggetto IListSource, verrà generata un'eccezione.

Esempi

Nell'esempio di codice riportato di seguito viene creato un oggetto DataSet con due oggetti DataTable e una delle tabelle viene compilata con dati. Vengono quindi impostate le proprietà DataSource e DataMember del controllo ListObject da associare alla tabella che contiene i dati.

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

Private Sub ListObject_DataSourceAndMember()
    ' Create a DataSet and two DataTables.
    Dim ordersDataSet As New DataSet("ordersDataSet")
    Dim tableCustomers As New DataTable("Customers")
    Dim tableProducts As New DataTable("Products")
    ordersDataSet.Tables.Add(tableCustomers)
    ordersDataSet.Tables.Add(tableProducts)

    ' Add a data to the Customers DataTable.
    tableCustomers.Columns.Add(New DataColumn("LastName"))
    tableCustomers.Columns.Add(New DataColumn("FirstName"))
    Dim dr As DataRow = tableCustomers.NewRow()
    dr("LastName") = "Chan"
    dr("FirstName") = "Gareth"
    tableCustomers.Rows.Add(dr)

    ' Create a list object.
    Dim List1 As Microsoft.Office.Tools.Excel.ListObject = _
        Me.Controls.AddListObject(Me.Range( _
        "A1"), "Customers")

    ' Bind the list object to the Customers table.
    List1.AutoSetDataBoundColumnHeaders = True
    List1.DataSource = ordersDataSet
    List1.DataMember = "Customers"

End Sub

private void ListObject_DataSourceAndMember()
{
    // Create a DataSet and two DataTables.
    DataSet ordersDataSet = new DataSet("ordersDataSet");
    DataTable tableCustomers = new DataTable("Customers");
    DataTable tableProducts = new DataTable("Products");
    ordersDataSet.Tables.Add(tableCustomers);
    ordersDataSet.Tables.Add(tableProducts);

    // Add a data to the Customers DataTable.
    tableCustomers.Columns.Add(new DataColumn("LastName"));
    tableCustomers.Columns.Add(new DataColumn("FirstName"));
    DataRow dr = tableCustomers.NewRow();
    dr["LastName"] = "Chan";
    dr["FirstName"] = "Gareth";
    tableCustomers.Rows.Add(dr);

    // Create a list object.
    Microsoft.Office.Tools.Excel.ListObject list1 = 
        this.Controls.AddListObject(
        this.Range["A1", missing], "Customers");

    // Bind the list object to the Customers table.
    list1.AutoSetDataBoundColumnHeaders = true;
    list1.DataSource = ordersDataSet;
    list1.DataMember = "Customers";
}

Autorizzazioni

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 Classe

Membri ListObject

Spazio dei nomi Microsoft.Office.Tools.Excel

Condividi tramite