Binding Konstruktoren

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Initialisiert eine neue Instanz der Binding-Klasse.

Überlädt

Binding(String, Object, String)	Initialisiert eine neue Instanz der Binding-Klasse, die eine einfache Bindung der angegebenen Steuerelementeigenschaft an den angegebenen Datenmember der Datenquelle herstellt.
Binding(String, Object, String, Boolean)	Initialisiert eine neue Instanz der Binding-Klasse. die die angegebene Steuerelementeigenschaft an den angegebenen Datenmember der Datenquelle bindet und optional das Anwenden von Formatierung aktiviert.
Binding(String, Object, String, Boolean, DataSourceUpdateMode)	Initialisiert eine neue Instanz der Binding-Klasse. die die angegebene Steuerelementeigenschaft an den angegebenen Datenmember der angegebenen Datenquelle bindet. Aktiviert optional die Formatierung und gibt Werte entsprechend der angegebenen Aktualisierungseinstellung an die Datenquelle weiter.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object)	Initialisiert eine neue Instanz der Binding-Klasse. die die angegebene Steuerelementeigenschaft an den angegebenen Datenmember der angegebenen Datenquelle bindet. Aktiviert optional die Formatierung, gibt Werte entsprechend der angegebenen Aktualisierungseinstellung an die Datenquelle weiter und legt die Eigenschaft auf den angegebenen Wert fest, wenn von der Datenquelle ein DBNull zurückgegeben wird.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)	Initialisiert eine neue Instanz der Binding-Klasse. die die angegebene Steuerelementeigenschaft an den angegebenen Datenmember der angegebenen Datenquelle bindet. Aktiviert optional die Formatierung mit der angegebenen Formatzeichenfolge, gibt Werte entsprechend der angegebenen Aktualisierungseinstellung an die Datenquelle weiter und legt die Eigenschaft auf den angegebenen Wert fest, wenn von der Datenquelle ein DBNull zurückgegeben wird.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)	Initialisiert eine neue Instanz der Binding-Klassemit der angegebene Steuerelementeigenschaft für den angegebenen Datenmember der angegebenen Datenquelle. Aktiviert optional die Formatierung mit der angegebenen Formatzeichenfolge, gibt Werte entsprechend der angegebenen Aktualisierungseinstellung an die Datenquelle weiter, legt die Eigenschaft auf den angegebenen Wert fest, wenn von der Datenquelle ein DBNull zurückgegeben wird, und legt den angegebenen Formatanbieter fest.

Binding(String, Object, String)

Initialisiert eine neue Instanz der Binding-Klasse, die eine einfache Bindung der angegebenen Steuerelementeigenschaft an den angegebenen Datenmember der Datenquelle herstellt.

public:
 Binding(System::String ^ propertyName, System::Object ^ dataSource, System::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)

Parameter

propertyName

String

Der Name der Steuerelementeigenschaft für die Bindung.

dataSource

Object

Ein Object, das die Datenquelle darstellt.

dataMember

String

Die Eigenschaft oder Liste, an die die Bindung erfolgen soll.

Ausnahmen

Exception

propertyName ist weder eine gültige Eigenschaft eines Steuerelements noch eine leere Zeichenfolge ("").

ArgumentException

Die von propertyName angegebene Eigenschaft ist im Steuerelement nicht vorhanden.

Beispiele

Im folgenden Codebeispiel wird ein TextBox Steuerelement an eine Tabellenspalte in einem DataSet mit dem Namen myDataSetgebunden. Das Beispiel erfordert, dass Sie im Abschnitt Deklarationen des Moduls deklariert myDataSet haben.

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

Hinweise

Sie können eine instance einer der folgenden Klassen für die Datenquelle angeben:

• DataSet

• DataTable

• DataView

• DataViewManager

• BindingSource

• Jede Klasse, die die IList Schnittstelle implementiert

• Beliebige Klasse

Weitere Informationen zum Erstellen der Binding Zeichenfolge finden Sie in der dataMember -Klasse.

Wenn Sie eine Bindung an die -Eigenschaft eines Steuerelements erstellen, überprüft das neue Binding die Ereignisse, die vom gebundenen Steuerelement verfügbar gemacht werden, und fügt an zwei bestimmte Ereignisse an:

• Control.Validating

• Ein Ereignis mit dem Namen PropertyNameChanged (z. B. Control.BackColorChanged)

Wenn Sie versuchen, eine Bindung an eine eigenschaft zu binden, die nicht vorhanden ist, wird ein ArgumentException ausgelöst, wenn der Binding der Auflistung des Steuerelements Control.DataBindings hinzugefügt wird.

Weitere Informationen

• BindingsCollection
• CurrencyManager

Binding(String, Object, String, Boolean)

Initialisiert eine neue Instanz der Binding-Klasse. die die angegebene Steuerelementeigenschaft an den angegebenen Datenmember der Datenquelle bindet und optional das Anwenden von Formatierung aktiviert.

public:
 Binding(System::String ^ propertyName, System::Object ^ dataSource, System::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)

Parameter

propertyName

String

Der Name der Steuerelementeigenschaft für die Bindung.

dataSource

Object

Ein Object, das die Datenquelle darstellt.

dataMember

String

Die Eigenschaft oder Liste, an die die Bindung erfolgen soll.

formattingEnabled

Boolean

true, um die angezeigten Daten zu formatieren, andernfalls false.

Ausnahmen

ArgumentException

Die von propertyName angegebene Eigenschaft ist im Steuerelement nicht vorhanden.

- oder -

Die angegebene Eigenschaft ist schreibgeschützt.

Exception

Das Formatieren ist deaktiviert, und propertyName ist weder eine gültige Eigenschaft eines Steuerelements noch eine leere Zeichenfolge ("").

Binding(String, Object, String, Boolean, DataSourceUpdateMode)

Initialisiert eine neue Instanz der Binding-Klasse. die die angegebene Steuerelementeigenschaft an den angegebenen Datenmember der angegebenen Datenquelle bindet. Aktiviert optional die Formatierung und gibt Werte entsprechend der angegebenen Aktualisierungseinstellung an die Datenquelle weiter.

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);

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)

Parameter

propertyName

String

Der Name der Steuerelementeigenschaft für die Bindung.

dataSource

Object

Ein Object, das die Datenquelle darstellt.

dataMember

String

Die Eigenschaft oder Liste, an die die Bindung erfolgen soll.

formattingEnabled

Boolean

true, um die angezeigten Daten zu formatieren, andernfalls false.

dataSourceUpdateMode

DataSourceUpdateMode

Einer der DataSourceUpdateMode-Werte.

Ausnahmen

ArgumentException

Die von propertyName angegebene Eigenschaft ist im Steuerelement nicht vorhanden.

- oder -

Die angegebene Datenquelle, der angegebene Datenmember oder die angegebene Steuerelementeigenschaft sind einer anderen Bindung in der Auflistung zugeordnet.

Hinweise

Sie können eine instance einer der folgenden Klassen für die Datenquelle angeben:

• DataSet

• DataTable

• DataView

• DataViewManager

• BindingSource

• Jede Klasse, die die IList Schnittstelle implementiert

• Beliebige Klasse

Weitere Informationen zum Erstellen der Binding Zeichenfolge finden Sie in der dataMember -Klasse.

Wenn Sie eine Bindung an die -Eigenschaft eines Steuerelements erstellen, überprüft das neue Binding die Ereignisse, die vom gebundenen Steuerelement verfügbar gemacht werden, und fügt an zwei bestimmte Ereignisse an:

• Control.Validating.

• Ein Ereignis mit dem Namen PropertyNameChanged (z. B. Control.BackColorChanged)

Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object)

Initialisiert eine neue Instanz der Binding-Klasse. die die angegebene Steuerelementeigenschaft an den angegebenen Datenmember der angegebenen Datenquelle bindet. Aktiviert optional die Formatierung, gibt Werte entsprechend der angegebenen Aktualisierungseinstellung an die Datenquelle weiter und legt die Eigenschaft auf den angegebenen Wert fest, wenn von der Datenquelle ein DBNull zurückgegeben wird.

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);

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)

Parameter

propertyName

String

Der Name der Steuerelementeigenschaft für die Bindung.

dataSource

Object

Ein Object, das die Datenquelle darstellt.

dataMember

String

Die Eigenschaft oder Liste, an die die Bindung erfolgen soll.

formattingEnabled

Boolean

true, um die angezeigten Daten zu formatieren, andernfalls false.

dataSourceUpdateMode

DataSourceUpdateMode

Einer der DataSourceUpdateMode-Werte.

nullValue

Object

Das Object, das auf die gebundene Steuerelementeigenschaft angewendet werden soll, wenn der Wert der Datenquelle DBNull ist.

Ausnahmen

ArgumentException

Die von propertyName angegebene Eigenschaft ist im Steuerelement nicht vorhanden.

- oder -

Die angegebene Datenquelle, der angegebene Datenmember oder die angegebene Steuerelementeigenschaft sind einer anderen Bindung in der Auflistung zugeordnet.

Hinweise

Sie können eine instance einer der folgenden Klassen für die Datenquelle angeben:

• DataSet

• DataTable

• DataView

• DataViewManager

• BindingSource

• Jede Klasse, die die IList Schnittstelle implementiert

• Beliebige Klasse

Weitere Informationen zum Erstellen der Binding Zeichenfolge finden Sie in der dataMember -Klasse.

Wenn Sie eine Bindung an die -Eigenschaft eines Steuerelements erstellen, überprüft das neue Binding die Ereignisse, die vom gebundenen Steuerelement verfügbar gemacht werden, und fügt an zwei bestimmte Ereignisse an:

• Control.Validating

• Ein Ereignis mit dem Namen PropertyNameChanged (z. B. Control.BackColorChanged)

Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)

Initialisiert eine neue Instanz der Binding-Klasse. die die angegebene Steuerelementeigenschaft an den angegebenen Datenmember der angegebenen Datenquelle bindet. Aktiviert optional die Formatierung mit der angegebenen Formatzeichenfolge, gibt Werte entsprechend der angegebenen Aktualisierungseinstellung an die Datenquelle weiter und legt die Eigenschaft auf den angegebenen Wert fest, wenn von der Datenquelle ein DBNull zurückgegeben wird.

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);

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)

Parameter

propertyName

String

Der Name der Steuerelementeigenschaft für die Bindung.

dataSource

Object

Ein Object, das die Datenquelle darstellt.

dataMember

String

Die Eigenschaft oder Liste, an die die Bindung erfolgen soll.

formattingEnabled

Boolean

true, um die angezeigten Daten zu formatieren, andernfalls false.

dataSourceUpdateMode

DataSourceUpdateMode

Einer der DataSourceUpdateMode-Werte.

nullValue

Object

Das Object, das auf die gebundene Steuerelementeigenschaft angewendet werden soll, wenn der Wert der Datenquelle DBNull ist.

formatString

String

Ein oder mehrere Formatbezeichnerzeichen, die angeben, wie ein Wert angezeigt werden soll.

Ausnahmen

ArgumentException

Die von propertyName angegebene Eigenschaft ist im Steuerelement nicht vorhanden.

- oder -

Die angegebene Datenquelle, der angegebene Datenmember oder die angegebene Steuerelementeigenschaft sind einer anderen Bindung in der Auflistung zugeordnet.

Hinweise

Sie können eine instance einer der folgenden Klassen für die Datenquelle angeben:

• DataSet

• DataTable

• DataView

• DataViewManager

• BindingSource

• Jede Klasse, die die IList Schnittstelle implementiert

• Beliebige Klasse

Weitere Informationen zum Erstellen der Binding Zeichenfolge finden Sie in der dataMember -Klasse.

Wenn Sie eine Bindung an die -Eigenschaft eines Steuerelements erstellen, überprüft das neue Binding die Ereignisse, die vom gebundenen Steuerelement verfügbar gemacht werden, und fügt an zwei bestimmte Ereignisse an:

• Control.Validating

• Ein Ereignis mit dem Namen PropertyNameChanged (z. B. Control.BackColorChanged)

Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)

Initialisiert eine neue Instanz der Binding-Klassemit der angegebene Steuerelementeigenschaft für den angegebenen Datenmember der angegebenen Datenquelle. Aktiviert optional die Formatierung mit der angegebenen Formatzeichenfolge, gibt Werte entsprechend der angegebenen Aktualisierungseinstellung an die Datenquelle weiter, legt die Eigenschaft auf den angegebenen Wert fest, wenn von der Datenquelle ein DBNull zurückgegeben wird, und legt den angegebenen Formatanbieter fest.

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);

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)

Parameter

propertyName

String

Der Name der Steuerelementeigenschaft für die Bindung.

dataSource

Object

Ein Object, das die Datenquelle darstellt.

dataMember

String

Die Eigenschaft oder Liste, an die die Bindung erfolgen soll.

formattingEnabled

Boolean

true, um die angezeigten Daten zu formatieren, andernfalls false.

dataSourceUpdateMode

DataSourceUpdateMode

Einer der DataSourceUpdateMode-Werte.

nullValue

Object

Das Object, das auf die gebundene Steuerelementeigenschaft angewendet werden soll, wenn der Wert der Datenquelle DBNull ist.

formatString

String

Ein oder mehrere Formatbezeichnerzeichen, die angeben, wie ein Wert angezeigt werden soll.

formatInfo

IFormatProvider

Eine Implementierung von IFormatProvider zum Überschreiben des Standardverhaltens.

Ausnahmen

ArgumentException

Die von propertyName angegebene Eigenschaft ist im Steuerelement nicht vorhanden.

- oder -

Die angegebene Datenquelle, der angegebene Datenmember oder die angegebene Steuerelementeigenschaft sind einer anderen Bindung in der Auflistung zugeordnet.

Hinweise

Sie können eine instance einer der folgenden Klassen für die Datenquelle angeben:

• DataSet

• DataTable

• DataView

• DataViewManager

• BindingSource

• Jede Klasse, die die IList -Schnittstelle implementiert

• Beliebige Klasse

Weitere Informationen zum Erstellen der Binding Zeichenfolge finden Sie in der dataMember -Klasse.

Wenn Sie eine Bindung an die -Eigenschaft eines Steuerelements erstellen, überprüft das neue Binding die Ereignisse, die vom gebundenen Steuerelement verfügbar gemacht werden, und fügt zwei bestimmte Ereignisse an:

• Control.Validating

• Ein Ereignis namens PropertyNameChanged (z. B. Control.BackColorChanged)