ControlBindingsCollection.Add Methode
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.
Fügt der Auflistung eine Binding hinzu.
Überlädt
Add(Binding) |
Fügt der Auflistung den angegebenen Binding hinzu. |
Add(String, Object, String) |
Erstellt anhand des angegebenen Namens der Steuerelementeigenschaft, der angegebenen Datenquelle und des angegebenen Datenmembers ein Binding und fügt dieses der Auflistung hinzu. |
Add(String, Object, String, Boolean) |
Erstellt eine Bindung mit dem angegebenen Steuerelement-Eigenschaftennamen, der angegebenen Datenquelle, dem angegebenen Datenmember und den angegebenen Informationen dazu, ob die Formatierung aktiviert ist, und fügt der Auflistung diese Bindung hinzu. |
Add(String, Object, String, Boolean, DataSourceUpdateMode) |
Erstellt eine Bindung, die die angegebene Steuerelementeigenschaft an den angegebenen Datenmember der angegebenen Datenquelle bindet, wodurch optional die Formatierung aktiviert wird, Werte basierend auf der angegebenen Aktualisierungseinstellung an die Datenquelle weitergegeben werden und der Auflistung die Bindung hinzugefügt wird. |
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object) |
Erstellt eine Bindung, die die angegebene Steuerelementeigenschaft an den angegebenen Datenmember der angegebenen Datenquelle bindet, wodurch optional die Formatierung aktiviert wird, Werte basierend auf der angegebenen Aktualisierungseinstellung an die Datenquelle weitergegeben werden, die Eigenschaft auf den angegebenen Wert festgelegt wird, wenn DBNull aus der Datenquelle zurückgegeben wird und der Auflistung die Bindung hinzugefügt wird. |
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String) |
Erstellt eine Bindung, die die angegebene Steuerelementeigenschaft an den angegebenen Datenmember der angegebenen Datenquelle bindet, wodurch optional die Formatierung mit der angegebenen Formatzeichenfolge aktiviert wird, Werte basierend auf der angegebenen Aktualisierungseinstellung an die Datenquelle weitergegeben werden, die Eigenschaft auf den angegebenen Wert festgelegt wird, wenn DBNull aus der Datenquelle zurückgegeben wird und der Auflistung die Bindung hinzugefügt wird. |
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider) |
Erstellt eine Bindung, die die angegebene Steuerelementeigenschaft an den angegebenen Datenmember der angegebenen Datenquelle bindet, wodurch optional die Formatierung mit der angegebenen Formatzeichenfolge aktiviert wird, Werte basierend auf der angegebenen Aktualisierungseinstellung an die Datenquelle weitergegeben werden, die Eigenschaft auf den angegebenen Wert festgelegt wird, wenn DBNull aus der Datenquelle zurückgegeben wird, der angegebene Formatanbieter festgelegt wird und der Auflistung die Bindung hinzugefügt wird. |
Add(Binding)
Fügt der Auflistung den angegebenen Binding hinzu.
public:
void Add(System::Windows::Forms::Binding ^ binding);
public void Add (System.Windows.Forms.Binding binding);
override this.Add : System.Windows.Forms.Binding -> unit
Public Sub Add (binding As Binding)
Parameter
Ausnahmen
Die binding
ist NULL.
Die Steuerelementeigenschaft ist bereits datengebunden.
- oder -
Das Binding gibt keine gültige Spalte von DataSource an.
Beispiele
Im folgenden Codebeispiel wird eine Binding instance erstellt und die Add -Methode verwendet, um die instance ControlBindingsCollection zu einem TextBox Steuerelement hinzuzufügen.
protected:
void BindControls()
{
/* Create a new Binding using the DataSet and a
navigation path(TableName.RelationName.ColumnName).
Add event delegates for the Parse and Format events to
the Binding object, and add the object to the third
TextBox control's BindingsCollection. The delegates
must be added before adding the Binding to the
collection; otherwise, no formatting occurs until
the Current object of the BindingManagerBase for
the data source changes. */
Binding^ b = gcnew Binding(
"Text",ds,"customers.custToOrders.OrderAmount" );
b->Parse += gcnew ConvertEventHandler(
this, &Form1::CurrencyStringToDecimal );
b->Format += gcnew ConvertEventHandler(
this, &Form1::DecimalToCurrencyString );
textBox1->DataBindings->Add( b );
}
protected void BindControls()
{
/* Create a new Binding using the DataSet and a
navigation path(TableName.RelationName.ColumnName).
Add event delegates for the Parse and Format events to
the Binding object, and add the object to the third
TextBox control's BindingsCollection. The delegates
must be added before adding the Binding to the
collection; otherwise, no formatting occurs until
the Current object of the BindingManagerBase for
the data source changes. */
Binding b = new Binding
("Text", ds, "customers.custToOrders.OrderAmount");
b.Parse+=new ConvertEventHandler(CurrencyStringToDecimal);
b.Format+=new ConvertEventHandler(DecimalToCurrencyString);
textBox1.DataBindings.Add(b);
}
Protected Sub BindControls()
' Create a new Binding using the DataSet and a
' navigation path(TableName.RelationName.ColumnName).
' Add event delegates for the Parse and Format events to
' the Binding object, and add the object to the third
' TextBox control's BindingsCollection. The delegates
' must be added before adding the Binding to the
' collection; otherwise, no formatting occurs until
' the Current object of the BindingManagerBase for
' the data source changes.
Dim b As New Binding("Text", ds, "customers.custToOrders.OrderAmount")
AddHandler b.Parse, AddressOf CurrencyStringToDecimal
AddHandler b.Format, AddressOf DecimalToCurrencyString
textBox1.DataBindings.Add(b)
End Sub
Hinweise
Die DataSourceUpdateMode -Eigenschaft des , die Binding von dieser Überladung der Add -Methode erstellt wurde, wird auf den Wert der DefaultDataSourceUpdateMode -Eigenschaft festgelegt.
Das CollectionChanged Ereignis tritt auf, wenn die Änderung abgeschlossen ist.
Gilt für:
Add(String, Object, String)
Erstellt anhand des angegebenen Namens der Steuerelementeigenschaft, der angegebenen Datenquelle und des angegebenen Datenmembers ein Binding und fügt dieses der Auflistung hinzu.
public:
System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string dataMember);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string? dataMember);
override this.Add : string * obj * string -> System.Windows.Forms.Binding
Public Function Add (propertyName As String, dataSource As Object, dataMember As String) As Binding
Parameter
- propertyName
- String
Der Name der Steuerelementeigenschaft für die Bindung.
- dataMember
- String
Die Eigenschaft oder Liste, an die die Bindung erfolgen soll.
Gibt zurück
Der neu erstellte Binding.
Ausnahmen
binding
ist null
.
Der propertyName
ist bereits datengebunden.
- oder -
Der dataMember
gibt keinen gültigen Member der dataSource
an.
Beispiele
Im folgenden Codebeispiel wird die Add -Methode verwendet, um dem eines TextBox -Steuerelements drei Binding -Objekte ControlBindingsCollection hinzuzufügen. Der Zugriff auf die ControlBindingsCollection erfolgt über die DataBindings-Eigenschaft der Control-Klasse.
private:
void BindTextBoxProperties()
{
// Clear the collection before adding new Binding objects.
textBox1->DataBindings->Clear();
// Create a DataTable containing Color objects.
DataTable^ t = MakeTable();
/* Bind the Text, BackColor, and ForeColor properties
to columns in the DataTable. */
textBox1->DataBindings->Add( "Text", t, "Text" );
textBox1->DataBindings->Add( "BackColor", t, "BackColor" );
textBox1->DataBindings->Add( "ForeColor", t, "ForeColor" );
}
DataTable^ MakeTable()
{
/* Create a DataTable with three columns.
Two of the columns contain Color objects. */
DataTable^ t = gcnew DataTable( "Control" );
t->Columns->Add( "BackColor", Color::typeid );
t->Columns->Add( "ForeColor", Color::typeid );
t->Columns->Add( "Text" );
// Add three rows to the table.
DataRow^ r;
r = t->NewRow();
r[ "BackColor" ] = Color::Blue;
r[ "ForeColor" ] = Color::Yellow;
r[ "Text" ] = "Yellow on Blue";
t->Rows->Add( r );
r = t->NewRow();
r[ "BackColor" ] = Color::White;
r[ "ForeColor" ] = Color::Green;
r[ "Text" ] = "Green on white";
t->Rows->Add( r );
r = t->NewRow();
r[ "BackColor" ] = Color::Orange;
r[ "ForeColor" ] = Color::Black;
r[ "Text" ] = "Black on Orange";
t->Rows->Add( r );
return t;
}
private void BindTextBoxProperties()
{
// Clear the collection before adding new Binding objects.
textBox1.DataBindings.Clear();
// Create a DataTable containing Color objects.
DataTable t = MakeTable();
/* Bind the Text, BackColor, and ForeColor properties
to columns in the DataTable. */
textBox1.DataBindings.Add("Text", t, "Text");
textBox1.DataBindings.Add("BackColor", t, "BackColor");
textBox1.DataBindings.Add("ForeColor", t, "ForeColor");
}
private DataTable MakeTable()
{
/* Create a DataTable with three columns.
Two of the columns contain Color objects. */
DataTable t = new DataTable("Control");
t.Columns.Add("BackColor", typeof(Color));
t.Columns.Add("ForeColor", typeof(Color));
t.Columns.Add("Text");
// Add three rows to the table.
DataRow r;
r = t.NewRow();
r["BackColor"] = Color.Blue;
r["ForeColor"] = Color.Yellow;
r["Text"] = "Yellow on Blue";
t.Rows.Add(r);
r = t.NewRow();
r["BackColor"] = Color.White;
r["ForeColor"] = Color.Green;
r["Text"] = "Green on white";
t.Rows.Add(r);
r = t.NewRow();
r["BackColor"] = Color.Orange;
r["ForeColor"] = Color.Black;
r["Text"] = "Black on Orange";
t.Rows.Add(r);
return t;
}
Private Sub BindTextBoxProperties()
' Clear the collection before adding new Binding objects.
textBox1.DataBindings.Clear()
' Create a DataTable containing Color objects.
Dim t As DataTable = MakeTable()
' Bind the Text, BackColor, and ForeColor properties
' to columns in the DataTable.
textBox1.DataBindings.Add("Text", t, "Text")
textBox1.DataBindings.Add("BackColor", t, "BackColor")
textBox1.DataBindings.Add("ForeColor", t, "ForeColor")
End Sub
Private Function MakeTable() As DataTable
' Create a DataTable with three columns.
' Two of the columns contain Color objects.
Dim t As New DataTable("Control")
t.Columns.Add("BackColor", GetType(Color))
t.Columns.Add("ForeColor", GetType(Color))
t.Columns.Add("Text")
' Add three rows to the table.
Dim r As DataRow
r = t.NewRow()
r("BackColor") = Color.Blue
r("ForeColor") = Color.Yellow
r("Text") = "Yellow on Blue"
t.Rows.Add(r)
r = t.NewRow()
r("BackColor") = Color.White
r("ForeColor") = Color.Green
r("Text") = "Green on white"
t.Rows.Add(r)
r = t.NewRow()
r("BackColor") = Color.Orange
r("ForeColor") = Color.Black
r("Text") = "Black on Orange"
t.Rows.Add(r)
Return t
End Function
Hinweise
Die DataSourceUpdateMode -Eigenschaft des , die Binding von dieser Überladung der Add -Methode erstellt wurde, wird auf den Wert der DefaultDataSourceUpdateMode -Eigenschaft festgelegt.
Wenn Sie ein hinzufügen Binding , tritt das CollectionChanged Ereignis auf.
Gilt für:
Add(String, Object, String, Boolean)
Erstellt eine Bindung mit dem angegebenen Steuerelement-Eigenschaftennamen, der angegebenen Datenquelle, dem angegebenen Datenmember und den angegebenen Informationen dazu, ob die Formatierung aktiviert ist, und fügt der Auflistung diese Bindung hinzu.
public:
System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string dataMember, bool formattingEnabled);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string? dataMember, bool formattingEnabled);
override this.Add : string * obj * string * bool -> System.Windows.Forms.Binding
Public Function Add (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean) As Binding
Parameter
- propertyName
- String
Der Name der Steuerelementeigenschaft für die Bindung.
- dataMember
- String
Die Eigenschaft oder Liste, an die die Bindung erfolgen soll.
- formattingEnabled
- Boolean
true
, um die angezeigten Daten zu formatieren, andernfalls false
.
Gibt zurück
Der neu erstellte Binding.
Ausnahmen
Die von propertyName
angegebene Eigenschaft ist im Steuerelement nicht vorhanden.
- oder -
Die angegebene Eigenschaft ist schreibgeschützt.
Wenn die Formatierung deaktiviert ist und propertyName
weder eine gültige Eigenschaft eines Steuerelements noch eine leere Zeichenfolge ("") ist.
Gilt für:
Add(String, Object, String, Boolean, DataSourceUpdateMode)
Erstellt eine Bindung, die die angegebene Steuerelementeigenschaft an den angegebenen Datenmember der angegebenen Datenquelle bindet, wodurch optional die Formatierung aktiviert wird, Werte basierend auf der angegebenen Aktualisierungseinstellung an die Datenquelle weitergegeben werden und der Auflistung die Bindung hinzugefügt wird.
public:
System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode updateMode);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode);
override this.Add : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode -> System.Windows.Forms.Binding
Public Function Add (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, updateMode As DataSourceUpdateMode) As Binding
Parameter
- propertyName
- String
Der Name der Steuerelementeigenschaft für die Bindung.
- dataMember
- String
Die Eigenschaft oder Liste, an die die Bindung erfolgen soll.
- formattingEnabled
- Boolean
true
, um die angezeigten Daten zu formatieren, andernfalls false
.
- updateMode
- DataSourceUpdateMode
Einer der DataSourceUpdateMode-Werte.
Gibt zurück
Der neu erstellte Binding.
Ausnahmen
Die von propertyName
angegebene Eigenschaft ist im Steuerelement nicht vorhanden oder ist schreibgeschützt.
- oder -
Der angegebene Datenmember ist in der Datenquelle nicht vorhanden.
- oder -
Die angegebene Datenquelle, der angegebene Datenmember oder die angegebene Steuerelementeigenschaft sind einer anderen Bindung in der Auflistung zugeordnet.
Hinweise
Durch Aufrufen der Add -Methode wird das CollectionChanged -Ereignis ausgelöst.
Gilt für:
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object)
Erstellt eine Bindung, die die angegebene Steuerelementeigenschaft an den angegebenen Datenmember der angegebenen Datenquelle bindet, wodurch optional die Formatierung aktiviert wird, Werte basierend auf der angegebenen Aktualisierungseinstellung an die Datenquelle weitergegeben werden, die Eigenschaft auf den angegebenen Wert festgelegt wird, wenn DBNull aus der Datenquelle zurückgegeben wird und der Auflistung die Bindung hinzugefügt wird.
public:
System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode updateMode, System::Object ^ nullValue);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object nullValue);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object? nullValue);
override this.Add : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj -> System.Windows.Forms.Binding
Public Function Add (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, updateMode As DataSourceUpdateMode, nullValue As Object) As Binding
Parameter
- propertyName
- String
Der Name der Steuerelementeigenschaft für die Bindung.
- dataMember
- String
Die Eigenschaft oder Liste, an die die Bindung erfolgen soll.
- formattingEnabled
- Boolean
true
, um die angezeigten Daten zu formatieren, andernfalls false
.
- updateMode
- DataSourceUpdateMode
Einer der DataSourceUpdateMode-Werte.
- nullValue
- Object
Wenn die Datenquelle diesen Wert aufweist, wird die gebundene Eigenschaft auf DBNull festgelegt.
Gibt zurück
Der neu erstellte Binding.
Ausnahmen
Die von propertyName
angegebene Eigenschaft ist im Steuerelement nicht vorhanden oder ist schreibgeschützt.
- oder -
Der angegebene Datenmember ist in der Datenquelle nicht vorhanden.
- oder -
Die angegebene Datenquelle, der angegebene Datenmember oder die angegebene Steuerelementeigenschaft sind einer anderen Bindung in der Auflistung zugeordnet.
Hinweise
Durch Aufrufen der Add -Methode wird das CollectionChanged -Ereignis ausgelöst.
Gilt für:
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)
Erstellt eine Bindung, die die angegebene Steuerelementeigenschaft an den angegebenen Datenmember der angegebenen Datenquelle bindet, wodurch optional die Formatierung mit der angegebenen Formatzeichenfolge aktiviert wird, Werte basierend auf der angegebenen Aktualisierungseinstellung an die Datenquelle weitergegeben werden, die Eigenschaft auf den angegebenen Wert festgelegt wird, wenn DBNull aus der Datenquelle zurückgegeben wird und der Auflistung die Bindung hinzugefügt wird.
public:
System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode updateMode, System::Object ^ nullValue, System::String ^ formatString);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object nullValue, string formatString);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object? nullValue, string formatString);
override this.Add : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj * string -> System.Windows.Forms.Binding
Public Function Add (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, updateMode As DataSourceUpdateMode, nullValue As Object, formatString As String) As Binding
Parameter
- propertyName
- String
Der Name der Steuerelementeigenschaft für die Bindung.
- dataMember
- String
Die Eigenschaft oder Liste, an die die Bindung erfolgen soll.
- formattingEnabled
- Boolean
true
, um die angezeigten Daten zu formatieren, andernfalls false
.
- updateMode
- DataSourceUpdateMode
Einer der DataSourceUpdateMode-Werte.
- nullValue
- Object
Wenn die Datenquelle diesen Wert aufweist, wird die gebundene Eigenschaft auf DBNull festgelegt.
- formatString
- String
Ein oder mehrere Formatbezeichnerzeichen, die angeben, wie ein Wert angezeigt werden soll.
Gibt zurück
Der neu erstellte Binding.
Ausnahmen
Die von propertyName
angegebene Eigenschaft ist im Steuerelement nicht vorhanden oder ist schreibgeschützt.
- oder -
Der angegebene Datenmember ist in der Datenquelle nicht vorhanden.
- oder -
Die angegebene Datenquelle, der angegebene Datenmember oder die angegebene Steuerelementeigenschaft sind einer anderen Bindung in der Auflistung zugeordnet.
Hinweise
Durch Aufrufen der Add -Methode wird das CollectionChanged -Ereignis ausgelöst.
Gilt für:
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)
Erstellt eine Bindung, die die angegebene Steuerelementeigenschaft an den angegebenen Datenmember der angegebenen Datenquelle bindet, wodurch optional die Formatierung mit der angegebenen Formatzeichenfolge aktiviert wird, Werte basierend auf der angegebenen Aktualisierungseinstellung an die Datenquelle weitergegeben werden, die Eigenschaft auf den angegebenen Wert festgelegt wird, wenn DBNull aus der Datenquelle zurückgegeben wird, der angegebene Formatanbieter festgelegt wird und der Auflistung die Bindung hinzugefügt wird.
public:
System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode updateMode, System::Object ^ nullValue, System::String ^ formatString, IFormatProvider ^ formatInfo);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object nullValue, string formatString, IFormatProvider formatInfo);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object? nullValue, string formatString, IFormatProvider? formatInfo);
override this.Add : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj * string * IFormatProvider -> System.Windows.Forms.Binding
Public Function Add (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, updateMode As DataSourceUpdateMode, nullValue As Object, formatString As String, formatInfo As IFormatProvider) As Binding
Parameter
- propertyName
- String
Der Name der Steuerelementeigenschaft für die Bindung.
- dataMember
- String
Die Eigenschaft oder Liste, an die die Bindung erfolgen soll.
- formattingEnabled
- Boolean
true
, um die angezeigten Daten zu formatieren, andernfalls false
.
- updateMode
- DataSourceUpdateMode
Einer der DataSourceUpdateMode-Werte.
- nullValue
- Object
Wenn die Datenquelle diesen Wert aufweist, wird die gebundene Eigenschaft auf DBNull festgelegt.
- formatString
- String
Ein oder mehrere Formatbezeichnerzeichen, die angeben, wie ein Wert angezeigt werden soll.
- formatInfo
- IFormatProvider
Eine Implementierung von IFormatProvider zum Überschreiben des Standardverhaltens.
Gibt zurück
Der neu erstellte Binding.
Ausnahmen
Die von propertyName
angegebene Eigenschaft ist im Steuerelement nicht vorhanden oder ist schreibgeschützt.
- oder -
Der angegebene Datenmember ist in der Datenquelle nicht vorhanden.
- oder -
Die angegebene Datenquelle, der angegebene Datenmember oder die angegebene Steuerelementeigenschaft sind einer anderen Bindung in der Auflistung zugeordnet.
Hinweise
Durch Aufrufen der Add -Methode wird das CollectionChanged -Ereignis ausgelöst.