ControlBindingsCollection.Add Methode

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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

Name	Beschreibung
Add(Binding)	Fügt der Auflistung den angegebenen Binding Wert hinzu.
Add(String, Object, String)	Erstellt einen Binding using the specified control property name, data source, and data member, and adds it to the collection.
Add(String, Object, String, Boolean)	Erstellt eine Bindung mit dem namen der angegebenen Steuerelementeigenschaft, Datenquelle, Datenmememm und Informationen dazu, ob die Formatierung aktiviert ist, und fügt die Bindung zur Auflistung hinzu.
Add(String, Object, String, Boolean, DataSourceUpdateMode)	Erstellt eine Bindung, die die angegebene Steuerelementeigenschaft an das angegebene Datenmemm der angegebenen Datenquelle bindet, optional Formatierungen aktiviert, Werte basierend auf der angegebenen Aktualisierungseinstellung an die Datenquelle verteilt und die Bindung zur Auflistung hinzugefügt.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object)	Erstellt eine Bindung, die die angegebene Steuerelementeigenschaft an das angegebene Datenmemm der angegebenen Datenquelle bindet, optional die Formatierung aktivieren, Werte basierend auf der angegebenen Aktualisierungseinstellung an die Datenquelle weitergeben, die Eigenschaft auf den angegebenen Wert festlegen, wenn DBNull von der Datenquelle zurückgegeben wird, und die Bindung zur Auflistung hinzufügen.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)	Erstellt eine Bindung, die die angegebene Steuerelementeigenschaft an das angegebene Datenelement der angegebenen Datenquelle bindet, optional die Formatierung mit der angegebenen Formatzeichenfolge aktiviert, Werte basierend auf der angegebenen Aktualisierungseinstellung an die Datenquelle verteilt, die Eigenschaft auf den angegebenen Wert festgelegt wird, wenn DBNull sie von der Datenquelle zurückgegeben wird, und die Bindung zur Auflistung hinzufügen.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)	Erstellt eine Bindung, die die angegebene Steuerelementeigenschaft an das angegebene Datenmemm der angegebenen Datenquelle bindet, optional die Formatierung mit der angegebenen Formatzeichenfolge, die Weitergabe von Werten an die Datenquelle basierend auf der angegebenen Aktualisierungseinstellung, Festlegen der Eigenschaft auf den angegebenen Wert, wenn DBNull von der Datenquelle zurückgegeben wird, Festlegen des angegebenen Formatanbieters, und hinzufügen der Bindung zur Sammlung.

Add(Binding)

Quelle:: ControlBindingsCollection.cs

Quelle:: ControlBindingsCollection.cs

Quelle:: ControlBindingsCollection.cs

Quelle:: ControlBindingsCollection.cs

Quelle:: ControlBindingsCollection.cs

Fügt der Auflistung den angegebenen Binding Wert 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

binding: Binding

Der Binding hinzuzufügende

Ausnahmen

ArgumentNullException

Der binding Wert ist NULL.

ArgumentException

Die Steuerelementeigenschaft ist bereits datengebunden.

- oder -

Dies Binding gibt keine gültige Spalte der .DataSource

Beispiele

Im folgenden Codebeispiel wird eine Binding Instanz erstellt und die Add Methode verwendet, um der Instanz ControlBindingsCollection eines TextBox Steuerelements 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 der Binding durch diese Überladung der Add Methode erstellten Eigenschaft 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)

Quelle:: ControlBindingsCollection.cs

Quelle:: ControlBindingsCollection.cs

Quelle:: ControlBindingsCollection.cs

Quelle:: ControlBindingsCollection.cs

Quelle:: ControlBindingsCollection.cs

Erstellt einen Binding using the specified control property name, data source, and data member, and adds it to the collection.

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 zu bindenden Steuerelementeigenschaft.

dataSource: Object

Ein Object Wert, der die Datenquelle darstellt.

dataMember: String

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

Gibt zurück

Binding

Die neu erstellte Binding.

Ausnahmen

ArgumentNullException

binding ist null.

Exception

Dies propertyName ist bereits datengebunden.

- oder -

Das dataMember Element gibt kein gültiges Element der dataSource.

Beispiele

Im folgenden Codebeispiel wird die Add Methode verwendet, um dem ControlBindingsCollection TextBox Steuerelement drei Binding Objekte hinzuzufügen. Der ControlBindingsCollection Zugriff 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 der Binding durch diese Überladung der Add Methode erstellten Eigenschaft wird auf den Wert der DefaultDataSourceUpdateMode Eigenschaft festgelegt.

Das Hinzufügen eines Binding Ereignisses führt dazu, dass das CollectionChanged Ereignis auftritt.

Gilt für:

Add(String, Object, String, Boolean)

Quelle:: ControlBindingsCollection.cs

Quelle:: ControlBindingsCollection.cs

Quelle:: ControlBindingsCollection.cs

Quelle:: ControlBindingsCollection.cs

Quelle:: ControlBindingsCollection.cs

Erstellt eine Bindung mit dem namen der angegebenen Steuerelementeigenschaft, Datenquelle, Datenmememm und Informationen dazu, ob die Formatierung aktiviert ist, und fügt die Bindung zur Auflistung 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 zu bindenden Steuerelementeigenschaft.

dataSource: Object

Eine Object Darstellung der Datenquelle.

dataMember: String

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

formattingEnabled: Boolean

trueum die angezeigten Daten zu formatieren; andernfalls . false

Gibt zurück

Binding

Die neu erstellte Binding.

Ausnahmen

ArgumentException

Die angegebene propertyName Eigenschaft ist für das Steuerelement nicht vorhanden.

- oder -

Die angegebene Eigenschaft ist eine schreibgeschützte Eigenschaft.

Exception

Wenn die Formatierung deaktiviert ist und weder propertyName eine gültige Eigenschaft eines Steuerelements noch eine leere Zeichenfolge ("") ist.

Gilt für:

Add(String, Object, String, Boolean, DataSourceUpdateMode)

Quelle:: ControlBindingsCollection.cs

Quelle:: ControlBindingsCollection.cs

Quelle:: ControlBindingsCollection.cs

Quelle:: ControlBindingsCollection.cs

Quelle:: ControlBindingsCollection.cs

Erstellt eine Bindung, die die angegebene Steuerelementeigenschaft an das angegebene Datenmemm der angegebenen Datenquelle bindet, optional Formatierungen aktiviert, Werte basierend auf der angegebenen Aktualisierungseinstellung an die Datenquelle verteilt und die Bindung zur Auflistung hinzugefügt.

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 zu bindenden Steuerelementeigenschaft.

dataSource: Object

Eine Object Darstellung der Datenquelle.

dataMember: String

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

formattingEnabled: Boolean

trueum die angezeigten Daten zu formatieren; andernfalls . false

updateMode: DataSourceUpdateMode

Einer der DataSourceUpdateMode Werte.

Gibt zurück

Binding

Die neu erstellte Binding.

Ausnahmen

ArgumentException

Die angegebene propertyName Eigenschaft ist für das Steuerelement nicht vorhanden oder schreibgeschützt.

- oder -

Das angegebene Datenelement ist in der Datenquelle nicht vorhanden.

- oder -

Die angegebene Datenquellen-, Datenelement- oder Steuerelementeigenschaft ist 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)

Quelle:: ControlBindingsCollection.cs

Quelle:: ControlBindingsCollection.cs

Quelle:: ControlBindingsCollection.cs

Quelle:: ControlBindingsCollection.cs

Quelle:: ControlBindingsCollection.cs

Erstellt eine Bindung, die die angegebene Steuerelementeigenschaft an das angegebene Datenmemm der angegebenen Datenquelle bindet, optional die Formatierung aktivieren, Werte basierend auf der angegebenen Aktualisierungseinstellung an die Datenquelle weitergeben, die Eigenschaft auf den angegebenen Wert festlegen, wenn DBNull von der Datenquelle zurückgegeben wird, und die Bindung zur Auflistung hinzufügen.

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 zu bindenden Steuerelementeigenschaft.

dataSource: Object

Eine Object Darstellung der Datenquelle.

dataMember: String

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

formattingEnabled: Boolean

trueum 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.

Gibt zurück

Binding

Die neu erstellte Binding.

Ausnahmen

ArgumentException

Die angegebene propertyName Eigenschaft ist für das Steuerelement nicht vorhanden oder schreibgeschützt.

- oder -

Das angegebene Datenelement ist in der Datenquelle nicht vorhanden.

- oder -

Die angegebene Datenquellen-, Datenelement- oder Steuerelementeigenschaft ist 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)

Quelle:: ControlBindingsCollection.cs

Quelle:: ControlBindingsCollection.cs

Quelle:: ControlBindingsCollection.cs

Quelle:: ControlBindingsCollection.cs

Quelle:: ControlBindingsCollection.cs

Erstellt eine Bindung, die die angegebene Steuerelementeigenschaft an das angegebene Datenelement der angegebenen Datenquelle bindet, optional die Formatierung mit der angegebenen Formatzeichenfolge aktiviert, Werte basierend auf der angegebenen Aktualisierungseinstellung an die Datenquelle verteilt, die Eigenschaft auf den angegebenen Wert festgelegt wird, wenn DBNull sie von der Datenquelle zurückgegeben wird, und die Bindung zur Auflistung hinzufügen.

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 zu bindenden Steuerelementeigenschaft.

dataSource: Object

Eine Object Darstellung der Datenquelle.

dataMember: String

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

formattingEnabled: Boolean

trueum 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.

formatString: String

Mindestens ein Formatbezeichnerzeichen, das angibt, wie ein Wert angezeigt werden soll.

Gibt zurück

Binding

Die neu erstellte Binding.

Ausnahmen

ArgumentException

Die angegebene propertyName Eigenschaft ist für das Steuerelement nicht vorhanden oder schreibgeschützt.

- oder -

Das angegebene Datenelement ist in der Datenquelle nicht vorhanden.

- oder -

Die angegebene Datenquellen-, Datenelement- oder Steuerelementeigenschaft ist 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)

Quelle:: ControlBindingsCollection.cs

Quelle:: ControlBindingsCollection.cs

Quelle:: ControlBindingsCollection.cs

Quelle:: ControlBindingsCollection.cs

Quelle:: ControlBindingsCollection.cs

Erstellt eine Bindung, die die angegebene Steuerelementeigenschaft an das angegebene Datenmemm der angegebenen Datenquelle bindet, optional die Formatierung mit der angegebenen Formatzeichenfolge, die Weitergabe von Werten an die Datenquelle basierend auf der angegebenen Aktualisierungseinstellung, Festlegen der Eigenschaft auf den angegebenen Wert, wenn DBNull von der Datenquelle zurückgegeben wird, Festlegen des angegebenen Formatanbieters, und hinzufügen der Bindung zur Sammlung.

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 zu bindenden Steuerelementeigenschaft.

dataSource: Object

Eine Object Darstellung der Datenquelle.

dataMember: String

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

formattingEnabled: Boolean

trueum 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.

formatString: String

Mindestens ein Formatbezeichnerzeichen, das angibt, wie ein Wert angezeigt werden soll.

formatInfo: IFormatProvider

Eine Implementierung zum Außerkraftsetzen des IFormatProvider Standardformatierungsverhaltens.

Gibt zurück

Binding

Die neu erstellte Binding.

Ausnahmen

ArgumentException

Die angegebene propertyName Eigenschaft ist für das Steuerelement nicht vorhanden oder schreibgeschützt.

- oder -

Das angegebene Datenelement ist in der Datenquelle nicht vorhanden.

- oder -

Die angegebene Datenquellen-, Datenelement- oder Steuerelementeigenschaft ist einer anderen Bindung in der Auflistung zugeordnet.

Hinweise

Durch Aufrufen der Add Methode wird das CollectionChanged Ereignis ausgelöst.

Gilt für:

Feedback

War diese Seite hilfreich?

Freigeben über

ControlBindingsCollection.Add Methode

Definition

Überlädt

Add(Binding)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

Add(String, Object, String)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für:

Add(String, Object, String, Boolean)

Parameter

Gibt zurück

Ausnahmen

Gilt für:

Add(String, Object, String, Boolean, DataSourceUpdateMode)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Gilt für:

Add(String, Object, String, Boolean, DataSourceUpdateMode, Object)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Gilt für:

Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Gilt für:

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

Parameter

Gibt zurück

Ausnahmen

Hinweise

Gilt für:

Feedback