Partager via


ControlBindingsCollection.Add Méthode

Définition

Ajoute un Binding à la collection.

Surcharges

Add(Binding)

Ajoute l'objet Binding spécifié à la collection.

Add(String, Object, String)

Crée un Binding en utilisant le nom de propriété du contrôle spécifié, la source de données et les données membres, et l'ajoute à la collection.

Add(String, Object, String, Boolean)

Crée une liaison avec le nom de propriété du contrôle spécifié, la source de données, les données membres et les informations relatives à l’activation ou non de la mise en forme et ajoute la liaison à la collection.

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

Crée une liaison qui lie la propriété du contrôle spécifiée aux données membres spécifiées de la source de données spécifiée, en activant la mise en forme de manière facultative, en propageant des valeurs à 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é du contrôle spécifiée aux données membres spécifiées de la source de données spécifiée, en activant la mise en forme de manière facultative, en propageant des valeurs à 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 lorsque DBNull est retourné 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é du contrôle spécifiée aux données membres spécifiées de la source de données spécifiée, en activant la mise en forme avec la chaîne de mise en forme spécifiée de manière facultative, en propageant des valeurs à 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 lorsque DBNull est retourné 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é du contrôle spécifiée aux données membres spécifiées de la source de données spécifiée, en activant la mise en forme avec la chaîne de mise en forme spécifiée de manière facultative, en propageant des valeurs à 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 lorsque DBNull est retourné de la source de données, en définissant le fournisseur de format spécifié et en ajoutant la liaison à la collection.

Add(Binding)

Ajoute l'objet Binding spécifié à 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

binding a la valeur null.

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

- ou -

Binding ne spécifie pas une colonne valide du DataSource.

Exemples

L’exemple de code suivant crée un Binding instance et utilise la Add méthode pour ajouter le instance au ControlBindingsCollection d’un TextBox 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é du Binding créé 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)

Crée un Binding en utilisant le nom de propriété du contrôle spécifié, la source de données et les données membres, et 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é du contrôle à lier.

dataSource
Object

Object représentant la source de données.

dataMember
String

Propriété ou liste à lier.

Retours

Objet Binding nouvellement créé.

Exceptions

binding a la valeur null.

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

- ou -

dataMember ne spécifie pas un membre valide de dataSource.

Exemples

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

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é du Binding créé par cette surcharge de la Add méthode est définie sur la valeur de la DefaultDataSourceUpdateMode propriété .

L’ajout d’un Binding provoque l’événement CollectionChanged .

S’applique à

Add(String, Object, String, Boolean)

Crée une liaison avec le nom de propriété du contrôle spécifié, la source de données, les données membres et les informations relatives à l’activation ou non de la mise en forme et ajoute 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é du contrôle à lier.

dataSource
Object

Object représentant 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

Objet Binding nouvellement créé.

Exceptions

La propriété fournie par propertyName n'existe pas dans le contrôle.

- ou -

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

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

S’applique à

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

Crée une liaison qui lie la propriété du contrôle spécifiée aux données membres spécifiées de la source de données spécifiée, en activant la mise en forme de manière facultative, en propageant des valeurs à 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é du contrôle à lier.

dataSource
Object

Object représentant 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 valeurs de l'objet DataSourceUpdateMode.

Retours

Objet Binding nouvellement créé.

Exceptions

La propriété fournie par propertyName n'existe pas dans le contrôle ou est en lecture seule.

- ou -

Les données membres spécifiées n'existent pas dans la source de données.

- ou -

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

Remarques

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

S’applique à

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

Crée une liaison qui lie la propriété du contrôle spécifiée aux données membres spécifiées de la source de données spécifiée, en activant la mise en forme de manière facultative, en propageant des valeurs à 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 lorsque DBNull est retourné 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);
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é du contrôle à lier.

dataSource
Object

Object représentant 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 valeurs de l'objet DataSourceUpdateMode.

nullValue
Object

Lorsque la source de données a cette valeur, la propriété liée prend la valeur DBNull.

Retours

Objet Binding nouvellement créé.

Exceptions

La propriété fournie par propertyName n'existe pas dans le contrôle ou est en lecture seule.

- ou -

Les données membres spécifiées n'existent pas dans la source de données.

- ou -

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

Remarques

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

S’applique à

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

Crée une liaison qui lie la propriété du contrôle spécifiée aux données membres spécifiées de la source de données spécifiée, en activant la mise en forme avec la chaîne de mise en forme spécifiée de manière facultative, en propageant des valeurs à 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 lorsque DBNull est retourné 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é du contrôle à lier.

dataSource
Object

Object représentant 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 valeurs de l'objet DataSourceUpdateMode.

nullValue
Object

Lorsque la source de données a cette valeur, la propriété liée prend la valeur DBNull.

formatString
String

Un ou plusieurs caractères spécificateurs de format qui indiquent comment une valeur doit s'afficher.

Retours

Objet Binding nouvellement créé.

Exceptions

La propriété fournie par propertyName n'existe pas dans le contrôle ou est en lecture seule.

- ou -

Les données membres spécifiées n'existent pas dans la source de données.

- ou -

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

Remarques

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

S’applique à

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

Crée une liaison qui lie la propriété du contrôle spécifiée aux données membres spécifiées de la source de données spécifiée, en activant la mise en forme avec la chaîne de mise en forme spécifiée de manière facultative, en propageant des valeurs à 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 lorsque DBNull est retourné de la source de données, en définissant le fournisseur de format 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, 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é du contrôle à lier.

dataSource
Object

Object représentant 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 valeurs de l'objet DataSourceUpdateMode.

nullValue
Object

Lorsque la source de données a cette valeur, la propriété liée prend la valeur DBNull.

formatString
String

Un ou plusieurs caractères spécificateurs de format qui indiquent comment une valeur doit s'afficher.

formatInfo
IFormatProvider

Implémentation de IFormatProvider pour substituer le comportement de mise en forme par défaut.

Retours

Objet Binding nouvellement créé.

Exceptions

La propriété fournie par propertyName n'existe pas dans le contrôle ou est en lecture seule.

- ou -

Les données membres spécifiées n'existent pas dans la source de données.

- ou -

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

Remarques

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

S’applique à