共用方式為


Binding 建構函式

定義

初始化 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

要繫結的屬性或清單。

例外狀況

propertyName 既不是控制項的有效屬性,也不是空字串 ("")。

控制項上沒有 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

備註

您可以為資料來源指定下列任何類別的實例:

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

當您建立控制項屬性的系結時,新的 Binding 會檢查系結控制項所公開的事件,並附加至兩個特定事件:

如果您嘗試系結至不存在的屬性, 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

例外狀況

控制項上沒有 propertyName 所指定的屬性。

-或-

指定的屬性是唯讀屬性。

已停用格式化,而且 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 值。

例外狀況

控制項上沒有 propertyName 所指定的屬性。

-或-

指定的資料來源或資料成員或控制項屬性是與集合中的另一個繫結相關聯。

備註

您可以為資料來源指定下列任何類別的實例:

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

當您建立控制項屬性的系結時,新的 Binding 會檢查系結控制項所公開的事件,並附加至兩個特定事件:

適用於

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

例外狀況

控制項上沒有 propertyName 所指定的屬性。

-或-

指定的資料來源或資料成員或控制項屬性是與集合中的另一個繫結相關聯。

備註

您可以為資料來源指定下列任何類別的實例:

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

當您建立控制項屬性的系結時,新的 Binding 會檢查系結控制項所公開的事件,並附加至兩個特定事件:

適用於

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

指示如何顯示數值的一或多個格式規範字元。

例外狀況

控制項上沒有 propertyName 所指定的屬性。

-或-

指定的資料來源或資料成員或控制項屬性是與集合中的另一個繫結相關聯。

備註

您可以為資料來源指定下列任何類別的實例:

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

當您建立控制項屬性的系結時,新的 Binding 會檢查系結控制項所公開的事件,並附加至兩個特定事件:

適用於

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 的實作。

例外狀況

控制項上沒有 propertyName 所指定的屬性。

-或-

指定的資料來源或資料成員或控制項屬性是與集合中的另一個繫結相關聯。

備註

您可以為資料來源指定下列任何類別的實例:

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

當您建立控制項屬性的系結時,新的 Binding 會檢查系結控制項所公開的事件,並附加至兩個特定事件:

適用於