Binding Konstruktoren
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Initialisiert eine neue Instanz der Binding-Klasse.
Überlädt
| Name | Beschreibung |
|---|---|
| Binding(String, Object, String) |
Initialisiert eine neue Instanz der Binding Klasse, die die angegebene Steuerelementeigenschaft einfach an das angegebene Datenmemm der Datenquelle bindet. |
| Binding(String, Object, String, Boolean) |
Initialisiert eine neue Instanz der Binding Klasse, die die angegebene Steuerelementeigenschaft an das angegebene Datenelement der Datenquelle bindet, und ermöglicht optional die Anwendung der Formatierung. |
| Binding(String, Object, String, Boolean, DataSourceUpdateMode) |
Initialisiert eine neue Instanz der Binding Klasse, die die angegebene Steuerelementeigenschaft an das angegebene Datenelement der angegebenen Datenquelle bindet. Ermöglicht optional die Formatierung und Weitergabe von Werten an die Datenquelle basierend auf der angegebenen Updateeinstellung. |
| Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object) |
Initialisiert eine neue Instanz der Binding Klasse, die die angegebene Steuerelementeigenschaft an das angegebene Datenelement der angegebenen Datenquelle bindet. Ermöglicht optional die Formatierung, verteilt Werte basierend auf der angegebenen Updateeinstellung an die Datenquelle und legt die Eigenschaft auf den angegebenen Wert fest, wenn eine DBNull aus der Datenquelle zurückgegeben wird. |
| Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String) |
Initialisiert eine neue Instanz der Binding Klasse, die die angegebene Steuerelementeigenschaft an das angegebene Datenelement der angegebenen Datenquelle bindet. Ermöglicht optional die Formatierung mit der angegebenen Formatzeichenfolge; verteilt Werte basierend auf der angegebenen Updateeinstellung an die Datenquelle; und legt die Eigenschaft auf den angegebenen Wert fest, wenn eine DBNull von der Datenquelle zurückgegeben wird. |
| Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider) |
Initialisiert eine neue Instanz der Binding Klasse mit der angegebenen Steuerelementeigenschaft an das angegebene Datenmemm der angegebenen Datenquelle. Ermöglicht optional die Formatierung mit der angegebenen Formatzeichenfolge; verteilt Werte basierend auf der angegebenen Updateeinstellung an die Datenquelle; aktiviert die Formatierung mit der angegebenen Formatzeichenfolge; legt die Eigenschaft auf den angegebenen Wert fest, wenn eine DBNull von der Datenquelle zurückgegeben wird; und legt den angegebenen Formatanbieter fest. |
Binding(String, Object, String)
Initialisiert eine neue Instanz der Binding Klasse, die die angegebene Steuerelementeigenschaft einfach an das angegebene Datenmemm der Datenquelle bindet.
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.BindingPublic Sub New (propertyName As String, dataSource As Object, dataMember As String)Parameter
- propertyName
- String
Der Name der zu bindenden Steuerelementeigenschaft.
- dataMember
- String
Die Eigenschaft oder Liste, an die eine Bindung erfolgen soll.
Ausnahmen
propertyName ist weder eine gültige Eigenschaft eines Steuerelements noch eine leere Zeichenfolge ("").
Die angegebene propertyName Eigenschaft ist für das Steuerelement nicht vorhanden.
Beispiele
Im folgenden Codebeispiel wird ein TextBox Steuerelement an eine Tabellenspalte in einem DataSet benannten myDataSetObjekt gebunden. Das Beispiel erfordert, dass Sie im Deklarationsbereich 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 Instanz einer der folgenden Klassen für die Datenquelle angeben:
Jede Klasse, die die IList Schnittstelle implementiert
Beliebige Klasse
Weitere Informationen zum Erstellen der Zeichenfolge finden Sie in der BindingdataMember Klasse.
Wenn Sie eine Bindung an die Eigenschaft eines Steuerelements erstellen, prüft die neue Die Ereignisse Binding , die vom gebundenen Steuerelement verfügbar gemacht werden, und fügt sie zwei bestimmten Ereignissen zu:
Ein Ereignis namens PropertyName
Changed(z. B Control.BackColorChanged. )
Wenn Sie versuchen, eine Bindung an eine eigenschaft zu erstellen, die nicht vorhanden ist, wird eine ArgumentException ausgelöst, wenn die Binding Eigenschaft 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 das angegebene Datenelement der Datenquelle bindet, und ermöglicht optional die Anwendung der Formatierung.
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.BindingPublic Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean)Parameter
- propertyName
- String
Der Name der zu bindenden Steuerelementeigenschaft.
- dataMember
- String
Die Eigenschaft oder Liste, an die eine Bindung erfolgen soll.
- formattingEnabled
- Boolean
trueum die angezeigten Daten zu formatieren; andernfalls . false
Ausnahmen
Die angegebene propertyName Eigenschaft ist für das Steuerelement nicht vorhanden.
-oder-
Die angegebene Eigenschaft ist eine schreibgeschützte Eigenschaft.
Die Formatierung 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 das angegebene Datenelement der angegebenen Datenquelle bindet. Ermöglicht optional die Formatierung und Weitergabe von Werten an die Datenquelle basierend auf der angegebenen Updateeinstellung.
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.BindingPublic Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, dataSourceUpdateMode As DataSourceUpdateMode)Parameter
- propertyName
- String
Der Name der zu bindenden Steuerelementeigenschaft.
- dataMember
- String
Die Eigenschaft oder Liste, an die eine Bindung erfolgen soll.
- formattingEnabled
- Boolean
trueum die angezeigten Daten zu formatieren; andernfalls . false
- dataSourceUpdateMode
- DataSourceUpdateMode
Einer der DataSourceUpdateMode Werte.
Ausnahmen
Die angegebene propertyName Eigenschaft ist für das Steuerelement nicht vorhanden.
-oder-
Die angegebene Datenquellen- oder Datenelement- oder Steuerelementeigenschaft ist einer anderen Bindung in der Auflistung zugeordnet.
Hinweise
Sie können eine Instanz einer der folgenden Klassen für die Datenquelle angeben:
Jede Klasse, die die IList Schnittstelle implementiert
Beliebige Klasse
Weitere Informationen zum Erstellen der Zeichenfolge finden Sie in der BindingdataMember Klasse.
Wenn Sie eine Bindung an die Eigenschaft eines Steuerelements erstellen, prüft die neue Die Ereignisse Binding , die vom gebundenen Steuerelement verfügbar gemacht werden, und fügt sie zwei bestimmten Ereignissen zu:
Ein Ereignis namens PropertyName
Changed(z. B Control.BackColorChanged. )
Gilt für:
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object)
Initialisiert eine neue Instanz der Binding Klasse, die die angegebene Steuerelementeigenschaft an das angegebene Datenelement der angegebenen Datenquelle bindet. Ermöglicht optional die Formatierung, verteilt Werte basierend auf der angegebenen Updateeinstellung an die Datenquelle und legt die Eigenschaft auf den angegebenen Wert fest, wenn eine DBNull aus der Datenquelle 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.BindingPublic 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 zu bindenden Steuerelementeigenschaft.
- dataMember
- String
Die Eigenschaft oder Liste, an die eine Bindung erfolgen soll.
- formattingEnabled
- Boolean
trueum die angezeigten Daten zu formatieren; andernfalls . false
- dataSourceUpdateMode
- DataSourceUpdateMode
Einer der DataSourceUpdateMode Werte.
- nullValue
- Object
Der Object wert, der auf die gebundene Steuerelementeigenschaft angewendet werden soll, wenn der Datenquellenwert lautet DBNull.
Ausnahmen
Die angegebene propertyName Eigenschaft ist für das Steuerelement nicht vorhanden.
-oder-
Die angegebene Datenquellen- oder Datenelement- oder Steuerelementeigenschaft ist einer anderen Bindung in der Auflistung zugeordnet.
Hinweise
Sie können eine Instanz einer der folgenden Klassen für die Datenquelle angeben:
Jede Klasse, die die IList Schnittstelle implementiert
Beliebige Klasse
Weitere Informationen zum Erstellen der Zeichenfolge finden Sie in der BindingdataMember Klasse.
Wenn Sie eine Bindung an die Eigenschaft eines Steuerelements erstellen, prüft die neue Die Ereignisse Binding , die vom gebundenen Steuerelement verfügbar gemacht werden, und fügt sie zwei bestimmten Ereignissen zu:
Ein Ereignis namens PropertyName
Changed(z. B Control.BackColorChanged. )
Gilt für:
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)
Initialisiert eine neue Instanz der Binding Klasse, die die angegebene Steuerelementeigenschaft an das angegebene Datenelement der angegebenen Datenquelle bindet. Ermöglicht optional die Formatierung mit der angegebenen Formatzeichenfolge; verteilt Werte basierend auf der angegebenen Updateeinstellung an die Datenquelle; und legt die Eigenschaft auf den angegebenen Wert fest, wenn eine DBNull von der Datenquelle 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.BindingPublic 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 zu bindenden Steuerelementeigenschaft.
- dataMember
- String
Die Eigenschaft oder Liste, an die eine Bindung erfolgen soll.
- formattingEnabled
- Boolean
trueum die angezeigten Daten zu formatieren; andernfalls . false
- dataSourceUpdateMode
- DataSourceUpdateMode
Einer der DataSourceUpdateMode Werte.
- nullValue
- Object
Der Object wert, der auf die gebundene Steuerelementeigenschaft angewendet werden soll, wenn der Datenquellenwert lautet DBNull.
- formatString
- String
Mindestens ein Formatbezeichnerzeichen, das angibt, wie ein Wert angezeigt werden soll.
Ausnahmen
Die angegebene propertyName Eigenschaft ist für das Steuerelement nicht vorhanden.
-oder-
Die angegebene Datenquellen- oder Datenelement- oder Steuerelementeigenschaft ist einer anderen Bindung in der Auflistung zugeordnet.
Hinweise
Sie können eine Instanz einer der folgenden Klassen für die Datenquelle angeben:
Jede Klasse, die die IList Schnittstelle implementiert
Beliebige Klasse
Weitere Informationen zum Erstellen der Zeichenfolge finden Sie in der BindingdataMember Klasse.
Wenn Sie eine Bindung an die Eigenschaft eines Steuerelements erstellen, prüft die neue Die Ereignisse Binding , die vom gebundenen Steuerelement verfügbar gemacht werden, und fügt sie zwei bestimmten Ereignissen zu:
Ein Ereignis namens PropertyName
Changed(z. B Control.BackColorChanged. )
Gilt für:
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)
Initialisiert eine neue Instanz der Binding Klasse mit der angegebenen Steuerelementeigenschaft an das angegebene Datenmemm der angegebenen Datenquelle. Ermöglicht optional die Formatierung mit der angegebenen Formatzeichenfolge; verteilt Werte basierend auf der angegebenen Updateeinstellung an die Datenquelle; aktiviert die Formatierung mit der angegebenen Formatzeichenfolge; legt die Eigenschaft auf den angegebenen Wert fest, wenn eine DBNull von der Datenquelle 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.BindingPublic 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 zu bindenden Steuerelementeigenschaft.
- dataMember
- String
Die Eigenschaft oder Liste, an die eine Bindung erfolgen soll.
- formattingEnabled
- Boolean
trueum die angezeigten Daten zu formatieren; andernfalls . false
- dataSourceUpdateMode
- DataSourceUpdateMode
Einer der DataSourceUpdateMode Werte.
- nullValue
- Object
Der Object wert, der auf die gebundene Steuerelementeigenschaft angewendet werden soll, wenn der Datenquellenwert lautet DBNull.
- formatString
- String
Mindestens ein Formatbezeichnerzeichen, das angibt, wie ein Wert angezeigt werden soll.
- formatInfo
- IFormatProvider
Eine Implementierung zum Außerkraftsetzen des IFormatProvider Standardformatierungsverhaltens.
Ausnahmen
Die angegebene propertyName Eigenschaft ist für das Steuerelement nicht vorhanden.
-oder-
Die angegebene Datenquellen- oder Datenelement- oder Steuerelementeigenschaft ist einer anderen Bindung in der Auflistung zugeordnet.
Hinweise
Sie können eine Instanz einer der folgenden Klassen für die Datenquelle angeben:
Jede Klasse, die die IList Schnittstelle implementiert
Beliebige Klasse
Weitere Informationen zum Erstellen der Zeichenfolge finden Sie in der BindingdataMember Klasse.
Wenn Sie eine Bindung an die Eigenschaft eines Steuerelements erstellen, prüft die neue Die Ereignisse Binding , die vom gebundenen Steuerelement verfügbar gemacht werden, und fügt sie zwei bestimmten Ereignissen zu:
Ein Ereignis namens PropertyName
Changed(z. B Control.BackColorChanged. )