Método ListObject.SetDataBinding (Object, String, array<String )
Vincula um ListObject o controle a um membro de dados especificado de uma fonte de dados e mostra apenas colunas especificado do que membro de dados.
Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)
Sintaxe
'Declaração
Sub SetDataBinding ( _
dataSource As Object, _
dataMember As String, _
ParamArray mappedColumns As String() _
)
void SetDataBinding(
Object dataSource,
string dataMember,
params string[] mappedColumns
)
Parâmetros
- dataSource
Tipo: System.Object
O objeto a ser usado como uma fonte de dados para o ListObject de controle.
- dataMember
Tipo: System.String
O DataMember que especifica a propriedade para vincular a dentro do objeto retornado pela DataSource.
- mappedColumns
Tipo: array<System.String[]
Nomes das colunas no membro de dados que você deseja exibir o ListObject de controle.Para adicionar uma coluna não mapeada, inclua uma seqüência vazia no array.
Exceções
Exceção | Condição |
---|---|
SetDataBindingFailedException | Não pôde ligar-se à fonte de dados especificado. |
ArgumentException | Um ou mais argumentos são inválidos. |
ArgumentNullException | O dataSource argumento é nulluma referência nula (Nothing no Visual Basic). |
Comentários
O dataSource parâmetro pode ser qualquer objeto que implementa IList, IListSource, IBindingList, ou IEnumerable.
O dataMember parâmetro deve ser uma propriedade da fonte de dados que retorna uma coleção ligáveis. Por exemplo, um DataSet fonte possui tabelas como membros de dados.
Exemplos
O exemplo de código a seguir cria um DataSet, um DataTablee um ListObject. Ele então liga o ListObject para o DataSet e o DataTable, mas só inclui uma das duas colunas de tabela possíveis na ListObject.
Este exemplo é para uma personalização em nível de documento.
Private Sub ListObject_SetDataBinding3()
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.
Dim mappedColumn As String() = {"Names"}
List1.SetDataBinding(ds, "Customers", mappedColumn)
End Sub
private void ListObject_SetDataBinding3()
{
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.
string[] mappedColumn = { "Names" };
list1.SetDataBinding(ds, "Customers", mappedColumn);
}
Segurança do .NET Framework
- Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.