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)

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

初始化类的新实例，该实例 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控件绑定到命名DataSet中的myDataSet表列。该示例要求已在模块的声明部分中声明 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 接口的任何类
任何类

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

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

Control.Validating
名为 PropertyNameChanged 的事件（例如 Control.BackColorChanged）

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

另请参阅

适用于

Binding(String, Object, String, Boolean)

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

初始化类的新实例，该实例 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)

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

初始化将指定控件属性绑定到指定数据源的指定数据成员的类的新实例 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 接口的任何类
任何类

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

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

Control.Validating。
名为 PropertyNameChanged 的事件（例如 Control.BackColorChanged）

适用于

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

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

初始化类的新实例，该实例 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 接口的任何类
任何类

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

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

Control.Validating
名为 PropertyNameChanged 的事件（例如 Control.BackColorChanged）

适用于

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

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

初始化将指定控件属性绑定到指定数据源的指定数据成员的类的新实例 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 接口的任何类
任何类

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

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

Control.Validating
名为 PropertyNameChanged 的事件（例如 Control.BackColorChanged）

适用于

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

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

使用指定的控件属性将类的新实例 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 接口的任何类
任何类

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

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

Control.Validating
名为 PropertyNameChanged 的事件（例如 Control.BackColorChanged）

适用于

反馈

此页面是否有帮助？