ControlBindingsCollection.Add ControlBindingsCollection.Add ControlBindingsCollection.Add ControlBindingsCollection.Add Method

定義

Binding をコレクションに追加します。Adds a Binding to the collection.

オーバーロード

Add(Binding) Add(Binding) Add(Binding)

指定された Binding をコレクションに追加します。Adds the specified Binding to the collection.

Add(String, Object, String) Add(String, Object, String) Add(String, Object, String) Add(String, Object, String)

指定したコントロール プロパティ名、データ ソース、およびデータ メンバーを使用して Binding を作成し、コレクションに追加します。Creates a Binding using the specified control property name, data source, and data member, and adds it to the collection.

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

指定したコントロール プロパティ名、データ ソース、データ メンバー、および書式指定を有効にするかどうかに関する情報を使用してバインディングを作成し、コレクションに追加します。Creates a binding with the specified control property name, data source, data member, and information about whether formatting is enabled, and adds the binding to the collection.

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

指定したコントロール プロパティを、指定したデータ ソースの指定したデータ メンバーにバインドするバインディングを作成します。さらに、オプションで書式指定を有効にし、指定した更新設定に基づいてデータ ソースに値を反映し、バインディングをコレクションに追加します。Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting, propagating values to the data source based on the specified update setting, and adding the binding to the collection.

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

指定したコントロール プロパティを、指定したデータ ソースの指定したデータ メンバーにバインドするバインディングを作成します。さらに、オプションで書式指定を有効にし、指定した更新設定に基づいてデータ ソースに値を反映し、データ ソースから DBNull が返されたときにプロパティに指定した値を設定し、バインディングをコレクションに追加します。Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting, propagating values to the data source based on the specified update setting, setting the property to the specified value when DBNull is returned from the data source, and adding the binding to the collection.

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

指定したコントロール プロパティを、指定したデータ ソースの指定したデータ メンバーにバインドするバインディングを作成します。さらに、オプションで指定した書式指定文字列を使用して書式指定を有効にし、指定した更新設定に基づいてデータ ソースに値を反映し、データ ソースから DBNull が返されたときにプロパティに指定した値を設定し、バインディングをコレクションに追加します。Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting with the specified format string, propagating values to the data source based on the specified update setting, setting the property to the specified value when DBNull is returned from the data source, and adding the binding to the collection.

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

指定したコントロール プロパティを、指定したデータ ソースの指定したデータ メンバーにバインドするバインディングを作成します。さらに、オプションで指定した書式指定文字列を使用して書式指定を有効にし、指定した更新設定に基づいてデータ ソースに値を反映し、データ ソースから DBNull が返されたときにプロパティに指定した値を設定し、指定した書式プロバイダーを設定し、バインディングをコレクションに追加します。Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting with the specified format string, propagating values to the data source based on the specified update setting, setting the property to the specified value when DBNull is returned from the data source, setting the specified format provider, and adding the binding to the collection.

Add(Binding) Add(Binding) Add(Binding)

指定された Binding をコレクションに追加します。Adds the specified Binding to the collection.

public:
 void Add(System::Windows::Forms::Binding ^ binding);
public void Add (System.Windows.Forms.Binding binding);
override this.Add : System.Windows.Forms.Binding -> unit

パラメーター

binding
Binding Binding Binding Binding

追加する BindingThe Binding to add.

例外

コントロール プロパティが既にデータ連結されています。The control property is already data-bound.

- または --or-

BindingDataSource の有効な列を示していません。The Binding does not specify a valid column of the DataSource.

Bindingインスタンスを作成し、 Addメソッドを使用して、 ControlBindingsCollection TextBoxコントロールのにインスタンスを追加するコード例を次に示します。The following code example creates a Binding instance, and uses the Add method to add the instance to the ControlBindingsCollection of a TextBox control.

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    

注釈

メソッドのこのオーバーロードBinding DataSourceUpdateMode によって作成されるのプロパティは、プロパティの値に設定されます。DefaultDataSourceUpdateMode AddThe DataSourceUpdateMode property of the Binding created by this overload of the Add method is set to the value of the DefaultDataSourceUpdateMode property.

イベントCollectionChangedは、変更が完了したときに発生します。The CollectionChanged event occurs when the change is complete.

Add(String, Object, String) Add(String, Object, String) Add(String, Object, String) Add(String, Object, String)

指定したコントロール プロパティ名、データ ソース、およびデータ メンバーを使用して Binding を作成し、コレクションに追加します。Creates a Binding using the specified control property name, data source, and data member, and adds it to the collection.

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

バインドするコントロール プロパティの名前。The name of the control property to bind.

dataSource
Object Object Object Object

データ ソースを表す ObjectAn Object that represents the data source.

dataMember
String String String String

バインド先のプロパティまたはリスト。The property or list to bind to.

戻り値

新しく作成された BindingThe newly created Binding.

例外

propertyName が既にデータ連結されています。The propertyName is already data-bound.

- または --or-

dataMember が、dataSource の有効なメンバーを指定していません。The dataMember doesn't specify a valid member of the dataSource.

次のコード例ではAdd 、メソッドを使用Bindingして、 ControlBindingsCollection TextBoxコントロールのに3つのオブジェクトを追加します。The following code example uses the Add method to add three Binding objects to the ControlBindingsCollection of a TextBox control. ControlBindingsCollection には、DataBindings クラスの Control プロパティを使用してアクセスします。The ControlBindingsCollection is accessed through the DataBindings property of the Control class.

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

注釈

メソッドのこのオーバーロードBinding DataSourceUpdateMode によって作成されるのプロパティは、プロパティの値に設定されます。DefaultDataSourceUpdateMode AddThe DataSourceUpdateMode property of the Binding created by this overload of the Add method is set to the value of the DefaultDataSourceUpdateMode property.

Binding追加するとCollectionChanged 、イベントが発生します。Adding a Binding causes the CollectionChanged event to occur.

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

指定したコントロール プロパティ名、データ ソース、データ メンバー、および書式指定を有効にするかどうかに関する情報を使用してバインディングを作成し、コレクションに追加します。Creates a binding with the specified control property name, data source, data member, and information about whether formatting is enabled, and adds the binding to the collection.

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

バインドするコントロール プロパティの名前。The name of the control property to bind.

dataSource
Object Object Object Object

データ ソースを表す ObjectAn Object representing the data source.

dataMember
String String String String

バインド先のプロパティまたはリスト。The property or list to bind to.

formattingEnabled
Boolean Boolean Boolean Boolean

表示されるデータの書式を指定する場合は true。それ以外の場合は falsetrue to format the displayed data; otherwise, false

戻り値

新しく作成された BindingThe newly created Binding.

例外

propertyName で指定されたプロパティがコントロールに存在しません。The property given by propertyName does not exist on the control.

- または --or- 指定されたプロパティは読み取り専用です。The property given is a read-only property.

書式指定が無効で、propertyName が、コントロールの有効なプロパティでも、空の文字列 ("") でもありません。If formatting is disabled and the propertyName is neither a valid property of a control nor an empty string ("").

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

指定したコントロール プロパティを、指定したデータ ソースの指定したデータ メンバーにバインドするバインディングを作成します。さらに、オプションで書式指定を有効にし、指定した更新設定に基づいてデータ ソースに値を反映し、バインディングをコレクションに追加します。Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting, propagating values to the data source based on the specified update setting, and adding the binding to the collection.

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

バインドするコントロール プロパティの名前。The name of the control property to bind.

dataSource
Object Object Object Object

データ ソースを表す ObjectAn Object representing the data source.

dataMember
String String String String

バインド先のプロパティまたはリスト。The property or list to bind to.

formattingEnabled
Boolean Boolean Boolean Boolean

表示されるデータの書式を指定する場合は true。それ以外の場合は falsetrue to format the displayed data; otherwise, false.

戻り値

新しく作成された BindingThe newly created Binding.

例外

propertyName で指定されたプロパティがコントロールに存在しないか、読み取り専用です。The property given by propertyName does not exist on the control or is read-only.

- または --or- 指定されたデータ メンバーがデータ ソースに存在しません。The specified data member does not exist on the data source.

- または --or- 指定されたデータ ソース、データ メンバー、またはコントロール プロパティが、コレクションの別のバインディングに関連付けられています。The data source, data member, or control property specified are associated with another binding in the collection.

注釈

メソッドをAdd呼び出すとCollectionChanged 、イベントが発生します。Calling the Add method raises the CollectionChanged event.

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

指定したコントロール プロパティを、指定したデータ ソースの指定したデータ メンバーにバインドするバインディングを作成します。さらに、オプションで書式指定を有効にし、指定した更新設定に基づいてデータ ソースに値を反映し、データ ソースから DBNull が返されたときにプロパティに指定した値を設定し、バインディングをコレクションに追加します。Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting, propagating values to the data source based on the specified update setting, setting the property to the specified value when DBNull is returned from the data source, and adding the binding to the collection.

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

バインドするコントロール プロパティの名前。The name of the control property to bind.

dataSource
Object Object Object Object

データ ソースを表す ObjectAn Object representing the data source.

dataMember
String String String String

バインド先のプロパティまたはリスト。The property or list to bind to.

formattingEnabled
Boolean Boolean Boolean Boolean

表示されるデータの書式を指定する場合は true。それ以外の場合は falsetrue to format the displayed data; otherwise, false.

nullValue
Object Object Object Object

データ ソースにこの値がある場合、バインドされたプロパティを DBNull に設定します。When the data source has this value, the bound property is set to DBNull.

戻り値

新しく作成された BindingThe newly created Binding

例外

propertyName で指定されたプロパティがコントロールに存在しないか、読み取り専用です。The property given by propertyName does not exist on the control or is read-only.

または-or- 指定されたデータ メンバーがデータ ソースに存在しません。The specified data member does not exist on the data source.

または-or- 指定されたデータ ソース、データ メンバー、またはコントロール プロパティが、コレクションの別のバインディングに関連付けられています。The data source, data member, or control property specified are associated with another binding in the collection.

注釈

メソッドをAdd呼び出すとCollectionChanged 、イベントが発生します。Calling the Add method raises the CollectionChanged event.

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

指定したコントロール プロパティを、指定したデータ ソースの指定したデータ メンバーにバインドするバインディングを作成します。さらに、オプションで指定した書式指定文字列を使用して書式指定を有効にし、指定した更新設定に基づいてデータ ソースに値を反映し、データ ソースから DBNull が返されたときにプロパティに指定した値を設定し、バインディングをコレクションに追加します。Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting with the specified format string, propagating values to the data source based on the specified update setting, setting the property to the specified value when DBNull is returned from the data source, and adding the binding to the collection.

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

バインドするコントロール プロパティの名前。The name of the control property to bind.

dataSource
Object Object Object Object

データ ソースを表す ObjectAn Object representing the data source.

dataMember
String String String String

バインド先のプロパティまたはリスト。The property or list to bind to.

formattingEnabled
Boolean Boolean Boolean Boolean

表示されるデータの書式を指定する場合は true。それ以外の場合は falsetrue to format the displayed data; otherwise, false.

nullValue
Object Object Object Object

データ ソースにこの値がある場合、バインドされたプロパティを DBNull に設定します。When the data source has this value, the bound property is set to DBNull.

formatString
String String String String

値の表示方法を示す 1 つ以上の書式指定子文字。One or more format specifier characters that indicate how a value is to be displayed.

戻り値

新しく作成された BindingThe newly created Binding

例外

propertyName で指定されたプロパティがコントロールに存在しないか、読み取り専用です。The property given by propertyName does not exist on the control or is read-only.

- または --or- 指定されたデータ メンバーがデータ ソースに存在しません。The specified data member does not exist on the data source.

または-or- 指定されたデータ ソース、データ メンバー、またはコントロール プロパティが、コレクションの別のバインディングに関連付けられています。The data source, data member, or control property specified are associated with another binding in the collection.

注釈

メソッドをAdd呼び出すとCollectionChanged 、イベントが発生します。Calling the Add method raises the CollectionChanged event.

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

指定したコントロール プロパティを、指定したデータ ソースの指定したデータ メンバーにバインドするバインディングを作成します。さらに、オプションで指定した書式指定文字列を使用して書式指定を有効にし、指定した更新設定に基づいてデータ ソースに値を反映し、データ ソースから DBNull が返されたときにプロパティに指定した値を設定し、指定した書式プロバイダーを設定し、バインディングをコレクションに追加します。Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting with the specified format string, propagating values to the data source based on the specified update setting, setting the property to the specified value when DBNull is returned from the data source, setting the specified format provider, and adding the binding to the collection.

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

バインドするコントロール プロパティの名前。The name of the control property to bind.

dataSource
Object Object Object Object

データ ソースを表す ObjectAn Object representing the data source.

dataMember
String String String String

バインド先のプロパティまたはリスト。The property or list to bind to.

formattingEnabled
Boolean Boolean Boolean Boolean

表示されるデータの書式を指定する場合は true。それ以外の場合は falsetrue to format the displayed data; otherwise, false.

nullValue
Object Object Object Object

データ ソースにこの値がある場合、バインドされたプロパティを DBNull に設定します。When the data source has this value, the bound property is set to DBNull.

formatString
String String String String

値の表示方法を示す 1 つ以上の書式指定子文字。One or more format specifier characters that indicate how a value is to be displayed

formatInfo
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

既定の書式指定動作をオーバーライドする IFormatProvider の実装。An implementation of IFormatProvider to override default formatting behavior.

戻り値

新しく作成された BindingThe newly created Binding.

例外

propertyName で指定されたプロパティがコントロールに存在しないか、読み取り専用です。The property given by propertyName does not exist on the control or is read-only.

または-or- 指定されたデータ メンバーがデータ ソースに存在しません。The specified data member does not exist on the data source.

- または --or- 指定されたデータ ソース、データ メンバー、またはコントロール プロパティが、コレクションの別のバインディングに関連付けられています。The data source, data member, or control property specified are associated with another binding in the collection.

注釈

メソッドをAdd呼び出すとCollectionChanged 、イベントが発生します。Calling the Add method raises the CollectionChanged event.

適用対象