ListObject.DataMember (Propiedad) (2007 System)
Actualización: noviembre 2007
Obtiene o establece el miembro de datos específico en un origen de datos multimiembro para enlazarse al control ListObject.
Espacio de nombres: Microsoft.Office.Tools.Excel
Ensamblado: Microsoft.Office.Tools.Excel.v9.0 (en Microsoft.Office.Tools.Excel.v9.0.dll)
Sintaxis
Public Property DataMember As String
Dim instance As ListObject
Dim value As String
value = instance.DataMember
instance.DataMember = value
public string DataMember { get; set; }
Valor de propiedad
Tipo: System.String
Un miembro de datos de un origen de datos multimiembro. El valor predeterminado es Empty.
Comentarios
No es necesario si el origen de datos tiene sólo uno miembro.
Utilice la propiedad DataMember para especificar un miembro de un origen de datos multimiembro para enlazarse al control ListObject. Por ejemplo, si dispone de un origen de datos con varias tablas especificadas en la propiedad DataSource, utilice la propiedad DataMember para especificar la tabla que se va a enlazar al control ListObject.
Ejemplos
En el ejemplo de código siguiente se crea DataSet con dos objetos DataTable y se rellena con datos una de las tablas. Después el código establece las propiedades DataSource y DataMember de ListObject para enlazarse a la tabla que contiene los datos.
Se trata de un ejemplo para una personalización en el nivel del 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";
}
Permisos
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.