ListObject.SetDataBinding メソッド (Object, String)
ListObject コントロールをデータ ソースの指定のデータ メンバーにバインドします。
名前空間: Microsoft.Office.Tools.Excel
アセンブリ: Microsoft.Office.Tools.Excel (Microsoft.Office.Tools.Excel.dll 内)
構文
'宣言
Sub SetDataBinding ( _
dataSource As Object, _
dataMember As String _
)
void SetDataBinding(
Object dataSource,
string dataMember
)
パラメーター
- dataSource
型 : System.Object
ListObject コントロールのデータ ソースとして使用するオブジェクト。
- dataMember
型 : System.String
DataSource で返されるオブジェクト内の、バインド先のプロパティを指定する DataMember。
例外
| 例外 | 条件 |
|---|---|
| SetDataBindingFailedException | 指定されたデータ ソースにバインドできませんでした。 |
| ArgumentException | 1 つ以上の引数が無効です。 |
| ArgumentNullException | dataSource 引数が nullnull 参照 (Visual Basic では Nothing) です。 |
解説
データ ソースとしては、IList、IListSource、IBindingList、または IEnumerable を実装したオブジェクトを使用できます。
データ メンバーは、バインドできるコレクションを返す、データ ソースのプロパティである必要があります。たとえば、DataSet ソースのデータ メンバーとしてテーブルがあります。
例
次のコード例は、DataSet、DataTable、および ListObject を作成します。次に、リスト オブジェクトを DataSet および DataTable にバインドします。
この例は、ドキュメント レベルのカスタマイズ用に作成されています。
Private Sub ListObject_SetDataBinding2()
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.
List1.SetDataBinding(ds, "Customers")
End Sub
private void ListObject_SetDataBinding2()
{
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.
list1.SetDataBinding(ds, "Customers");
}
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。