ControlBindingsCollection.Add 方法

定义

命名空间:: System.Windows.Forms

程序集:: System.Windows.Forms.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

将 a 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)

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

将指定的 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该方法的此重载Add创建的属性Binding设置为该属性的值DefaultDataSourceUpdateMode。

更改 CollectionChanged 完成时发生该事件。

适用于

Add(String, Object, String)

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

使用指定的控件属性名称、数据源和数据成员创建一个 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该方法将三Binding个TextBox对象添加到ControlBindingsCollection控件。可通过ControlBindingsCollection类的属性Control访问DataBindings该属性。

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该方法的此重载Add创建的属性Binding设置为该属性的值DefaultDataSourceUpdateMode。

添加会导致Binding CollectionChanged事件发生。

适用于

Add(String, Object, String, Boolean)

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

使用指定的控件属性名称、数据源、数据成员以及是否启用格式设置的信息创建绑定，并将绑定添加到集合。

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)

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

创建一个绑定，该绑定将指定的控件属性绑定到指定数据源的指定数据成员，可以选择启用格式设置，根据指定的更新设置将值传播到数据源，并将绑定添加到集合。

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 值。

Binding

新建 Binding的。

例外

ArgumentException

控件上不存在指定的 propertyName 属性或为只读属性。

-或-

数据源上不存在指定的数据成员。

-或-

指定的数据源、数据成员或控件属性与集合中的另一个绑定相关联。

注解

Add调用该方法将CollectionChanged引发事件。

适用于

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

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

创建一个绑定，该绑定将指定的控件属性绑定到指定数据源的指定数据成员，可以选择启用格式设置，根据指定的更新设置将值传播到数据源，将属性设置为指定值（从数据源返回时 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 值。

nullValue: Object

当数据源具有此值时，绑定属性将设置为 DBNull。

Binding

新建 Binding的。

例外

ArgumentException

控件上不存在指定的 propertyName 属性或为只读属性。

-或-

数据源上不存在指定的数据成员。

-或-

指定的数据源、数据成员或控件属性与集合中的另一个绑定相关联。

注解

Add调用该方法将CollectionChanged引发事件。

适用于

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

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

创建一个绑定，该绑定将指定的控件属性绑定到指定数据源的指定数据成员，可以选择使用指定的格式字符串启用格式设置，根据指定的更新设置将值传播到数据源，将属性设置为指定值（从数据源返回时 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 值。

nullValue: Object

当数据源具有此值时，绑定属性将设置为 DBNull。

formatString: String

一个或多个格式说明符，指示如何显示值。

Binding

新建 Binding的。

例外

ArgumentException

控件上不存在指定的 propertyName 属性或为只读属性。

-或-

数据源上不存在指定的数据成员。

-或-

指定的数据源、数据成员或控件属性与集合中的另一个绑定相关联。

注解

Add调用该方法将CollectionChanged引发事件。

适用于

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

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

创建一个绑定，将指定的控件属性绑定到指定数据源的指定数据成员，可以选择使用指定的格式字符串启用格式设置，根据指定的更新设置将值传播到数据源，将属性设置为从数据源返回时 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 值。

nullValue: Object

当数据源具有此值时，绑定属性将设置为 DBNull。

formatString: String

一个或多个格式说明符，指示如何显示值。

formatInfo: IFormatProvider

重写默认格式行为的实现 IFormatProvider 。

Binding

新建 Binding的。

例外

ArgumentException

控件上不存在指定的 propertyName 属性或为只读属性。

-或-

数据源上不存在指定的数据成员。

-或-

指定的数据源、数据成员或控件属性与集合中的另一个绑定相关联。

注解

Add调用该方法将CollectionChanged引发事件。

适用于

反馈

此页面是否有帮助？