Binding 建構函式

定義

命名空間:: System.Windows.Forms

組件:: System.Windows.Forms.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

初始化 Binding 類別的新執行個體。

多載

名稱	Description
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 ，將所指定的控制屬性綁定到指定資料來源的指定資料成員。可選擇啟用格式化，根據指定的更新設定將值傳遞至資料來源，並在從資料來源回傳 a DBNull 時將屬性設定為指定值。
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)	初始化一個新的類別實例 Binding ，將指定的控制屬性綁定到指定資料來源的指定資料成員。可選擇性地啟用指定格式字串的格式化;根據指定的更新設定，將數值傳播到資料來源;當從資料來源回傳 a DBNull 時，將屬性設為指定的值。
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)	初始化一個帶有指定控制屬性的類別實例 Binding ，初始化為指定資料來源的指定資料成員。可選擇性地啟用指定格式字串的格式化;根據指定的更新設定，將數值傳播到資料來源;啟用指定格式字串的格式化;當 a DBNull 從資料來源回傳時，將屬性設定為指定值;並設定指定的格式提供者。

Binding(String, Object, String)

來源:: Binding.cs

來源:: Binding.cs

來源:: Binding.cs

來源:: Binding.cs

來源:: 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)

來源:: Binding.cs

來源:: Binding.cs

來源:: Binding.cs

來源:: Binding.cs

來源:: 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)

來源:: Binding.cs

來源:: Binding.cs

來源:: Binding.cs

來源:: Binding.cs

來源:: 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

A 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.cs

來源:: Binding.cs

來源:: Binding.cs

來源:: Binding.cs

來源:: Binding.cs

初始化一個新的類別實例 Binding ，將所指定的控制屬性綁定到指定資料來源的指定資料成員。可選擇啟用格式化，根據指定的更新設定將值傳遞至資料來源，並在從資料來源回傳 a 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

A 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.cs

來源:: Binding.cs

來源:: Binding.cs

來源:: Binding.cs

來源:: Binding.cs

初始化一個新的類別實例 Binding ，將指定的控制屬性綁定到指定資料來源的指定資料成員。可選擇性地啟用指定格式字串的格式化;根據指定的更新設定，將數值傳播到資料來源;當從資料來源回傳 a 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

A 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.cs

來源:: Binding.cs

來源:: Binding.cs

來源:: Binding.cs

來源:: Binding.cs

初始化一個帶有指定控制屬性的類別實例 Binding ，初始化為指定資料來源的指定資料成員。可選擇性地啟用指定格式字串的格式化;根據指定的更新設定，將數值傳播到資料來源;啟用指定格式字串的格式化;當 a 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

A 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）

適用於

意見反應

此頁面對您有幫助嗎？