Binding コンストラクター
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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
バインドするコントロール プロパティの名前。
- dataMember
- String
バインド先のプロパティまたはリスト。
例外
propertyName
が、コントロールの有効なプロパティでも、空の文字列 ("") でもありません。
propertyName
で指定されたプロパティがコントロールに存在しません。
例
次のコード例では、 という名前myDataSet
の TextBox テーブル列にコントロールを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
注釈
データ ソースには、次のいずれかのクラスのインスタンスを指定できます。
インターフェイスを実装する IList クラス
任意のクラス
文字列の作成の Binding 詳細については、 クラスを dataMember
参照してください。
コントロールの プロパティへのバインドを作成すると、バインドされたコントロールによって公開されるイベントが新しく Binding 検査され、2 つの特定のイベントにアタッチされます。
PropertyName
Changed
という名前のイベント (例: 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
バインドするコントロール プロパティの名前。
- dataMember
- String
バインド先のプロパティまたはリスト。
- formattingEnabled
- Boolean
表示されるデータの書式を指定する場合は true
。それ以外の場合は false
。
例外
書式が無効である場合、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
バインドするコントロール プロパティの名前。
- dataMember
- String
バインド先のプロパティまたはリスト。
- formattingEnabled
- Boolean
表示されるデータの書式を指定する場合は true
。それ以外の場合は false
。
- dataSourceUpdateMode
- DataSourceUpdateMode
DataSourceUpdateMode 値のいずれか 1 つ。
例外
propertyName
で指定されたプロパティがコントロールに存在しません。
- または -
指定されたデータ ソース/データ メンバーまたはコントロール プロパティは、コレクションの別のバインディングに関連付けられています。
注釈
データ ソースには、次のいずれかのクラスのインスタンスを指定できます。
インターフェイスを実装する IList クラス
任意のクラス
文字列の作成の Binding 詳細については、 クラスを dataMember
参照してください。
コントロールの プロパティへのバインドを作成すると、バインドされたコントロールによって公開されるイベントが新しく Binding 検査され、2 つの特定のイベントにアタッチされます。
PropertyName
Changed
という名前のイベント (例: Control.BackColorChanged)
適用対象
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object)
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
バインドするコントロール プロパティの名前。
- dataMember
- String
バインド先のプロパティまたはリスト。
- formattingEnabled
- Boolean
表示されるデータの書式を指定する場合は true
。それ以外の場合は false
。
- dataSourceUpdateMode
- DataSourceUpdateMode
DataSourceUpdateMode 値のいずれか 1 つ。
例外
propertyName
で指定されたプロパティがコントロールに存在しません。
- または -
指定されたデータ ソース/データ メンバーまたはコントロール プロパティは、コレクションの別のバインディングに関連付けられています。
注釈
データ ソースには、次のいずれかのクラスのインスタンスを指定できます。
インターフェイスを実装する IList クラス
任意のクラス
文字列の作成の Binding 詳細については、 クラスを dataMember
参照してください。
コントロールの プロパティへのバインドを作成すると、バインドされたコントロールによって公開されるイベントが新しく Binding 検査され、2 つの特定のイベントにアタッチされます。
PropertyName
Changed
という名前のイベント (例: Control.BackColorChanged)
適用対象
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)
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
バインドするコントロール プロパティの名前。
- dataMember
- String
バインド先のプロパティまたはリスト。
- formattingEnabled
- Boolean
表示されるデータの書式を指定する場合は true
。それ以外の場合は false
。
- dataSourceUpdateMode
- DataSourceUpdateMode
DataSourceUpdateMode 値のいずれか 1 つ。
- formatString
- String
値の表示方法を示す 1 つ以上の書式指定子文字。
例外
propertyName
で指定されたプロパティがコントロールに存在しません。
- または -
指定されたデータ ソース/データ メンバーまたはコントロール プロパティは、コレクションの別のバインディングに関連付けられています。
注釈
データ ソースには、次のいずれかのクラスのインスタンスを指定できます。
インターフェイスを実装する IList クラス
任意のクラス
文字列の作成の Binding 詳細については、 クラスを dataMember
参照してください。
コントロールの プロパティへのバインドを作成すると、バインドされたコントロールによって公開されるイベントが新しく Binding 検査され、2 つの特定のイベントにアタッチされます。
PropertyName
Changed
という名前のイベント (例: Control.BackColorChanged)
適用対象
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)
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
バインドするコントロール プロパティの名前。
- dataMember
- String
バインド先のプロパティまたはリスト。
- formattingEnabled
- Boolean
表示されるデータの書式を指定する場合は true
。それ以外の場合は false
。
- dataSourceUpdateMode
- DataSourceUpdateMode
DataSourceUpdateMode 値のいずれか 1 つ。
- formatString
- String
値の表示方法を示す 1 つ以上の書式指定子文字。
- formatInfo
- IFormatProvider
既定の書式指定動作をオーバーライドする IFormatProvider の実装。
例外
propertyName
で指定されたプロパティがコントロールに存在しません。
- または -
指定されたデータ ソース/データ メンバーまたはコントロール プロパティは、コレクションの別のバインディングに関連付けられています。
注釈
データ ソースには、次のいずれかのクラスのインスタンスを指定できます。
インターフェイスを実装する IList クラス
任意のクラス
文字列の作成の Binding 詳細については、 クラスを dataMember
参照してください。
コントロールの プロパティへのバインドを作成すると、バインドされたコントロールによって公開されるイベントが新しく Binding 検査され、2 つの特定のイベントにアタッチされます。
PropertyName
Changed
という名前のイベント (例: Control.BackColorChanged)
適用対象
.NET