ControlBindingsCollection.Add メソッド

リファレンス

定義

名前空間:: System.Windows.Forms

アセンブリ:: System.Windows.Forms.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

Binding をコレクションに追加します。

オーバーロード

Add(Binding)	指定された Binding をコレクションに追加します。
Add(String, Object, String)	指定したコントロールプロパティ名、データソース、およびデータメンバーを使用して Binding を作成し、コレクションに追加します。
Add(String, Object, String, Boolean)	指定したコントロールプロパティ名、データソース、データメンバー、および書式指定を有効にするかどうかに関する情報を使用してバインディングを作成し、コレクションに追加します。
Add(String, Object, String, Boolean, DataSourceUpdateMode)	指定したコントロールプロパティを、指定したデータソースの指定したデータメンバーにバインドするバインディングを作成します。さらに、オプションで書式指定を有効にし、指定した更新設定に基づいてデータソースに値を反映し、バインディングをコレクションに追加します。
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object)	指定したコントロールプロパティを、指定したデータソースの指定したデータメンバーにバインドするバインディングを作成します。さらに、オプションで書式指定を有効にし、指定した更新設定に基づいてデータソースに値を反映し、データソースから DBNull が返されたときにプロパティに指定した値を設定し、バインディングをコレクションに追加します。
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)	指定したコントロールプロパティを、指定したデータソースの指定したデータメンバーにバインドするバインディングを作成します。さらに、オプションで指定した書式指定文字列を使用して書式指定を有効にし、指定した更新設定に基づいてデータソースに値を反映し、データソースから DBNull が返されたときにプロパティに指定した値を設定し、バインディングをコレクションに追加します。
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)	指定したコントロールプロパティを、指定したデータソースの指定したデータメンバーにバインドするバインディングを作成します。さらに、オプションで指定した書式指定文字列を使用して書式指定を有効にし、指定した更新設定に基づいてデータソースに値を反映し、データソースから DBNull が返されたときにプロパティに指定した値を設定し、指定した書式プロバイダーを設定し、バインディングをコレクションに追加します。

Add(Binding)

指定された Binding をコレクションに追加します。

public:
 void Add(System::Windows::Forms::Binding ^ binding);

public void Add (System.Windows.Forms.Binding binding);

override this.Add : System.Windows.Forms.Binding -> unit

Public Sub Add (binding As Binding)

パラメーター

binding: Binding

追加する Binding。

例外

ArgumentNullException

binding が null です。

ArgumentException

コントロールプロパティが既にデータ連結されています。

- または -

Binding が DataSource の有効な列を示していません。

例

次のコード例では、インスタンスをBinding作成し、メソッドをAdd使用して、コントロールのにインスタンスをControlBindingsCollection TextBox追加します。

protected:
   void BindControls()
   {
      /* Create a new Binding using the DataSet and a 
         navigation path(TableName.RelationName.ColumnName).
         Add event delegates for the Parse and Format events to 
         the 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 );
      textBox1->DataBindings->Add( b );
   }

protected void BindControls()
{
   /* Create a new Binding using the DataSet and a 
   navigation path(TableName.RelationName.ColumnName).
   Add event delegates for the Parse and Format events to 
   the 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);
   textBox1.DataBindings.Add(b);
}

Protected Sub BindControls()
    ' Create a new Binding using the DataSet and a 
    ' navigation path(TableName.RelationName.ColumnName).
    ' Add event delegates for the Parse and Format events to 
    ' the 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 New Binding("Text", ds, "customers.custToOrders.OrderAmount")
    AddHandler b.Parse, AddressOf CurrencyStringToDecimal
    AddHandler b.Format, AddressOf DecimalToCurrencyString
    textBox1.DataBindings.Add(b)
End Sub

注釈

DataSourceUpdateModeメソッドのBindingこのオーバーロードによって作成されたの Add プロパティは、プロパティのDefaultDataSourceUpdateMode値に設定されます。

イベントは CollectionChanged 、変更が完了したときに発生します。

適用対象

Add(String, Object, String)

指定したコントロールプロパティ名、データソース、およびデータメンバーを使用して Binding を作成し、コレクションに追加します。

public:
 System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember);

public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string dataMember);

public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string? dataMember);

override this.Add : string * obj * string -> System.Windows.Forms.Binding

Public Function Add (propertyName As String, dataSource As Object, dataMember As String) As Binding

パラメーター

propertyName: String

バインドするコントロールプロパティの名前。

dataSource: Object

データソースを表す Object。

dataMember: String

バインド先のプロパティまたはリスト。

戻り値

Binding

新しく作成された Binding。

例外

ArgumentNullException

binding が null です。

Exception

propertyName が既にデータ連結されています。

- または -

dataMember が、dataSource の有効なメンバーを指定していません。

例

次のコード例では、メソッドをAdd使用して、コントロールのに 3 つのBindingオブジェクトをControlBindingsCollection TextBox追加します。 ControlBindingsCollection には、DataBindings クラスの Control プロパティを使用してアクセスします。

private:
   void BindTextBoxProperties()
   {
      // Clear the collection before adding new Binding objects.
      textBox1->DataBindings->Clear();

      // Create a DataTable containing Color objects.
      DataTable^ t = MakeTable();

      /* Bind the Text, BackColor, and ForeColor properties
         to columns in the DataTable. */
      textBox1->DataBindings->Add( "Text", t, "Text" );
      textBox1->DataBindings->Add( "BackColor", t, "BackColor" );
      textBox1->DataBindings->Add( "ForeColor", t, "ForeColor" );
   }

   DataTable^ MakeTable()
   {
      /* Create a DataTable with three columns.
         Two of the columns contain Color objects. */
      DataTable^ t = gcnew DataTable( "Control" );
      t->Columns->Add( "BackColor", Color::typeid );
      t->Columns->Add( "ForeColor", Color::typeid );
      t->Columns->Add( "Text" );

      // Add three rows to the table.
      DataRow^ r;
      r = t->NewRow();
      r[ "BackColor" ] = Color::Blue;
      r[ "ForeColor" ] = Color::Yellow;
      r[ "Text" ] = "Yellow on Blue";
      t->Rows->Add( r );
      r = t->NewRow();
      r[ "BackColor" ] = Color::White;
      r[ "ForeColor" ] = Color::Green;
      r[ "Text" ] = "Green on white";
      t->Rows->Add( r );
      r = t->NewRow();
      r[ "BackColor" ] = Color::Orange;
      r[ "ForeColor" ] = Color::Black;
      r[ "Text" ] = "Black on Orange";
      t->Rows->Add( r );
      return t;
   }

private void BindTextBoxProperties()
{
   // Clear the collection before adding new Binding objects.
   textBox1.DataBindings.Clear();

   // Create a DataTable containing Color objects.
   DataTable t = MakeTable();

   /* Bind the Text, BackColor, and ForeColor properties
   to columns in the DataTable. */
   textBox1.DataBindings.Add("Text", t, "Text");
   textBox1.DataBindings.Add("BackColor", t, "BackColor");
   textBox1.DataBindings.Add("ForeColor", t, "ForeColor");
}

private DataTable MakeTable()
{
   /* Create a DataTable with three columns.
   Two of the columns contain Color objects. */

   DataTable t = new DataTable("Control");
   t.Columns.Add("BackColor", typeof(Color));
   t.Columns.Add("ForeColor", typeof(Color));
   t.Columns.Add("Text");

   // Add three rows to the table.
   DataRow r;

   r = t.NewRow();
   r["BackColor"] = Color.Blue;
   r["ForeColor"] = Color.Yellow;
   r["Text"] = "Yellow on Blue";
   t.Rows.Add(r);

   r = t.NewRow();
   r["BackColor"] = Color.White;
   r["ForeColor"] = Color.Green;
   r["Text"] = "Green on white";
   t.Rows.Add(r);

   r = t.NewRow();
   r["BackColor"] = Color.Orange;
   r["ForeColor"] = Color.Black;
   r["Text"] = "Black on Orange";
   t.Rows.Add(r);

   return t;
}

Private Sub BindTextBoxProperties()
    ' Clear the collection before adding new Binding objects.
    textBox1.DataBindings.Clear()
    
    ' Create a DataTable containing Color objects.
    Dim t As DataTable = MakeTable()
    
    ' Bind the Text, BackColor, and ForeColor properties
    ' to columns in the DataTable. 
    textBox1.DataBindings.Add("Text", t, "Text")
    textBox1.DataBindings.Add("BackColor", t, "BackColor")
    textBox1.DataBindings.Add("ForeColor", t, "ForeColor")
End Sub    

Private Function MakeTable() As DataTable
    ' Create a DataTable with three columns.
    ' Two of the columns contain Color objects. 
    
    Dim t As New DataTable("Control")
    t.Columns.Add("BackColor", GetType(Color))
    t.Columns.Add("ForeColor", GetType(Color))
    t.Columns.Add("Text")
    
    ' Add three rows to the table.
    Dim r As DataRow
    
    r = t.NewRow()
    r("BackColor") = Color.Blue
    r("ForeColor") = Color.Yellow
    r("Text") = "Yellow on Blue"
    t.Rows.Add(r)
    
    r = t.NewRow()
    r("BackColor") = Color.White
    r("ForeColor") = Color.Green
    r("Text") = "Green on white"
    t.Rows.Add(r)
    
    r = t.NewRow()
    r("BackColor") = Color.Orange
    r("ForeColor") = Color.Black
    r("Text") = "Black on Orange"
    t.Rows.Add(r)
    
    Return t
End Function

注釈

DataSourceUpdateModeメソッドのBindingこのオーバーロードによって作成されたの Add プロパティは、プロパティのDefaultDataSourceUpdateMode値に設定されます。

を Binding 追加すると、イベントが CollectionChanged 発生します。

適用対象

Add(String, Object, String, Boolean)

指定したコントロールプロパティ名、データソース、データメンバー、および書式指定を有効にするかどうかに関する情報を使用してバインディングを作成し、コレクションに追加します。

public:
 System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled);

public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string dataMember, bool formattingEnabled);

public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string? dataMember, bool formattingEnabled);

override this.Add : string * obj * string * bool -> System.Windows.Forms.Binding

Public Function Add (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean) As Binding

パラメーター

propertyName: String

バインドするコントロールプロパティの名前。

dataSource: Object

データソースを表す Object。

dataMember: String

バインド先のプロパティまたはリスト。

formattingEnabled: Boolean

表示されるデータの書式を指定する場合は true。それ以外の場合は false。

戻り値

Binding

新しく作成された Binding。

例外

ArgumentException

propertyName で指定されたプロパティがコントロールに存在しません。

- または -

指定されたプロパティは読み取り専用です。

Exception

書式指定が無効で、propertyName が、コントロールの有効なプロパティでも、空の文字列 ("") でもありません。

適用対象

Add(String, Object, String, Boolean, DataSourceUpdateMode)

指定したコントロールプロパティを、指定したデータソースの指定したデータメンバーにバインドするバインディングを作成します。さらに、オプションで書式指定を有効にし、指定した更新設定に基づいてデータソースに値を反映し、バインディングをコレクションに追加します。

public:
 System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode updateMode);

public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode);

public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode);

override this.Add : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode -> System.Windows.Forms.Binding

Public Function Add (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, updateMode As DataSourceUpdateMode) As Binding

パラメーター

propertyName: String

バインドするコントロールプロパティの名前。

dataSource: Object

データソースを表す Object。

dataMember: String

バインド先のプロパティまたはリスト。

formattingEnabled: Boolean

表示されるデータの書式を指定する場合は true。それ以外の場合は false。

updateMode: DataSourceUpdateMode

DataSourceUpdateMode 値のいずれか 1 つ。

戻り値

Binding

新しく作成された Binding。

例外

ArgumentException

propertyName で指定されたプロパティがコントロールに存在しないか、読み取り専用です。

- または -

指定されたデータメンバーがデータソースに存在しません。

- または -

指定されたデータソース、データメンバー、またはコントロールプロパティが、コレクションの別のバインディングに関連付けられています。

注釈

メソッドを Add 呼び出すと、イベントが CollectionChanged 発生します。

適用対象

Add(String, Object, String, Boolean, DataSourceUpdateMode, Object)

指定したコントロールプロパティを、指定したデータソースの指定したデータメンバーにバインドするバインディングを作成します。さらに、オプションで書式指定を有効にし、指定した更新設定に基づいてデータソースに値を反映し、データソースから DBNull が返されたときにプロパティに指定した値を設定し、バインディングをコレクションに追加します。

public:
 System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode updateMode, System::Object ^ nullValue);

public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object nullValue);

public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object? nullValue);

override this.Add : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj -> System.Windows.Forms.Binding

Public Function Add (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, updateMode As DataSourceUpdateMode, nullValue As Object) As Binding

パラメーター

propertyName: String

バインドするコントロールプロパティの名前。

dataSource: Object

データソースを表す Object。

dataMember: String

バインド先のプロパティまたはリスト。

formattingEnabled: Boolean

表示されるデータの書式を指定する場合は true。それ以外の場合は false。

updateMode: DataSourceUpdateMode

DataSourceUpdateMode 値のいずれか 1 つ。

nullValue: Object

データソースにこの値がある場合、バインドされたプロパティを DBNull に設定します。

戻り値

Binding

新しく作成された Binding。

例外

ArgumentException

propertyName で指定されたプロパティがコントロールに存在しないか、読み取り専用です。

- または -

指定されたデータメンバーがデータソースに存在しません。

- または -

指定されたデータソース、データメンバー、またはコントロールプロパティが、コレクションの別のバインディングに関連付けられています。

注釈

メソッドを Add 呼び出すと、イベントが CollectionChanged 発生します。

適用対象

Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)

指定したコントロールプロパティを、指定したデータソースの指定したデータメンバーにバインドするバインディングを作成します。さらに、オプションで指定した書式指定文字列を使用して書式指定を有効にし、指定した更新設定に基づいてデータソースに値を反映し、データソースから DBNull が返されたときにプロパティに指定した値を設定し、バインディングをコレクションに追加します。

public:
 System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode updateMode, System::Object ^ nullValue, System::String ^ formatString);

public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object nullValue, string formatString);

public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object? nullValue, string formatString);

override this.Add : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj * string -> System.Windows.Forms.Binding

Public Function Add (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, updateMode As DataSourceUpdateMode, nullValue As Object, formatString As String) As Binding

パラメーター

propertyName: String

バインドするコントロールプロパティの名前。

dataSource: Object

データソースを表す Object。

dataMember: String

バインド先のプロパティまたはリスト。

formattingEnabled: Boolean

表示されるデータの書式を指定する場合は true。それ以外の場合は false。

updateMode: DataSourceUpdateMode

DataSourceUpdateMode 値のいずれか 1 つ。

nullValue: Object

データソースにこの値がある場合、バインドされたプロパティを DBNull に設定します。

formatString: String

値の表示方法を示す 1 つ以上の書式指定子文字。

戻り値

Binding

新しく作成された Binding。

例外

ArgumentException

propertyName で指定されたプロパティがコントロールに存在しないか、読み取り専用です。

- または -

指定されたデータメンバーがデータソースに存在しません。

- または -

指定されたデータソース、データメンバー、またはコントロールプロパティが、コレクションの別のバインディングに関連付けられています。

注釈

メソッドを Add 呼び出すと、イベントが CollectionChanged 発生します。

適用対象

Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)

指定したコントロールプロパティを、指定したデータソースの指定したデータメンバーにバインドするバインディングを作成します。さらに、オプションで指定した書式指定文字列を使用して書式指定を有効にし、指定した更新設定に基づいてデータソースに値を反映し、データソースから DBNull が返されたときにプロパティに指定した値を設定し、指定した書式プロバイダーを設定し、バインディングをコレクションに追加します。

public:
 System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode updateMode, System::Object ^ nullValue, System::String ^ formatString, IFormatProvider ^ formatInfo);

public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object nullValue, string formatString, IFormatProvider formatInfo);

public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object? nullValue, string formatString, IFormatProvider? formatInfo);

override this.Add : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj * string * IFormatProvider -> System.Windows.Forms.Binding

Public Function Add (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, updateMode As DataSourceUpdateMode, nullValue As Object, formatString As String, formatInfo As IFormatProvider) As Binding

パラメーター

propertyName: String

バインドするコントロールプロパティの名前。

dataSource: Object

データソースを表す Object。

dataMember: String

バインド先のプロパティまたはリスト。

formattingEnabled: Boolean

表示されるデータの書式を指定する場合は true。それ以外の場合は false。

updateMode: DataSourceUpdateMode

DataSourceUpdateMode 値のいずれか 1 つ。

nullValue: Object

データソースにこの値がある場合、バインドされたプロパティを DBNull に設定します。

formatString: String

値の表示方法を示す 1 つ以上の書式指定子文字。

formatInfo: IFormatProvider

既定の書式指定動作をオーバーライドする IFormatProvider の実装。

戻り値

Binding

新しく作成された Binding。

例外

ArgumentException

propertyName で指定されたプロパティがコントロールに存在しないか、読み取り専用です。

- または -

指定されたデータメンバーがデータソースに存在しません。

- または -

指定されたデータソース、データメンバー、またはコントロールプロパティが、コレクションの別のバインディングに関連付けられています。

注釈

メソッドを Add 呼び出すと、イベントが CollectionChanged 発生します。

適用対象

次の方法で共有

ControlBindingsCollection.Add メソッド

定義

オーバーロード

Add(Binding)

パラメーター

例外

例

注釈

適用対象

Add(String, Object, String)

パラメーター

戻り値

例外

例

注釈

適用対象

Add(String, Object, String, Boolean)

パラメーター

戻り値

例外

適用対象

Add(String, Object, String, Boolean, DataSourceUpdateMode)

パラメーター

戻り値

例外

注釈

適用対象

Add(String, Object, String, Boolean, DataSourceUpdateMode, Object)

パラメーター

戻り値

例外

注釈

適用対象

Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)

パラメーター

戻り値

例外

注釈

適用対象

Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)

パラメーター

戻り値

例外

注釈

適用対象

その他のリソース