Binding 构造函数

参考

定义

命名空间:: System.Windows.Forms

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

重要

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

初始化 Binding 类的新实例。

重载

Binding(String, Object, String)	初始化 Binding 类的一个新实例，该类将指示的控件属性简单绑定到数据源的指定数据成员。
Binding(String, Object, String, Boolean)	初始化 Binding 类的一个新实例，该实例将指示的控件属性绑定到数据源的指定数据成员，并启用要应用的格式设置（可选）。
Binding(String, Object, String, Boolean, DataSourceUpdateMode)	初始化 Binding 类的新实例，该实例将指定的控件属性绑定到指定数据源的指定数据成员。（可选）根据指定的更新设置，启用格式设置并将值传播到数据源。
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object)	初始化 Binding 类的新实例，该实例将指示的控件属性绑定到指定数据源的指定数据成员。（可选）根据指定的更新设置，启用格式设置并将值传播到数据源，然后在从数据源返回 DBNull 时将该属性设置为指定值。
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)	初始化 Binding 类的新实例，该实例将指定的控件属性绑定到指定数据源的指定数据成员。（可选）允许用指定的格式字符串进行格式设置；根据指定的更新设置将值传播到数据源；在从数据源返回 DBNull 时将该属性设置为指定的值。
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)	初始化 Binding 类的新实例，并将指定的控件属性绑定到指定数据源的指定数据成员。（可选）利用指定的格式字符串启用格式设置；根据指定的更新设置将值传播到数据源；利用指定的格式字符串启用格式设置；以及当从数据源返回 DBNull 时将属性设为指定值，并设置指定的格式提供程序。

Binding(String, Object, String)

初始化 Binding 类的一个新实例，该类将指示的控件属性简单绑定到数据源的指定数据成员。

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

public Binding (string propertyName, object dataSource, string dataMember);

public Binding (string propertyName, object? dataSource, string? dataMember);

new System.Windows.Forms.Binding : string * obj * string -> System.Windows.Forms.Binding

Public Sub New (propertyName As String, dataSource As Object, dataMember As String)

参数

propertyName: String

要绑定的控件属性的名称。

dataSource: Object

一个表示数据源的 Object。

dataMember: String

要绑定到的属性或列表。

例外

Exception

propertyName 既不是控件的有效属性，也不是空字符串 ("")。

ArgumentException

在该控件中不存在由 propertyName 给出的属性。

示例

下面的代码示例将控件TextBox绑定到名为 myDataSet中的DataSet表列。该示例要求已在模块的声明部分中声明 myDataSet 。

private:
   void CreateDataSet()
   {
      myDataSet = gcnew DataSet( "myDataSet" );
      /* Populates the DataSet with tables, relations, and 
         constraints. */
   }

   void BindTextBoxToDataSet()
   {
      /* Binds a TextBox control to a DataColumn named
      CompanyName in the DataTable named Suppliers. */
      textBox1->DataBindings->Add(
         "Text", myDataSet, "Suppliers.CompanyName" );
   }

private void CreateDataSet()
{
   myDataSet = new DataSet("myDataSet");
   /* Populates the DataSet with tables, relations, and 
      constraints. */
}

private void BindTextBoxToDataSet()
{
   /* Binds a TextBox control to a DataColumn named
   CompanyName in the DataTable named Suppliers. */
   textBox1.DataBindings.Add
   ("Text", myDataSet, "Suppliers.CompanyName");
}

Private Sub CreateDataSet
   myDataSet = new DataSet("myDataSet")
   ' Populates the DataSet with tables, relations, and
   ' constraints.
End Sub

Private Sub BindTextBoxToDataSet 
   ' Binds a TextBox control to a column in the DataSet.
   textBox1.DataBindings.Add _
   ("Text", myDataSet, "Suppliers.CompanyName")
End Sub

注解

可以为数据源指定以下任何类的实例：

DataSet
DataTable
DataView
DataViewManager
BindingSource
实现 IList 接口的任何类
任何类

有关创建字符串的详细信息，BindingdataMember请参阅类。

创建到控件属性的绑定时，新 Binding 将检查绑定控件公开的事件，并附加到两个特定事件：

Control.Validating
例如，名为 PropertyNameChanged 的事件 () Control.BackColorChanged

如果尝试绑定到不存在的属性，ArgumentException则在将添加到控件的Control.DataBindings集合时Binding将引发。

另请参阅

适用于

Binding(String, Object, String, Boolean)

初始化 Binding 类的一个新实例，该实例将指示的控件属性绑定到数据源的指定数据成员，并启用要应用的格式设置（可选）。

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

public Binding (string propertyName, object dataSource, string dataMember, bool formattingEnabled);

public Binding (string propertyName, object? dataSource, string? dataMember, bool formattingEnabled);

new System.Windows.Forms.Binding : string * obj * string * bool -> System.Windows.Forms.Binding

Public Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean)

参数

propertyName: String

要绑定的控件属性的名称。

dataSource: Object

一个表示数据源的 Object。

dataMember: String

要绑定到的属性或列表。

formattingEnabled: Boolean

若要格式化显示的数据，则为 true；否则为 false。

例外

ArgumentException

在该控件中不存在由 propertyName 给出的属性。

- 或 -

给定的属性为只读属性。

Exception

禁用格式设置，且 propertyName 既不是有效的控件属性，也不是空字符串 ("")。

适用于

Binding(String, Object, String, Boolean, DataSourceUpdateMode)

初始化 Binding 类的新实例，该实例将指定的控件属性绑定到指定数据源的指定数据成员。（可选）根据指定的更新设置，启用格式设置并将值传播到数据源。

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

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

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

new System.Windows.Forms.Binding : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode -> System.Windows.Forms.Binding

Public Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, dataSourceUpdateMode As DataSourceUpdateMode)

参数

propertyName: String

要绑定的控件属性的名称。

dataSource: Object

表示数据源的 Object。

dataMember: String

要绑定到的属性或列表。

formattingEnabled: Boolean

若要格式化显示的数据，则为 true；否则为 false。

dataSourceUpdateMode: DataSourceUpdateMode

DataSourceUpdateMode 值之一。

例外

ArgumentException

在该控件中不存在由 propertyName 给出的属性。

- 或 -

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

注解

可以为数据源指定以下任何类的实例：

DataSet
DataTable
DataView
DataViewManager
BindingSource
实现 IList 接口的任何类
任何类

有关创建字符串的详细信息，BindingdataMember请参阅类。

创建到控件属性的绑定时，新 Binding 将检查绑定控件公开的事件，并附加到两个特定事件：

Control.Validating.
例如，名为 PropertyNameChanged 的事件 () Control.BackColorChanged

适用于

Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object)

初始化 Binding 类的新实例，该实例将指示的控件属性绑定到指定数据源的指定数据成员。（可选）根据指定的更新设置，启用格式设置并将值传播到数据源，然后在从数据源返回 DBNull 时将该属性设置为指定值。

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

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

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

new System.Windows.Forms.Binding : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj -> System.Windows.Forms.Binding

Public Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, dataSourceUpdateMode As DataSourceUpdateMode, nullValue As Object)

参数

propertyName: String

要绑定的控件属性的名称。

dataSource: Object

表示数据源的 Object。

dataMember: String

要绑定到的属性或列表。

formattingEnabled: Boolean

若要格式化显示的数据，则为 true；否则为 false。

dataSourceUpdateMode: DataSourceUpdateMode

DataSourceUpdateMode 值之一。

nullValue: Object

当数据源值为 Object 时要应用于绑定控件属性的 DBNull。

例外

ArgumentException

在该控件中不存在由 propertyName 给出的属性。

- 或 -

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

注解

可以为数据源指定以下任何类的实例：

DataSet
DataTable
DataView
DataViewManager
BindingSource
实现 IList 接口的任何类
任何类

有关创建字符串的详细信息，BindingdataMember请参阅类。

创建到控件属性的绑定时，新 Binding 将检查绑定控件公开的事件，并附加到两个特定事件：

Control.Validating
例如，名为 PropertyNameChanged 的事件 () Control.BackColorChanged

适用于

Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)

初始化 Binding 类的新实例，该实例将指定的控件属性绑定到指定数据源的指定数据成员。（可选）允许用指定的格式字符串进行格式设置；根据指定的更新设置将值传播到数据源；在从数据源返回 DBNull 时将该属性设置为指定的值。

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

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

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

new System.Windows.Forms.Binding : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj * string -> System.Windows.Forms.Binding

Public Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, dataSourceUpdateMode As DataSourceUpdateMode, nullValue As Object, formatString As String)

参数

propertyName: String

要绑定的控件属性的名称。

dataSource: Object

表示数据源的 Object。

dataMember: String

要绑定到的属性或列表。

formattingEnabled: Boolean

若要格式化显示的数据，则为 true；否则为 false。

dataSourceUpdateMode: DataSourceUpdateMode

DataSourceUpdateMode 值之一。

nullValue: Object

当数据源值为 Object 时要应用于绑定控件属性的 DBNull。

formatString: String

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

例外

ArgumentException

在该控件中不存在由 propertyName 给出的属性。

- 或 -

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

注解

可以为数据源指定以下任何类的实例：

DataSet
DataTable
DataView
DataViewManager
BindingSource
实现 IList 接口的任何类
任何类

有关创建字符串的详细信息，BindingdataMember请参阅类。

创建到控件属性的绑定时，新 Binding 将检查绑定控件公开的事件，并附加到两个特定事件：

Control.Validating
例如，名为 PropertyNameChanged 的事件 () Control.BackColorChanged

适用于

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

初始化 Binding 类的新实例，并将指定的控件属性绑定到指定数据源的指定数据成员。（可选）利用指定的格式字符串启用格式设置；根据指定的更新设置将值传播到数据源；利用指定的格式字符串启用格式设置；以及当从数据源返回 DBNull 时将属性设为指定值，并设置指定的格式提供程序。

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

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

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

new System.Windows.Forms.Binding : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj * string * IFormatProvider -> System.Windows.Forms.Binding

Public Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, dataSourceUpdateMode As DataSourceUpdateMode, nullValue As Object, formatString As String, formatInfo As IFormatProvider)

参数

propertyName: String

要绑定的控件属性的名称。

dataSource: Object

表示数据源的 Object。

dataMember: String

要绑定到的属性或列表。

formattingEnabled: Boolean

若要格式化显示的数据，则为 true；否则为 false。

dataSourceUpdateMode: DataSourceUpdateMode

DataSourceUpdateMode 值之一。

nullValue: Object

当数据源值为 Object 时要应用于绑定控件属性的 DBNull。

formatString: String

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

formatInfo: IFormatProvider

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

例外

ArgumentException

在该控件中不存在由 propertyName 给出的属性。

- 或 -

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

注解

可以为数据源指定以下任何类的实例：

DataSet
DataTable
DataView
DataViewManager
BindingSource
实现 IList 接口的任何类
任何类

有关创建字符串的详细信息，BindingdataMember请参阅类。

创建到控件属性的绑定时，新 Binding 将检查绑定控件公开的事件，并附加到两个特定事件：

Control.Validating
例如，名为 PropertyNameChanged 的事件 () Control.BackColorChanged

适用于

通过

Binding 构造函数

定义

重载

Binding(String, Object, String)

参数

例外

示例

注解

另请参阅

适用于

Binding(String, Object, String, Boolean)

参数

例外

适用于

Binding(String, Object, String, Boolean, DataSourceUpdateMode)

参数

例外

注解

适用于

Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object)

参数

例外

注解

适用于

Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)

参数

例外

注解

适用于

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

参数

例外

注解

适用于

其他资源