ControlBindingsCollection.Add Méthode

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Ajoute une Binding à la collection.

Surcharges

Nom	Description
Add(Binding)	Ajoute le paramètre spécifié Binding à la collection.
Add(String, Object, String)	Crée un Binding nom de propriété de contrôle, une source de données et un membre de données spécifiés, puis l’ajoute à la collection.
Add(String, Object, String, Boolean)	Crée une liaison avec le nom de propriété de contrôle, la source de données, le membre de données et les informations sur l’activation de la mise en forme et l’ajout de la liaison à la collection.
Add(String, Object, String, Boolean, DataSourceUpdateMode)	Crée une liaison qui lie la propriété de contrôle spécifiée au membre de données spécifié de la source de données spécifiée, en activant éventuellement la mise en forme, en propageant des valeurs vers la source de données en fonction du paramètre de mise à jour spécifié et en ajoutant la liaison à la collection.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object)	Crée une liaison qui lie la propriété de contrôle spécifiée au membre de données spécifié de la source de données spécifiée, en activant éventuellement la mise en forme, en propageant des valeurs vers la source de données en fonction du paramètre de mise à jour spécifié, en définissant la propriété sur la valeur spécifiée lorsqu’elle DBNull est retournée à partir de la source de données et en ajoutant la liaison à la collection.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)	Crée une liaison qui lie la propriété de contrôle spécifiée au membre de données spécifié de la source de données spécifiée, en activant éventuellement la mise en forme avec la chaîne de format spécifiée, en propageant les valeurs vers la source de données en fonction du paramètre de mise à jour spécifié, en définissant la propriété sur la valeur spécifiée lorsqu’elle DBNull est retournée à partir de la source de données et en ajoutant la liaison à la collection.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)	Crée une liaison qui lie la propriété de contrôle spécifiée au membre de données spécifié de la source de données spécifiée, en activant éventuellement la mise en forme avec la chaîne de format spécifiée, en propageant les valeurs vers la source de données en fonction du paramètre de mise à jour spécifié, en définissant la propriété sur la valeur spécifiée lorsqu’elle DBNull est retournée à partir de la source de données, en définissant le fournisseur de format spécifié, et ajout de la liaison à la collection.

Add(Binding)

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Ajoute le paramètre spécifié Binding à la collection.

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)

Paramètres

binding: Binding

À Binding ajouter.

Exceptions

ArgumentNullException

La binding valeur est Null.

ArgumentException

La propriété de contrôle est déjà liée aux données.

- ou -

Le Binding paramètre ne spécifie pas de colonne valide du DataSource.

Exemples

L’exemple de code suivant crée une Binding instance et utilise la Add méthode pour ajouter l’instance à un TextBox ControlBindingsCollection contrôle.

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

Remarques

La DataSourceUpdateMode propriété de la Binding propriété créée par cette surcharge de la Add méthode est définie sur la valeur de la DefaultDataSourceUpdateMode propriété.

L’événement CollectionChanged se produit lorsque la modification est terminée.

S’applique à

Add(String, Object, String)

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Crée un Binding nom de propriété de contrôle, une source de données et un membre de données spécifiés, puis l’ajoute à la 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

Paramètres

propertyName: String

Nom de la propriété de contrôle à lier.

dataSource: Object

Qui Object représente la source de données.

dataMember: String

Propriété ou liste à lier.

Retours

Binding

Nouvellement créé Binding.

Exceptions

ArgumentNullException

binding a la valeur null.

Exception

Il propertyName est déjà lié aux données.

- ou -

Le dataMember paramètre ne spécifie pas de membre valide du dataSource.

Exemples

L’exemple de TextBox code suivant utilise la Add méthode pour ajouter trois Binding objets à un ControlBindingsCollection contrôle. L’accès ControlBindingsCollection est accessible via la DataBindings propriété de la Control classe.

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

Remarques

La DataSourceUpdateMode propriété de la Binding propriété créée par cette surcharge de la Add méthode est définie sur la valeur de la DefaultDataSourceUpdateMode propriété.

L’ajout d’une Binding cause à l’événement CollectionChanged se produit.

S’applique à

Add(String, Object, String, Boolean)

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Crée une liaison avec le nom de propriété de contrôle, la source de données, le membre de données et les informations sur l’activation de la mise en forme et l’ajout de la liaison à la collection.

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

Paramètres

propertyName: String

Nom de la propriété de contrôle à lier.

dataSource: Object

Représentant Object la source de données.

dataMember: String

Propriété ou liste à lier.

formattingEnabled: Boolean

true pour mettre en forme les données affichées ; sinon, false.

Retours

Binding

Nouvellement créé Binding.

Exceptions

ArgumentException

La propriété donnée par propertyName n’existe pas sur le contrôle.

- ou -

La propriété donnée est une propriété en lecture seule.

Exception

Si la mise en forme est désactivée et que la propertyName propriété n’est ni valide d’un contrôle ni d’une chaîne vide (« »).

S’applique à

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

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Crée une liaison qui lie la propriété de contrôle spécifiée au membre de données spécifié de la source de données spécifiée, en activant éventuellement la mise en forme, en propageant des valeurs vers la source de données en fonction du paramètre de mise à jour spécifié et en ajoutant la liaison à la collection.

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

Paramètres

propertyName: String

Nom de la propriété de contrôle à lier.

dataSource: Object

Représentant Object la source de données.

dataMember: String

Propriété ou liste à lier.

formattingEnabled: Boolean

true pour mettre en forme les données affichées ; sinon, false.

updateMode: DataSourceUpdateMode

Une des DataSourceUpdateMode valeurs.

Retours

Binding

Nouvellement créé Binding.

Exceptions

ArgumentException

La propriété donnée par propertyName n’existe pas sur le contrôle ou est en lecture seule.

- ou -

Le membre de données spécifié n’existe pas sur la source de données.

- ou -

La source de données, le membre de données ou la propriété de contrôle spécifiée sont associés à une autre liaison dans la collection.

Remarques

L’appel de la méthode déclenche l’événement Add CollectionChanged .

S’applique à

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

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

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

Paramètres

propertyName: String

Nom de la propriété de contrôle à lier.

dataSource: Object

Représentant Object la source de données.

dataMember: String

Propriété ou liste à lier.

formattingEnabled: Boolean

true pour mettre en forme les données affichées ; sinon, false.

updateMode: DataSourceUpdateMode

Une des DataSourceUpdateMode valeurs.

nullValue: Object

Lorsque la source de données a cette valeur, la propriété liée est définie sur DBNull.

Retours

Binding

Nouvellement créé Binding.

Exceptions

ArgumentException

La propriété donnée par propertyName n’existe pas sur le contrôle ou est en lecture seule.

- ou -

Le membre de données spécifié n’existe pas sur la source de données.

- ou -

La source de données, le membre de données ou la propriété de contrôle spécifiée sont associés à une autre liaison dans la collection.

Remarques

L’appel de la méthode déclenche l’événement Add CollectionChanged .

S’applique à

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

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Crée une liaison qui lie la propriété de contrôle spécifiée au membre de données spécifié de la source de données spécifiée, en activant éventuellement la mise en forme avec la chaîne de format spécifiée, en propageant les valeurs vers la source de données en fonction du paramètre de mise à jour spécifié, en définissant la propriété sur la valeur spécifiée lorsqu’elle DBNull est retournée à partir de la source de données et en ajoutant la liaison à la collection.

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

Paramètres

propertyName: String

Nom de la propriété de contrôle à lier.

dataSource: Object

Représentant Object la source de données.

dataMember: String

Propriété ou liste à lier.

formattingEnabled: Boolean

true pour mettre en forme les données affichées ; sinon, false.

updateMode: DataSourceUpdateMode

Une des DataSourceUpdateMode valeurs.

nullValue: Object

Lorsque la source de données a cette valeur, la propriété liée est définie sur DBNull.

formatString: String

Un ou plusieurs caractères spécificateur de format qui indiquent la façon dont une valeur doit être affichée.

Retours

Binding

Nouvellement créé Binding.

Exceptions

ArgumentException

La propriété donnée par propertyName n’existe pas sur le contrôle ou est en lecture seule.

- ou -

Le membre de données spécifié n’existe pas sur la source de données.

- ou -

La source de données, le membre de données ou la propriété de contrôle spécifiée sont associés à une autre liaison dans la collection.

Remarques

L’appel de la méthode déclenche l’événement Add CollectionChanged .

S’applique à

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

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

Source:: ControlBindingsCollection.cs

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

Paramètres

propertyName: String

Nom de la propriété de contrôle à lier.

dataSource: Object

Représentant Object la source de données.

dataMember: String

Propriété ou liste à lier.

formattingEnabled: Boolean

true pour mettre en forme les données affichées ; sinon, false.

updateMode: DataSourceUpdateMode

Une des DataSourceUpdateMode valeurs.

nullValue: Object

Lorsque la source de données a cette valeur, la propriété liée est définie sur DBNull.

formatString: String

Un ou plusieurs caractères spécificateur de format qui indiquent la façon dont une valeur doit être affichée.

formatInfo: IFormatProvider

Implémentation de remplacement du comportement de IFormatProvider mise en forme par défaut.

Retours

Binding

Nouvellement créé Binding.

Exceptions

ArgumentException

La propriété donnée par propertyName n’existe pas sur le contrôle ou est en lecture seule.

- ou -

Le membre de données spécifié n’existe pas sur la source de données.

- ou -

La source de données, le membre de données ou la propriété de contrôle spécifiée sont associés à une autre liaison dans la collection.

Remarques

L’appel de la méthode déclenche l’événement Add CollectionChanged .

S’applique à

Commentaires

Cette page a-t-elle été utile ?

Partager via

ControlBindingsCollection.Add Méthode

Définition

Surcharges

Add(Binding)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

Add(String, Object, String)

Paramètres

Retours

Exceptions

Exemples

Remarques

S’applique à

Add(String, Object, String, Boolean)

Paramètres

Retours

Exceptions

S’applique à

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

Paramètres

Retours

Exceptions

Remarques

S’applique à

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

Paramètres

Retours

Exceptions

Remarques

S’applique à

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

Paramètres

Retours

Exceptions

Remarques

S’applique à

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

Paramètres

Retours

Exceptions

Remarques

S’applique à

Commentaires