Teilen über


Binding Konstruktoren

Definition

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

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

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:

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:

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

Gilt für:

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

Die von propertyName angegebene Eigenschaft ist im Steuerelement nicht vorhanden.

- oder -

Die angegebene Eigenschaft ist schreibgeschützt.

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

Gilt für:

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

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:

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:

Gilt für:

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

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:

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:

Gilt für:

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

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:

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:

Gilt für:

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

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:

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:

Gilt für: