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 介面的任何類別
任何類別

Binding如需建立字串的詳細資訊， dataMember 請參閱類別。

當您建立控制項屬性的系結時，新的 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 介面的任何類別
任何類別

Binding如需建立字串的詳細資訊， dataMember 請參閱類別。

當您建立控制項屬性的系結時，新的 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 介面的任何類別
任何類別

Binding如需建立字串的詳細資訊， dataMember 請參閱類別。

當您建立控制項屬性的系結時，新的 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 介面的任何類別
任何類別

Binding如需建立字串的詳細資訊， dataMember 請參閱類別。

當您建立控制項屬性的系結時，新的 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 介面的任何類別
任何類別

Binding如需建立字串的詳細資訊， dataMember 請參閱類別。

當您建立控制項屬性的系結時，新的 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)

參數

例外狀況

備註

適用於

其他資源