ControlBindingsCollection Classe

Définition

Représente la collection des liaisons de données pour un contrôle.Represents the collection of data bindings for a control.

public ref class ControlBindingsCollection : System::Windows::Forms::BindingsCollection
[System.ComponentModel.TypeConverter("System.Windows.Forms.Design.ControlBindingsConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ComponentModel.TypeConverter("System.Windows.Forms.Design.ControlBindingsConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ComponentModel.TypeConverter("System.Windows.Forms.Design.ControlBindingsConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public class ControlBindingsCollection : System.Windows.Forms.BindingsCollection
type ControlBindingsCollection = class
    inherit BindingsCollection
Public Class ControlBindingsCollection
Inherits BindingsCollection
Héritage
Attributs

Exemples

L’exemple de code suivant ajoute des objets Binding à un ControlBindingsCollection de cinq contrôles : quatre contrôles TextBox et un contrôle DateTimePicker.The following code example adds Binding objects to a ControlBindingsCollection of five controls: four TextBox controls and a DateTimePicker control. ControlBindingsCollection est accessible via la propriété DataBindings de la classe Control.The ControlBindingsCollection is accessed through the DataBindings property of the Control class.

protected:
   void BindControls()
   {
      /* Create two Binding objects for the first two TextBox 
         controls. The data-bound property for both controls 
         is the Text property. The data source is a DataSet 
         (ds). The data member is the navigation path: 
         TableName.ColumnName. */
      textBox1->DataBindings->Add( gcnew Binding(
         "Text",ds,"customers.custName" ) );
      textBox2->DataBindings->Add( gcnew Binding(
         "Text",ds,"customers.custID" ) );
      
      /* Bind the DateTimePicker control by adding a new Binding. 
         The data member of the DateTimePicker is a navigation path:
         TableName.RelationName.ColumnName. */
      DateTimePicker1->DataBindings->Add( gcnew Binding(
         "Value",ds,"customers.CustToOrders.OrderDate" ) );
      
      /* 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 );
      textBox3->DataBindings->Add( b );
      
      /*Bind the fourth TextBox to the Value of the 
         DateTimePicker control. This demonstates how one control
         can be data-bound to another.*/
      textBox4->DataBindings->Add( "Text", DateTimePicker1, "Value" );
      
      // Get the BindingManagerBase for the textBox4 Binding.
      BindingManagerBase^ bmText = this->BindingContext[
         DateTimePicker1 ];
      
      /* Print the Type of the BindingManagerBase, which is 
         a PropertyManager because the data source
         returns only a single property value. */
      Console::WriteLine( bmText->GetType() );
      
      // Print the count of managed objects, which is one.
      Console::WriteLine( bmText->Count );
      
      // Get the BindingManagerBase for the Customers table. 
      bmCustomers = this->BindingContext[ds, "Customers"];
      
      /* Print the Type and count of the BindingManagerBase.
         Because the data source inherits from IBindingList,
         it is a RelatedCurrencyManager (a derived class of
         CurrencyManager). */
      Console::WriteLine( bmCustomers->GetType() );
      Console::WriteLine( bmCustomers->Count );
      
      /* Get the BindingManagerBase for the Orders of the current
         customer using a navigation path: TableName.RelationName. */
      bmOrders = this->BindingContext[ds, "customers.CustToOrders"];
   }
protected void BindControls()
{
   /* Create two Binding objects for the first two TextBox 
   controls. The data-bound property for both controls 
   is the Text property. The data source is a DataSet 
   (ds). The data member is the navigation path: 
   TableName.ColumnName. */
   textBox1.DataBindings.Add(new Binding
   ("Text", ds, "customers.custName"));
   textBox2.DataBindings.Add(new Binding
   ("Text", ds, "customers.custID"));
      
   /* Bind the DateTimePicker control by adding a new Binding. 
   The data member of the DateTimePicker is a navigation path:
   TableName.RelationName.ColumnName. */
   DateTimePicker1.DataBindings.Add(new 
   Binding("Value", ds, "customers.CustToOrders.OrderDate"));

   /* 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);
   textBox3.DataBindings.Add(b);

   /*Bind the fourth TextBox to the Value of the 
   DateTimePicker control. This demonstates how one control
   can be data-bound to another.*/
   textBox4.DataBindings.Add("Text", DateTimePicker1,"Value");

   // Get the BindingManagerBase for the textBox4 Binding.
   BindingManagerBase bmText = this.BindingContext
   [DateTimePicker1];

   /* Print the Type of the BindingManagerBase, which is 
   a PropertyManager because the data source
   returns only a single property value. */
   Console.WriteLine(bmText.GetType().ToString());

   // Print the count of managed objects, which is one.
   Console.WriteLine(bmText.Count);

   // Get the BindingManagerBase for the Customers table. 
   bmCustomers = this.BindingContext [ds, "Customers"];

   /* Print the Type and count of the BindingManagerBase.
   Because the data source inherits from IBindingList,
   it is a RelatedCurrencyManager (a derived class of
   CurrencyManager). */
   Console.WriteLine(bmCustomers.GetType().ToString());
   Console.WriteLine(bmCustomers.Count);
   
   /* Get the BindingManagerBase for the Orders of the current
   customer using a navigation path: TableName.RelationName. */ 
   bmOrders = this.BindingContext[ds, "customers.CustToOrders"];
}
Protected Sub BindControls()
    ' Create two Binding objects for the first two TextBox 
    ' controls. The data-bound property for both controls 
    ' is the Text property. The data source is a DataSet 
    ' (ds). The data member is the navigation path: 
    ' TableName.ColumnName. 
    textBox1.DataBindings.Add _
       (New Binding("Text", ds, "customers.custName"))
    textBox2.DataBindings.Add _
       (New Binding("Text", ds, "customers.custID"))
    
    ' Bind the DateTimePicker control by adding a new Binding. 
    ' The data member of the DateTimePicker is a navigation path:
    ' TableName.RelationName.ColumnName. 
    DateTimePicker1.DataBindings.Add _
       (New Binding("Value", ds, "customers.CustToOrders.OrderDate"))
    
    ' 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
    textBox3.DataBindings.Add(b)
    
    ' Bind the fourth TextBox to the Value of the 
    ' DateTimePicker control. This demonstates how one control
    ' can be data-bound to another.
    textBox4.DataBindings.Add("Text", DateTimePicker1, "Value")
    
    ' Get the BindingManagerBase for the textBox4 Binding.
    Dim bmText As BindingManagerBase = Me.BindingContext(DateTimePicker1)
    
    ' Print the Type of the BindingManagerBase, which is 
    ' a PropertyManager because the data source
    ' returns only a single property value. 
    Console.WriteLine(bmText.GetType().ToString())
    
    ' Print the count of managed objects, which is one.
    Console.WriteLine(bmText.Count)
    
    ' Get the BindingManagerBase for the Customers table. 
    bmCustomers = Me.BindingContext(ds, "Customers")
    
    ' Print the Type and count of the BindingManagerBase.
    ' Because the data source inherits from IBindingList,
    ' it is a RelatedCurrencyManager (a derived class of
    ' CurrencyManager). 
    Console.WriteLine(bmCustomers.GetType().ToString())
    Console.WriteLine(bmCustomers.Count)
    
    ' Get the BindingManagerBase for the Orders of the current
    ' customer using a navigation path: TableName.RelationName. 
    bmOrders = Me.BindingContext(ds, "customers.CustToOrders")
End Sub    

Remarques

La liaison de données simple s’effectue en ajoutant des objets Binding à un ControlBindingsCollection.Simple data binding is accomplished by adding Binding objects to a ControlBindingsCollection. Tout objet qui hérite de la classe Control peut accéder au ControlBindingsCollection via la propriété DataBindings.Any object that inherits from the Control class can access the ControlBindingsCollection through the DataBindings property. Pour obtenir la liste des contrôles Windows qui prennent en charge la liaison de données, consultez la classe Binding.For a list of Windows controls that support data binding, see the Binding class.

Le ControlBindingsCollection contient des méthodes de collection standard, telles que Add, Clearet Remove.The ControlBindingsCollection contains standard collection methods such as Add, Clear, and Remove.

Pour accéder au contrôle auquel appartient l' ControlBindingsCollection, utilisez la propriété Control.To get the control that the ControlBindingsCollection belongs to, use the Control property.

Constructeurs

ControlBindingsCollection(IBindableComponent)

Initialise une nouvelle instance de la classe ControlBindingsCollection avec le contrôle pouvant être lié spécifié.Initializes a new instance of the ControlBindingsCollection class with the specified bindable control.

Propriétés

BindableComponent

Obtient le IBindableComponent auquel appartient la collection de liaisons.Gets the IBindableComponent the binding collection belongs to.

Control

Obtient le contrôle auquel la collection appartient.Gets the control that the collection belongs to.

Count

Obtient le nombre total de liaisons dans la collection.Gets the total number of bindings in the collection.

(Hérité de BindingsCollection)
DefaultDataSourceUpdateMode

Obtient ou définit le DataSourceUpdateMode par défaut pour un Binding de la collection.Gets or sets the default DataSourceUpdateMode for a Binding in the collection.

IsReadOnly

Obtient une valeur indiquant si la collection est en lecture seule.Gets a value indicating whether the collection is read-only.

(Hérité de BaseCollection)
IsSynchronized

Obtient une valeur indiquant si l’accès à ICollection est synchronisé.Gets a value indicating whether access to the ICollection is synchronized.

(Hérité de BaseCollection)
Item[Int32]

Obtient l'objet Binding à l'index spécifié.Gets the Binding at the specified index.

(Hérité de BindingsCollection)
Item[String]

Obtient le Binding spécifié par le nom de la propriété du contrôle.Gets the Binding specified by the control's property name.

List

Obtient les liaisons de la collection en tant qu'objet.Gets the bindings in the collection as an object.

(Hérité de BindingsCollection)
SyncRoot

Obtient un objet qui peut être utilisé pour synchroniser l'accès à BaseCollection.Gets an object that can be used to synchronize access to the BaseCollection.

(Hérité de BaseCollection)

Méthodes

Add(Binding)

Ajoute l'objet Binding spécifié à la collection.Adds the specified Binding to the 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.Creates a Binding using the specified control property name, data source, and data member, and adds it to the 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.Creates a binding with the specified control property name, data source, data member, and information about whether formatting is enabled, and adds the binding to the 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.Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting, propagating values to the data source based on the specified update setting, and adding the binding to the 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.Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting, propagating values to the data source based on the specified update setting, setting the property to the specified value when DBNull is returned from the data source, and adding the binding to the 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.Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting with the specified format string, propagating values to the data source based on the specified update setting, setting the property to the specified value when DBNull is returned from the data source, and adding the binding to the 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.Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting with the specified format string, propagating values to the data source based on the specified update setting, setting the property to the specified value when DBNull is returned from the data source, setting the specified format provider, and adding the binding to the collection.

AddCore(Binding)

Ajoute une liaison à la collection.Adds a binding to the collection.

Clear()

Efface la collection des liaisons existantes.Clears the collection of any bindings.

ClearCore()

Efface les liaisons de la collection.Clears the bindings in the collection.

CopyTo(Array, Int32)

Copie tous les éléments du Array unidimensionnel en cours dans le Array unidimensionnel spécifié en commençant à l'index Array de destination spécifié.Copies all the elements of the current one-dimensional Array to the specified one-dimensional Array starting at the specified destination Array index.

(Hérité de BaseCollection)
CreateObjRef(Type)

Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Hérité de MarshalByRefObject)
Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetEnumerator()

Obtient l'objet qui permet l'itération au sein des membres de la collection.Gets the object that enables iterating through the members of the collection.

(Hérité de BaseCollection)
GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetLifetimeService()

Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Hérité de MarshalByRefObject)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
InitializeLifetimeService()

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.Obtains a lifetime service object to control the lifetime policy for this instance.

(Hérité de MarshalByRefObject)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
MemberwiseClone(Boolean)

Crée une copie superficielle de l'objet MarshalByRefObject actuel.Creates a shallow copy of the current MarshalByRefObject object.

(Hérité de MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)

Déclenche l’événement CollectionChanged.Raises the CollectionChanged event.

(Hérité de BindingsCollection)
OnCollectionChanging(CollectionChangeEventArgs)

Déclenche l’événement CollectionChanging.Raises the CollectionChanging event.

(Hérité de BindingsCollection)
Remove(Binding)

Supprime le Binding spécifié de la collection.Deletes the specified Binding from the collection.

RemoveAt(Int32)

Supprime le Binding à l'index spécifié.Deletes the Binding at the specified index.

RemoveCore(Binding)

Supprime la liaison spécifiée de la collection.Removes the specified binding from the collection.

ShouldSerializeMyAll()

Obtient une valeur indiquant si la collection doit être sérialisée.Gets a value that indicates whether the collection should be serialized.

(Hérité de BindingsCollection)
ToString()

Retourne une chaîne qui représente l'objet actif.Returns a string that represents the current object.

(Hérité de Object)

Événements

CollectionChanged

Se produit lorsque la collection a été modifiée.Occurs when the collection has changed.

(Hérité de BindingsCollection)
CollectionChanging

Se produit lorsque la collection est sur le point d'être modifiée.Occurs when the collection is about to change.

(Hérité de BindingsCollection)

Méthodes d’extension

Cast<TResult>(IEnumerable)

Effectue un cast des éléments d'un IEnumerable vers le type spécifié.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtre les éléments d'un IEnumerable en fonction du type spécifié.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Active la parallélisation d'une requête.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convertit un IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

S’applique à