ControlBindingsCollection.Add Methode

Definitie

Naamruimte:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Voegt een Binding aan de verzameling toe.

Overloads

Name	Description
Add(Binding)	Voegt de opgegeven Binding waarde toe aan de verzameling.
Add(String, Object, String)	Hiermee maakt u een Binding met behulp van de opgegeven naam van de besturingselementeigenschap, gegevensbron en gegevenslid en voegt u deze toe aan de verzameling.
Add(String, Object, String, Boolean)	Hiermee maakt u een binding met de opgegeven naam van de besturingselementeigenschap, gegevensbron, gegevensbron, gegevenslid en informatie over of opmaak is ingeschakeld en voegt u de binding toe aan de verzameling.
Add(String, Object, String, Boolean, DataSourceUpdateMode)	Hiermee maakt u een binding die de opgegeven besturingselementeigenschap koppelt aan het opgegeven gegevenslid van de opgegeven gegevensbron, optioneel opmaak inschakelt, waarden doorgeeft aan de gegevensbron op basis van de opgegeven update-instelling en de binding toevoegt aan de verzameling.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object)	Hiermee maakt u een binding die de opgegeven besturingselementeigenschap verbindt met het opgegeven gegevenslid van de opgegeven gegevensbron, optioneel opmaak inschakelt, waarden doorgeeft aan de gegevensbron op basis van de opgegeven update-instelling, de eigenschap instelt op de opgegeven waarde wanneer DBNull deze wordt geretourneerd vanuit de gegevensbron en de binding aan de verzameling toevoegt.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)	Hiermee maakt u een binding die de opgegeven besturingselementeigenschap verbindt met het opgegeven gegevenslid van de opgegeven gegevensbron, optioneel opmaak met de opgegeven notatietekenreeks inschakelt, waarden doorgeeft aan de gegevensbron op basis van de opgegeven update-instelling, de eigenschap instelt op de opgegeven waarde wanneer DBNull deze wordt geretourneerd vanuit de gegevensbron en de binding aan de verzameling toevoegt.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)	Hiermee maakt u een binding die de opgegeven besturingselementeigenschap verbindt met het opgegeven gegevenslid van de opgegeven gegevensbron, optioneel opmaak inschakelen met de opgegeven notatietekenreeks, waarden doorgeven aan de gegevensbron op basis van de opgegeven update-instelling, de eigenschap instellen op de opgegeven waarde wanneer DBNull deze wordt geretourneerd vanuit de gegevensbron, de opgegeven notatieprovider instellen, en voegt u de binding toe aan de verzameling.

Add(Binding)

Voegt de opgegeven Binding waarde toe aan de verzameling.

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)

Parameters

binding: Binding

De Binding te toevoegen.

Uitzonderingen

ArgumentNullException

De binding waarde is null.

ArgumentException

De besturingselementeigenschap is al gegevensgebonden.

– of –

Er Binding wordt geen geldige kolom van de DataSource.

Voorbeelden

In het volgende codevoorbeeld wordt een Binding exemplaar gemaakt en wordt de Add methode gebruikt om het exemplaar toe te voegen aan het ControlBindingsCollection TextBox besturingselement.

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

Opmerkingen

De DataSourceUpdateMode eigenschap van de Binding eigenschap die door deze overbelasting van de Add methode is gemaakt, wordt ingesteld op de waarde van de DefaultDataSourceUpdateMode eigenschap.

De CollectionChanged gebeurtenis treedt op wanneer de wijziging is voltooid.

Van toepassing op

Add(String, Object, String)

Hiermee maakt u een Binding met behulp van de opgegeven naam van de besturingselementeigenschap, gegevensbron en gegevenslid en voegt u deze toe aan de verzameling.

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

override this.Add : string * obj * string -> System.Windows.Forms.Binding

Public Function Add (propertyName As String, dataSource As Object, dataMember As String) As Binding

Parameters

propertyName: String

De naam van de besturingselementeigenschap die moet worden gekoppeld.

dataSource: Object

Een Object die de gegevensbron vertegenwoordigt.

dataMember: String

De eigenschap of lijst waaraan moet worden gekoppeld.

Retouren

Binding

De zojuist gemaakte Binding.

Uitzonderingen

ArgumentNullException

De binding is null.

Exception

De propertyName gegevens zijn al gebonden.

– of –

Het dataMember geeft geen geldig lid van de dataSource.

Voorbeelden

In het volgende codevoorbeeld wordt de Add methode gebruikt om drie Binding objecten toe te voegen aan een ControlBindingsCollection TextBox besturingselement. De ControlBindingsCollection toegang wordt geopend via de DataBindings eigenschap van de 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

Opmerkingen

De DataSourceUpdateMode eigenschap van de Binding eigenschap die door deze overbelasting van de Add methode is gemaakt, wordt ingesteld op de waarde van de DefaultDataSourceUpdateMode eigenschap.

Als u een Binding gebeurtenis toevoegt, wordt de CollectionChanged gebeurtenis uitgevoerd.

Van toepassing op

Add(String, Object, String, Boolean)

Hiermee maakt u een binding met de opgegeven naam van de besturingselementeigenschap, gegevensbron, gegevensbron, gegevenslid en informatie over of opmaak is ingeschakeld en voegt u de binding toe aan de verzameling.

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

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

Parameters

propertyName: String

De naam van de besturingselementeigenschap die moet worden gekoppeld.

dataSource: Object

Een Object weergave van de gegevensbron.

dataMember: String

De eigenschap of lijst waaraan moet worden gekoppeld.

formattingEnabled: Boolean

true om de weergegeven gegevens op te maken; anders, false.

Retouren

Binding

De zojuist gemaakte Binding.

Uitzonderingen

ArgumentException

De eigenschap die wordt opgegeven door propertyName , bestaat niet in het besturingselement.

– of –

De opgegeven eigenschap is een alleen-lezen eigenschap.

Exception

Als opmaak is uitgeschakeld en de propertyName eigenschap geen geldige eigenschap is van een besturingselement of een lege tekenreeks ("").

Van toepassing op

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

Hiermee maakt u een binding die de opgegeven besturingselementeigenschap koppelt aan het opgegeven gegevenslid van de opgegeven gegevensbron, optioneel opmaak inschakelt, waarden doorgeeft aan de gegevensbron op basis van de opgegeven update-instelling en de binding toevoegt aan de verzameling.

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

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

Parameters

propertyName: String

De naam van de besturingselementeigenschap die moet worden gekoppeld.

dataSource: Object

Een Object weergave van de gegevensbron.

dataMember: String

De eigenschap of lijst waaraan moet worden gekoppeld.

formattingEnabled: Boolean

true om de weergegeven gegevens op te maken; anders, false.

updateMode: DataSourceUpdateMode

Een van de DataSourceUpdateMode waarden.

Retouren

Binding

De zojuist gemaakte Binding.

Uitzonderingen

ArgumentException

De eigenschap die is opgegeven door propertyName , bestaat niet in het besturingselement of heeft het kenmerk Alleen-lezen.

– of –

Het opgegeven gegevenslid bestaat niet in de gegevensbron.

– of –

De opgegeven gegevensbron, het gegevenslid of de opgegeven besturingselementeigenschap zijn gekoppeld aan een andere binding in de verzameling.

Opmerkingen

Als u de Add methode aanroept, wordt de CollectionChanged gebeurtenis gegenereerd.

Van toepassing op

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

Hiermee maakt u een binding die de opgegeven besturingselementeigenschap verbindt met het opgegeven gegevenslid van de opgegeven gegevensbron, optioneel opmaak inschakelt, waarden doorgeeft aan de gegevensbron op basis van de opgegeven update-instelling, de eigenschap instelt op de opgegeven waarde wanneer DBNull deze wordt geretourneerd vanuit de gegevensbron en de binding aan de verzameling toevoegt.

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

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

Parameters

propertyName: String

De naam van de besturingselementeigenschap die moet worden gekoppeld.

dataSource: Object

Een Object weergave van de gegevensbron.

dataMember: String

De eigenschap of lijst waaraan moet worden gekoppeld.

formattingEnabled: Boolean

true om de weergegeven gegevens op te maken; anders, false.

updateMode: DataSourceUpdateMode

Een van de DataSourceUpdateMode waarden.

nullValue: Object

Wanneer de gegevensbron deze waarde heeft, wordt de afhankelijke eigenschap ingesteld op DBNull.

Retouren

Binding

De zojuist gemaakte Binding.

Uitzonderingen

ArgumentException

De eigenschap die is opgegeven door propertyName , bestaat niet in het besturingselement of heeft het kenmerk Alleen-lezen.

– of –

Het opgegeven gegevenslid bestaat niet in de gegevensbron.

– of –

De opgegeven gegevensbron, het gegevenslid of de opgegeven besturingselementeigenschap zijn gekoppeld aan een andere binding in de verzameling.

Opmerkingen

Als u de Add methode aanroept, wordt de CollectionChanged gebeurtenis gegenereerd.

Van toepassing op

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

Hiermee maakt u een binding die de opgegeven besturingselementeigenschap verbindt met het opgegeven gegevenslid van de opgegeven gegevensbron, optioneel opmaak met de opgegeven notatietekenreeks inschakelt, waarden doorgeeft aan de gegevensbron op basis van de opgegeven update-instelling, de eigenschap instelt op de opgegeven waarde wanneer DBNull deze wordt geretourneerd vanuit de gegevensbron en de binding aan de verzameling toevoegt.

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

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

Parameters

propertyName: String

De naam van de besturingselementeigenschap die moet worden gekoppeld.

dataSource: Object

Een Object weergave van de gegevensbron.

dataMember: String

De eigenschap of lijst waaraan moet worden gekoppeld.

formattingEnabled: Boolean

true om de weergegeven gegevens op te maken; anders, false.

updateMode: DataSourceUpdateMode

Een van de DataSourceUpdateMode waarden.

nullValue: Object

Wanneer de gegevensbron deze waarde heeft, wordt de afhankelijke eigenschap ingesteld op DBNull.

formatString: String

Een of meer notatieaanduidingstekens die aangeven hoe een waarde moet worden weergegeven.

Retouren

Binding

De zojuist gemaakte Binding.

Uitzonderingen

ArgumentException

De eigenschap die is opgegeven door propertyName , bestaat niet in het besturingselement of heeft het kenmerk Alleen-lezen.

– of –

Het opgegeven gegevenslid bestaat niet in de gegevensbron.

– of –

De opgegeven gegevensbron, het gegevenslid of de opgegeven besturingselementeigenschap zijn gekoppeld aan een andere binding in de verzameling.

Opmerkingen

Als u de Add methode aanroept, wordt de CollectionChanged gebeurtenis gegenereerd.

Van toepassing op

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

Hiermee maakt u een binding die de opgegeven besturingselementeigenschap verbindt met het opgegeven gegevenslid van de opgegeven gegevensbron, optioneel opmaak inschakelen met de opgegeven notatietekenreeks, waarden doorgeven aan de gegevensbron op basis van de opgegeven update-instelling, de eigenschap instellen op de opgegeven waarde wanneer DBNull deze wordt geretourneerd vanuit de gegevensbron, de opgegeven notatieprovider instellen, en voegt u de binding toe aan de verzameling.

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

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

Parameters

propertyName: String

De naam van de besturingselementeigenschap die moet worden gekoppeld.

dataSource: Object

Een Object weergave van de gegevensbron.

dataMember: String

De eigenschap of lijst waaraan moet worden gekoppeld.

formattingEnabled: Boolean

true om de weergegeven gegevens op te maken; anders, false.

updateMode: DataSourceUpdateMode

Een van de DataSourceUpdateMode waarden.

nullValue: Object

Wanneer de gegevensbron deze waarde heeft, wordt de afhankelijke eigenschap ingesteld op DBNull.

formatString: String

Een of meer notatieaanduidingstekens die aangeven hoe een waarde moet worden weergegeven.

formatInfo: IFormatProvider

Een implementatie van het negeren van IFormatProvider standaardopmaakgedrag.

Retouren

Binding

De zojuist gemaakte Binding.

Uitzonderingen

ArgumentException

De eigenschap die is opgegeven door propertyName , bestaat niet in het besturingselement of heeft het kenmerk Alleen-lezen.

– of –

Het opgegeven gegevenslid bestaat niet in de gegevensbron.

– of –

De opgegeven gegevensbron, het gegevenslid of de opgegeven besturingselementeigenschap zijn gekoppeld aan een andere binding in de verzameling.

Opmerkingen

Als u de Add methode aanroept, wordt de CollectionChanged gebeurtenis gegenereerd.

Van toepassing op

Feedback

Is deze pagina nuttig?