BindingContext クラスとは？ わかりやすく解説

.NET Framework クラス ライブラリ リファレンス
索引トップ 用語の索引 ランキング
日本マイクロソフト株式会社日本マイクロソフト株式会社

BindingContext クラス

Control クラスから継承されるすべてのオブジェクトについて、BindingManagerBase オブジェクトのコレクションを管理します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文構文

Visual Basic (宣言)
Public Class BindingContext
    Implements ICollection, IEnumerable
Visual Basic (使用法)
Dim instance As BindingContext
C#
public class BindingContext : ICollection,
 IEnumerable
C++
public ref class BindingContext : ICollection,
 IEnumerable
J#
public class BindingContext implements ICollection,
 IEnumerable
JScript
public class BindingContext implements ICollection,
 IEnumerable
解説解説

各 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 列とバインドされます。

Visual Basic
TextBox1.DataBindings.Add("Text", dataSet1, "Customers.FirstName")
C#
textBox1.DataBindings.Add("Text", dataSet1, "Customers.FirstName");
C++
textBox1->DataBindings->Add("Text", dataSet1, "Customers.FirstName");

2 つ目の TextBox コントロール (TextBox2) をフォームに追加して、それを同じデータセットに格納された Customers テーブルの LastName 列とバインドできます。BindingContext によって 1 つ目のバインディング (TextBox1 と Customers.FirstName) が追跡されるため、両方のテキスト ボックスが同じデータセット (DataSet1) にバインドされていても、同じ CurrencyManager が使用されます。

Visual Basic
TextBox2.DataBindings.Add("Text", dataSet1, "Customers.LastName")
C#
textBox2.DataBindings.Add("Text", dataSet1, "Customers.LastName");
C++
textBox2->DataBindings->Add("Text", dataSet1, "Customers.LastName");

TextBox2 を異なるデータセットにバインドする場合は、BindingContext が CurrencyManager をもう 1 つ作成して管理します。

DataSource プロパティと DisplayMember プロパティの設定方法には一貫性を持たせることが大切です。そうしないと、BindingContext によって、同じデータセットに対して複数の CurrencyManager が作成され、エラーが発生します。これらのプロパティおよび関連付けられた BindingContext オブジェクトを設定する方法を、次のコード例にいくつか示します。これらのプロパティは、コード全体を通じて一貫性が保たれている限り、次のいずれの方法を使用しても設定できます。

Visual Basic
ComboBox1.DataSource = DataSet1
ComboBox1.DisplayMember = "Customers.FirstName"
Me.BindingContext(dataSet1, "Customers").Position
 = 1
C#
comboBox1.DataSource = DataSet1;
comboBox1.DisplayMember = "Customers.FirstName";
this.BindingContext[dataSet1, "Customers"].Position
 = 1;
C++
comboBox1->DataSource = dataSet1;
comboBox1->DisplayMember = "Customers.FirstName";
this->BindingContext->get_Item(dataSet1, "Customers")->Position
 = 1;
Visual Basic
ComboBox1.DataSource = DataSet1.Customers
ComboBox1.DisplayMember = "FirstName"
Me.BindingContext(dataSet1.Customers).Position = 1
C#
comboBox1.DataSource = DataSet1.Customers;
comboBox1.DisplayMember = "FirstName";
this.BindingContext[dataSet1.Customers].Position = 1;
C++
comboBox1->DataSource = dataSet1->Customers;
comboBox1->DisplayMember = "FirstName";
this->BindingContext->get_Item(dataSet1->Customers)->Position
 = 1;
メモメモ

Windows フォーム アプリケーションにおけるバインディングは、ほとんどの場合、BindingSource を通じて行われます。BindingSource コンポーネントは、CurrencyManager をカプセル化し、CurrencyManager のプログラミング インターフェイスを公開します。バインディングに BindingSource を使用する場合、"現在性" (つまり、Position) を操作するときには、BindingContext ではなく、BindingSource によって公開されたメンバを使用する必要があります。

使用例使用例

4 つの Binding オブジェクトを作成して、5 つのコントロール (1 つの DateTimePicker コントロールと 4 つの TextBox コントロール) を複数のデータ ソースにバインドするコード例を次に示します。さらに、BindingContext を使用して、各データ ソースの BindingManagerBase を取得します。

Visual Basic
Protected Sub 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 the string 
   '   "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 
   '   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.
   Dim b As Binding = New
 Binding _
      ("Text", ds, "customers.custToOrders.OrderAmount")
   AddHandler b.Parse,  New ConvertEventHandler(AddressOf
 CurrencyStringToDecimal)      
   AddHandler b.Format, New ConvertEventHandler(AddressOf
 DecimalToCurrencyString)
   text3.DataBindings.Add(b)

   ' Get the BindingManagerBase for the Customers table.
   bmCustomers = Me.BindingContext(ds, "Customers")

   ' Get the BindingManagerBase for the Orders table using the 
   '   RelationName.
   bmOrders = Me.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")

End Sub
C#
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");
}
C++
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( gcnew Binding( "Text",ds,"customers.custName"
 ) );
   text2->DataBindings->Add( gcnew 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( gcnew 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 = gcnew Binding( "Text",ds,"customers.custToOrders.OrderAmount"
 );
   b->Parse += gcnew ConvertEventHandler( this, &Form1::CurrencyStringToDecimal
 );
   b->Format += gcnew ConvertEventHandler( this, &Form1::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" );
}
J#
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.get_DataBindings().Add(new Binding("Text",
 ds, 
        "customers.custName"));
    text2.get_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.get_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.add_Parse(new ConvertEventHandler(CurrencyStringToDecimal));
    b.add_Format(new ConvertEventHandler(DecimalToCurrencyString));
    text3.get_DataBindings().Add(b);

    // Get the BindingManagerBase for the Customers table. 
    bmCustomers = this.get_BindingContext().get_Item(ds, "Customers");

    /* Get the BindingManagerBase for the Orders table using
 the 
       RelationName. 
     */
    bmOrders = this.get_BindingContext().get_Item(ds, 
        "customers.CustToOrders");

    /* Bind the fourth TextBox control's Text property to the
       third control's Text property. 
     */
    text4.get_DataBindings().Add("Text", text3, "Text");
} //BindControls
JScript
  protected function 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 the string 
        "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 
        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. */
     var b : Binding = new Binding
        ("Text", ds, "customers.custToOrders.OrderAmount");
     b.add_Parse(CurrencyStringToDecimal);
     b.add_Format(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"];
  }

  private function DecimalToCurrencyString(sender,
 cevent : ConvertEventArgs)
  {
     /* This method is the Format event handler. Whenever the 
        control displays a new value, the value is converted from
 
        its native Decimal type to a string. The ToString method
 
        then formats the value as a Currency, by using the 
        formatting character "c". */

     // We can only convert to string type. 
     if(cevent.DesiredType != String.GetType()) return;

     cevent.Value = (Decimal(cevent.Value)).ToString("c");
  }

  private function CurrencyStringToDecimal(sender,
 cevent : ConvertEventArgs)
  {   
     /* This method is the Parse event-handler. The Parse event 
        occurs whenever the displayed value changes. The static
 
        ToDecimal method of the Convert class converts the 
        value back to its native Decimal type. */

     // Can only convert to Decimal type.
     if(cevent.DesiredType != Decimal.GetType()) return;

     cevent.Value = Decimal.Parse(cevent.Value.ToString(),
         NumberStyles.Currency, null);

     /* To see that no precision is lost, print the unformatted 
        value. For example, changing a value to "10.0001" 
        causes the control to display "10.00", but the 
        unformatted value remains "10.0001". */
     Console.WriteLine(cevent.Value);
  }

  protected function button1_Click(sender,
 e : System.EventArgs)
  {
     // Go to the previous item in the Customer list.
     bmCustomers.Position -= 1;
  }

  protected function button2_Click(sender,
 e : System.EventArgs)
  {
     // Go to the next item in the Customer list.
     bmCustomers.Position += 1;
  }
   
  protected function button3_Click(sender,
 e : System.EventArgs)
  {
     // Go to the previous item in the Orders list.
     bmOrders.Position-=1;
  }

  protected function button4_Click(sender,
 e : System.EventArgs)
  {
     // Go to the next item in the Orders list.
     bmOrders.Position+=1;
  }

  // Create a DataSet with two tables and populate it.
  private function MakeDataSet()
  {
     // Create a DataSet.
     ds = new DataSet("myDataSet");
     
     // Create two DataTables.
     var tCust : DataTable = new DataTable("Customers");
     var tOrders : DataTable= new DataTable("Orders");

     // Create two columns, and add them to the first table.
     var cCustID : DataColumn = new DataColumn("CustID",
 Int32);
     var cCustName : DataColumn = new DataColumn("CustName");
     tCust.Columns.Add(cCustID);
     tCust.Columns.Add(cCustName);

     // Create three columns, and add them to the second table.
     var cID : DataColumn  = 
        new DataColumn("CustID", Int32);
     var cOrderDate : DataColumn  = 
        new DataColumn("orderDate", DateTime);
     var cOrderAmount : DataColumn = 
        new DataColumn("OrderAmount", Decimal);
     tOrders.Columns.Add(cOrderAmount);
     tOrders.Columns.Add(cID);
     tOrders.Columns.Add(cOrderDate);

     // Add the tables to the DataSet.
     ds.Tables.Add(tCust);
     ds.Tables.Add(tOrders);

     // Create a DataRelation, and add it to the DataSet.
     var dr : DataRelation = new DataRelation
     ("custToOrders", cCustID , cID);
     ds.Relations.Add(dr);
  
     /* Populate the tables. For each customer and order, 
        create need two DataRow variables. */
     var newRow1 : DataRow;
     var newRow2 : DataRow;

     // Create three customers in the Customers Table.
     for(var i : int = 1;
 i < 4; i++)
     {
        newRow1 = tCust.NewRow();
        newRow1["custID"] = i;
        // Add the row to the Customers table.
        tCust.Rows.Add(newRow1);
     }
     // Give each customer a distinct name.
     tCust.Rows[0]["custName"] = "Alpha";
     tCust.Rows[1]["custName"] = "Beta";
     tCust.Rows[2]["custName"] = "Omega";
     
     // For each customer, create five rows in the Orders table.
     for(var j : int = 1;
 j < 4; j++)
     {
        for(var k : int
 = 1; k < 6; k++)
        {
           newRow2 = tOrders.NewRow();
           newRow2["CustID"]= j;
           newRow2["orderDate"]= new DateTime(2001,
 j, k * 2);
           newRow2["OrderAmount"] = j * 10 + k  * .1;
           // Add the row to the Orders table.
           tOrders.Rows.Add(newRow2);
        }
     }
  }
}
継承階層継承階層
System.Object
  System.Windows.Forms.BindingContext
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0
参照参照
関連項目
BindingContext メンバ
System.Windows.Forms 名前空間
BindingManagerBase
Binding クラス
BindingsCollection

急上昇のことば

手負い
揶揄
辟易
鎌田徹郎
ホームタウン
このページでは「.NET Framework クラス ライブラリ リファレンス」からBindingContext クラスを検索した結果を表示しています。
Weblioに収録されているすべての辞書からBindingContext クラスを検索する場合は、下記のリンクをクリックしてください。
 全ての辞書からBindingContext クラス を検索
英和和英テキスト翻訳>> Weblio翻訳
英語⇒日本語日本語⇒英語
  

辞書ショートカット

カテゴリ一覧

全て

＋ ビジネス

＋ 業界用語

＋ コンピュータ

＋ 電車

＋ 自動車・バイク

＋ 船

＋ 工学

＋ 建築・不動産

＋ 学問

＋ 文化

＋ 生活

＋ ヘルスケア

＋ 趣味

＋ スポーツ

＋ 生物

＋ 食品

＋ 人名

＋ 方言

＋ 辞書・百科事典

すべての辞書の索引

あいうえお
かきくけこ
さしすせそ
たちつてと
なにぬねの
はひふへほ
まみむめも
やゆよ
らりるれろ
わをん
がぎぐげご
ざじずぜぞ
だぢづでど
ばびぶべぼ
ぱぴぷぺぽ
ＡＢＣＤＥ
ＦＧＨＩＪ
ＫＬＭＮＯ
ＰＱＲＳＴ
ＵＶＷＸＹ
Ｚ
１２３４５
６７８９０
記号

Weblioのサービス

「BindingContext クラス」の関連用語

1
ContainerControl.BindingContext プロパティ
.NET Framework クラス ライブラリ リファレンス
100% |||||

2
SplitContainer.BindingContext プロパティ
.NET Framework クラス ライブラリ リファレンス
100% |||||

3
ToolStrip.BindingContext プロパティ
.NET Framework クラス ライブラリ リファレンス
92% |||||

4
BindingContext.Item プロパティ
.NET Framework クラス ライブラリ リファレンス
90% |||||

5
BindingContext イベント
.NET Framework クラス ライブラリ リファレンス
78% |||||

6
BindingContext コンストラクタ
.NET Framework クラス ライブラリ リファレンス
78% |||||

7
Control.BindingContextChanged イベント
.NET Framework クラス ライブラリ リファレンス
78% |||||

8
BindingContext.UpdateBinding メソッド
.NET Framework クラス ライブラリ リファレンス
78% |||||

9
BindingContext.Contains メソッド
.NET Framework クラス ライブラリ リファレンス
74% |||||

10
BindingManagerBase フィールド
.NET Framework クラス ライブラリ リファレンス
70% |||||

BindingContext クラスのお隣キーワード

Binding.FormattingEnabled プロパティ

Binding.GetObject メソッド

Binding.HandleNoSuchMemberError メソッド

Binding.defaultMember フィールド

BindingCompleteState 列挙体

BindingContext イベント

BindingContext クラス

BindingContext コンストラクタ

BindingContext プロパティ

BindingContext メソッド

BindingContext メンバ

BindingContext.Add メソッド

BindingContext.AddCore メソッド

検索ランキング

   

 英語⇒日本語
日本語⇒英語		    


BindingContext クラスのページの著作権
Weblio 辞書 情報提供元は 参加元一覧 にて確認できます。

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2025 Microsoft.All rights reserved.

©2025 GRAS Group, Inc.RSS