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
- dataSource
Tipo: System.Object
El objeto que se va a utilizar como origen de datos para el control ListObject.
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
- 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.