Partager via


ControlBindingsCollection Classe

Définition

Représente la collection des liaisons de données pour un contrôle.

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

Exemples

L’exemple de code suivant ajoute Binding des objets à un ControlBindingsCollection de cinq contrôles : quatre TextBox contrôles et un DateTimePicker contrôle. ControlBindingsCollection est accessible via la propriété DataBindings de la classe Control.

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 Binding des objets à un ControlBindingsCollection. Tout objet qui hérite de la Control classe peut accéder au ControlBindingsCollection via la DataBindings propriété . Pour obtenir la liste des contrôles Windows qui prennent en charge la liaison de données, consultez la Binding classe .

contient des ControlBindingsCollection méthodes de collection standard telles que Add, Clearet Remove.

Pour obtenir le contrôle auquel appartient, ControlBindingsCollection utilisez la Control propriété .

Constructeurs

ControlBindingsCollection(IBindableComponent)

Initialise une nouvelle instance de la classe ControlBindingsCollection avec le contrôle pouvant être lié spécifié.

Propriétés

BindableComponent

Obtient le IBindableComponent auquel appartient la collection de liaisons.

Control

Obtient le contrôle auquel la collection appartient.

Count

Obtient le nombre total de liaisons dans la collection.

(Hérité de BindingsCollection)
DefaultDataSourceUpdateMode

Obtient ou définit le DataSourceUpdateMode par défaut pour un Binding de la collection.

IsReadOnly

Obtient une valeur indiquant si la collection est en lecture seule.

(Hérité de BaseCollection)
IsSynchronized

Obtient une valeur indiquant si l'accès à ICollection est synchronisé.

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

Obtient l'objet Binding à l'index spécifié.

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

Obtient le Binding spécifié par le nom de la propriété du contrôle.

List

Obtient les liaisons de la collection en tant qu'objet.

(Hérité de BindingsCollection)
SyncRoot

Obtient un objet qui peut être utilisé pour synchroniser l’accès à BaseCollection.

(Hérité de BaseCollection)

Méthodes

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.

AddCore(Binding)

Ajoute une liaison à la collection.

Clear()

Efface la collection des liaisons existantes.

ClearCore()

Efface les liaisons de la 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é.

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

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

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetEnumerator()

Obtient l'objet qui permet l'itération au sein des membres de la collection.

(Hérité de BaseCollection)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetLifetimeService()
Obsolète.

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.

(Hérité de MarshalByRefObject)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
InitializeLifetimeService()
Obsolète.

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.

(Hérité de MarshalByRefObject)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

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

Crée une copie superficielle de l'objet MarshalByRefObject actuel.

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

Déclenche l’événement CollectionChanged.

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

Déclenche l’événement CollectionChanging.

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

Supprime le Binding spécifié de la collection.

RemoveAt(Int32)

Supprime le Binding à l'index spécifié.

RemoveCore(Binding)

Supprime la liaison spécifiée de la collection.

ShouldSerializeMyAll()

Obtient une valeur indiquant si la collection doit être sérialisée.

(Hérité de BindingsCollection)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

Événements

CollectionChanged

Se produit lorsque la collection a été modifiée.

(Hérité de BindingsCollection)
CollectionChanging

Se produit lorsque la collection est sur le point d'être modifiée.

(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é.

OfType<TResult>(IEnumerable)

Filtre les éléments d'un IEnumerable en fonction du type spécifié.

AsParallel(IEnumerable)

Active la parallélisation d'une requête.

AsQueryable(IEnumerable)

Convertit un IEnumerable en IQueryable.

S’applique à