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 で指定されたプロパティがコントロールに存在しません。

次のコード例では、 という名前myDataSetTextBox テーブル列にコントロールを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 検査され、2 つの特定のイベントにアタッチされます。

存在しないプロパティにバインドしようとすると、 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 値のいずれか 1 つ。

例外

propertyName で指定されたプロパティがコントロールに存在しません。

- または -

指定されたデータ ソース/データ メンバーまたはコントロール プロパティは、コレクションの別のバインディングに関連付けられています。

注釈

データ ソースには、次のいずれかのクラスのインスタンスを指定できます。

文字列の作成の Binding 詳細については、 クラスを dataMember 参照してください。

コントロールの プロパティへのバインドを作成すると、バインドされたコントロールによって公開されるイベントが新しく Binding 検査され、2 つの特定のイベントにアタッチされます。

適用対象

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 値のいずれか 1 つ。

nullValue
Object

データ ソースの値が Object である場合に、バインドされたコントロール プロパティに適用される DBNull

例外

propertyName で指定されたプロパティがコントロールに存在しません。

- または -

指定されたデータ ソース/データ メンバーまたはコントロール プロパティは、コレクションの別のバインディングに関連付けられています。

注釈

データ ソースには、次のいずれかのクラスのインスタンスを指定できます。

文字列の作成の Binding 詳細については、 クラスを dataMember 参照してください。

コントロールの プロパティへのバインドを作成すると、バインドされたコントロールによって公開されるイベントが新しく Binding 検査され、2 つの特定のイベントにアタッチされます。

適用対象

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 値のいずれか 1 つ。

nullValue
Object

データ ソースの値が Object である場合に、バインドされたコントロール プロパティに適用される DBNull

formatString
String

値の表示方法を示す 1 つ以上の書式指定子文字。

例外

propertyName で指定されたプロパティがコントロールに存在しません。

- または -

指定されたデータ ソース/データ メンバーまたはコントロール プロパティは、コレクションの別のバインディングに関連付けられています。

注釈

データ ソースには、次のいずれかのクラスのインスタンスを指定できます。

文字列の作成の Binding 詳細については、 クラスを dataMember 参照してください。

コントロールの プロパティへのバインドを作成すると、バインドされたコントロールによって公開されるイベントが新しく Binding 検査され、2 つの特定のイベントにアタッチされます。

適用対象

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 値のいずれか 1 つ。

nullValue
Object

データ ソースの値が Object である場合に、バインドされたコントロール プロパティに適用される DBNull

formatString
String

値の表示方法を示す 1 つ以上の書式指定子文字。

formatInfo
IFormatProvider

既定の書式指定動作をオーバーライドする IFormatProvider の実装。

例外

propertyName で指定されたプロパティがコントロールに存在しません。

- または -

指定されたデータ ソース/データ メンバーまたはコントロール プロパティは、コレクションの別のバインディングに関連付けられています。

注釈

データ ソースには、次のいずれかのクラスのインスタンスを指定できます。

文字列の作成の Binding 詳細については、 クラスを dataMember 参照してください。

コントロールの プロパティへのバインドを作成すると、バインドされたコントロールによって公開されるイベントが新しく Binding 検査され、2 つの特定のイベントにアタッチされます。

適用対象