この記事は翻訳者によって翻訳されたものです。 記事の文章にポインターを重ねると、原文のテキストが表示されます。 |
訳文
原文
|
BindingContext クラス
Control クラスから継承されるすべてのオブジェクトについて、BindingManagerBase オブジェクトのコレクションを管理します。
アセンブリ: System.Windows.Forms (System.Windows.Forms.dll 内)
BindingContext 型で公開されるメンバーは以下のとおりです。
| 名前 | 説明 | |
|---|---|---|
|
IsReadOnly | インフラストラクチャ。 コレクションが読み取り専用かどうかを示す値を取得します。 |
|
Item[Object] | 指定したデータ ソースに関連付けられた BindingManagerBase を取得します。 |
|
Item[Object, String] | 指定したデータ ソースおよびデータ メンバーに関連付けられた BindingManagerBase を取得します。 |
| 名前 | 説明 | |
|---|---|---|
|
Add | 特定のデータ ソースに関連付けられた BindingManagerBase をコレクションに追加します。 |
|
AddCore | インフラストラクチャ。 特定のデータ ソースに関連付けられた BindingManagerBase をコレクションに追加します。 |
|
Clear | すべての BindingManagerBase オブジェクトのコレクションを削除します。 |
|
ClearCore | インフラストラクチャ。 コレクションを空にします。 |
|
Contains(Object) | 指定したデータ ソースに関連付けられた BindingManagerBase が BindingContext に格納されているかどうかを示す値を取得します。 |
|
Contains(Object, String) | 指定したデータ ソースおよびデータ メンバーに関連付けられた BindingManagerBase が BindingContext に格納されているかどうかを示す値を取得します。 |
|
Equals(Object) | 指定した Object が、現在の Object と等しいかどうかを判断します。 (Object から継承されます。) |
|
Finalize | オブジェクトがガベジ コレクションにより収集される前に、そのオブジェクトがリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。) |
|
GetHashCode | 特定の型のハッシュ関数として機能します。 (Object から継承されます。) |
|
GetType | 現在のインスタンスの Type を取得します。 (Object から継承されます。) |
|
MemberwiseClone | 現在の Object の簡易コピーを作成します。 (Object から継承されます。) |
|
OnCollectionChanged | インフラストラクチャ。 CollectionChanged イベントを発生させます。 |
|
Remove | 指定したデータ ソースに関連付けられた BindingManagerBase を削除します。 |
|
RemoveCore | インフラストラクチャ。 指定したデータ ソースに関連付けられた BindingManagerBase を削除します。 |
|
ToString | 現在のオブジェクトを表す文字列を返します。 (Object から継承されます。) |
|
UpdateBinding | Binding を新しい BindingContext に関連付けます。 |
| 名前 | 説明 | |
|---|---|---|
|
AsParallel | クエリの並列化を有効にします。 (ParallelEnumerable によって定義されています。) |
|
AsQueryable | IEnumerable を IQueryable に変換します。 (Queryable によって定義されています。) |
|
Cast<TResult> | IEnumerable の要素を、指定した型に変換します。 (Enumerable によって定義されています。) |
|
OfType<TResult> | 指定された型に基づいて IEnumerable の要素をフィルター処理します。 (Enumerable によって定義されています。) |
| 名前 | 説明 | |
|---|---|---|
|
ICollection.CopyTo | インフラストラクチャ。 コレクションのインデックスを開始位置として、指定した配列にコレクション要素をコピーします。 |
|
ICollection.Count | インフラストラクチャ。 BindingContext によって管理される CurrencyManager オブジェクトの合計数を取得します。 |
|
ICollection.IsSynchronized | インフラストラクチャ。 コレクションの同期がとられているかどうかを示す値を取得します。 |
|
ICollection.SyncRoot | インフラストラクチャ。 同期 (スレッド セーフティ) に使用するオブジェクトを取得します。 |
|
IEnumerable.GetEnumerator | インフラストラクチャ。 コレクションの列挙子を取得します。 |
各 Windows フォームには、そのフォームの BindingManagerBase オブジェクトを管理する BindingContext オブジェクトが少なくとも 1 つ存在します。 BindingManagerBase クラスは抽象クラスであるため、Item プロパティの戻り値の型は、CurrencyManager と PropertyManager のどちらかになります。 データ ソースが、オブジェクトのリストではなく単一のプロパティだけを返すことのできるオブジェクトの場合は、Type は PropertyManager です。 たとえば、データ ソースとして TextBox を指定すると、PropertyManager が返されます。 一方、データ ソースが IList または IBindingList を実装するオブジェクトの場合は、CurrencyManager が返されます。
Windows フォーム上のデータ ソースには、それぞれ、CurrencyManager または PropertyManager が 1 つ存在します。 1 つの Windows フォームに複数のデータ ソースが関連付けられていることも考えられます。その場合は、BindingContext を使用することで、データ ソースに関連付けられた特定の CurrencyManager を取得できます。
メモ
|
|---|
|
Item プロパティを使用すると、まだ存在しない場合は、BindingContext によって新しい BindingManagerBase が作成されます。 この処理によって、リターン オブジェクトが目的のリスト (またはすべてのリスト) を管理できなくなるなどの混乱が生じる場合があります。 無効な BindingManagerBase が返されないようにするには、Contains メソッドを使用して、目的の BindingManagerBase が既に存在するかどうかを確認します。 |
GroupBox、Panel、TabControl などのコンテナー コントロールを使用してデータ連結コントロールを格納する場合は、コンテナー コントロールおよびコンテナー内にあるコントロールだけで構成された BindingContext を作成できます。 これにより、フォームの各部分をフォーム自体の BindingManagerBase オブジェクトで管理できます。 同じデータ ソースに対して複数の BindingManagerBase オブジェクトを作成する場合の詳細については、BindingContext コンストラクターのトピックを参照してください。
TextBox コントロールをフォームに追加し、データセット内のテーブルの列にバインドした場合、バインドされたコントロールは、そのフォームの BindingContext と通信します。 次に、BindingContext が、データの関連付けを追跡する特定の CurrencyManager と通信します。 CurrencyManager の Position プロパティを照会すると、対応する TextBox コントロールのバインディングについて、現在のレコードが報告されます。 次のコード例では、TextBox コントロールが、フォームの BindingContext によって、dataSet1 データセットに格納された Customers テーブルの FirstName 列とバインドされます。
2 つ目の TextBox コントロール (TextBox2) をフォームに追加して、それを同じデータセットに格納された Customers テーブルの LastName 列とバインドできます。 BindingContext によって 1 つ目のバインディング (TextBox1 と Customers.FirstName) が追跡されるため、両方のテキスト ボックスが同じデータセット (DataSet1) にバインドされていても、同じ CurrencyManager が使用されます。
TextBox2 を異なるデータセットにバインドする場合は、BindingContext が CurrencyManager をもう 1 つ作成して管理します。
DataSource プロパティと DisplayMember プロパティの設定方法には一貫性を持たせることが大切です。そうしないと、BindingContext によって、同じデータセットに対して複数の CurrencyManager が作成され、エラーが発生します。 これらのプロパティおよび関連付けられた BindingContext オブジェクトを設定する方法を、次のコード例にいくつか示します。 これらのプロパティは、コード全体を通じて一貫性が保たれている限り、次のいずれの方法を使用しても設定できます。
comboBox1.DataSource = DataSet1; comboBox1.DisplayMember = "Customers.FirstName"; this.BindingContext[dataSet1, "Customers"].Position = 1;
comboBox1.DataSource = DataSet1.Customers; comboBox1.DisplayMember = "FirstName"; this.BindingContext[dataSet1.Customers].Position = 1;
メモ |
|---|
Windows フォーム アプリケーションにおけるバインディングは、ほとんどの場合、BindingSource を通じて行われます。 BindingSource コンポーネントは、CurrencyManager をカプセル化し、CurrencyManager のプログラミング インターフェイスを公開します。 バインディングに BindingSource を使用する場合、"現在性" (つまり、Position) を操作するときには、BindingContext ではなく、BindingSource によって公開されたメンバーを使用する必要があります。 |
4 つの Binding オブジェクトを作成して、5 つのコントロール (1 つの DateTimePicker コントロールと 4 つの TextBox コントロール) を複数のデータ ソースにバインドするコード例を次に示します。 さらに、BindingContext を使用して、各データ ソースの BindingManagerBase を取得します。
protected void BindControls() { /* Create two Binding objects for the first two TextBox controls. The data-bound property for both controls is the Text property. The data source is a DataSet (ds). The data member is a navigation path in the form: "TableName.ColumnName". */ text1.DataBindings.Add(new Binding ("Text", ds, "customers.custName")); text2.DataBindings.Add(new Binding ("Text", ds, "customers.custID")); /* Bind the DateTimePicker control by adding a new Binding. The data member of the DateTimePicker is a navigation path: TableName.RelationName.ColumnName string. */ DateTimePicker1.DataBindings.Add(new Binding("Value", ds, "customers.CustToOrders.OrderDate")); /* Add event delegates for the Parse and Format events to a new Binding object, and add the object to the third TextBox control's BindingsCollection. The delegates must be added before adding the Binding to the collection; otherwise, no formatting occurs until the Current object of the BindingManagerBase for the data source changes. */ Binding b = new Binding ("Text", ds, "customers.custToOrders.OrderAmount"); b.Parse+=new ConvertEventHandler(CurrencyStringToDecimal); b.Format+=new ConvertEventHandler(DecimalToCurrencyString); text3.DataBindings.Add(b); // Get the BindingManagerBase for the Customers table. bmCustomers = this.BindingContext [ds, "Customers"]; /* Get the BindingManagerBase for the Orders table using the RelationName. */ bmOrders = this.BindingContext[ds, "customers.CustToOrders"]; /* Bind the fourth TextBox control's Text property to the third control's Text property. */ text4.DataBindings.Add("Text", text3, "Text"); }
Windows 7, Windows Vista SP1 以降, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core はサポート対象外), Windows Server 2008 R2 (SP1 以降で Server Core をサポート), Windows Server 2003 SP2
.NET Framework では、各プラットフォームのすべてのバージョンはサポートしていません。 サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。
メモ