Aracılığıyla paylaş


ListObject.SetDataBinding Yöntem (Object, String, array<String )

Bağlar bir ListObject denetimi için belirtilen veri üyesi veri kaynağı ve veri üyesi, yalnızca belirtilen sütunları gösterir.

Ad alanı:  Microsoft.Office.Tools.Excel
Derleme:  Microsoft.Office.Tools.Excel (Microsoft.Office.Tools.Excel.dll içinde)

Sözdizimi

'Bildirim
Sub SetDataBinding ( _
    dataSource As Object, _
    dataMember As String, _
    ParamArray mappedColumns As String() _
)
void SetDataBinding(
    Object dataSource,
    string dataMember,
    params string[] mappedColumns
)

Parametreler

  • mappedColumns
    Tür: array<System.String[]
    Veri üyesini, görüntülemek istediğiniz sütunların adlarını ListObject denetim.Eşlenmeyen bir sütun eklemek için dizideki boş bir dize içerir.

Özel Durumlar

Exception Koşul
SetDataBindingFailedException

Belirtilen veri kaynağına bağlanamadı.

ArgumentException

Bir veya daha fazla bağımsız değişken geçersiz.

ArgumentNullException

The dataSource argument is nullnull başvuru (Visual Basic'te Nothing).

Notlar

dataSource Uygulayan herhangi bir nesne parametresi olabilir IList, IListSource, IBindingList, veya IEnumerable.

dataMember Parametresi bağlanabilir bir koleksiyon döndürür veri kaynağının bir özelliği olması gerekir.Örneğin, bir DataSet kaynak tabloları veri üyeleri olarak vardır.

Örnekler

Aşağıdaki kod örneği oluşturur bir DataSet, DataTableve bir ListObject.Sonra bağlar ListObject için DataSet ve DataTable, ancak yalnızca iki olası tablo sütun içeren ListObject.

Bu örnek için belge düzeyi özelleştirmesinde içindir.

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

.NET Framework Güvenliği

Ayrıca bkz.

Başvuru

ListObject Arabirim

SetDataBinding Fazla Yük

Microsoft.Office.Tools.Excel Ad Alanı