ControlBindingsCollection Classe

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Rappresenta la raccolta dei data binding di un controllo.

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")]
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")>]
type ControlBindingsCollection = class
    inherit BindingsCollection

Public Class ControlBindingsCollection
Inherits BindingsCollection

Ereditarietà

Object

MarshalByRefObject

BaseCollection

BindingsCollection

ControlBindingsCollection

Attributi

TypeConverterAttribute

Esempio

Nell'esempio di codice seguente vengono aggiunti Binding oggetti a cinque ControlBindingsCollection controlli: quattro TextBox controlli e un DateTimePicker controllo. È possibile accedere a ControlBindingsCollection tramite la proprietà DataBindings della 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

Commenti

Il data binding semplice viene eseguito aggiungendo Binding oggetti a un ControlBindingsCollectionoggetto . Qualsiasi oggetto che eredita dalla Control classe può accedere alla ControlBindingsCollectionDataBindings proprietà. Per un elenco di controlli Windows che supportano il data binding, vedere la Binding classe .

Contiene ControlBindingsCollection metodi di raccolta standard, Addad esempio , Cleare Remove.

Per ottenere il controllo a cui ControlBindingsCollection appartiene, usare la Control proprietà .

Costruttori

ControlBindingsCollection(IBindableComponent)

Inizializza una nuova istanza della classe ControlBindingsCollection con il controllo associabile specificato.

Proprietà

BindableComponent	Ottiene l'oggetto IBindableComponent al quale la raccolta associabile appartiene.
Control	Ottiene il controllo cui appartiene la raccolta.
Count	Ottiene il numero totale di associazioni nella raccolta. (Ereditato da BindingsCollection)
DefaultDataSourceUpdateMode	Ottiene o imposta la proprietà DataSourceUpdateMode predefinita per un oggetto Binding della raccolta.
IsReadOnly	Ottiene un valore che indica se la raccolta è di sola lettura. (Ereditato da BaseCollection)
IsSynchronized	Ottiene un valore che indica se l'accesso all'interfaccia ICollection è sincronizzato. (Ereditato da BaseCollection)
Item[Int32]	Ottiene Binding in corrispondenza dell'indice specificato. (Ereditato da BindingsCollection)
Item[String]	Ottiene il Binding specificato dal nome della proprietà del controllo.
List	Ottiene le associazioni nella raccolta come oggetto. (Ereditato da BindingsCollection)
SyncRoot	Ottiene un oggetto che può essere usato per sincronizzare l'accesso a BaseCollection. (Ereditato da BaseCollection)

Metodi

Add(Binding)	Aggiunge l'oggetto Binding specificato alla raccolta.
Add(String, Object, String)	Crea un Binding usando il nome della proprietà, l'origine dati e il membro dati del controllo specificato e lo aggiunge alla raccolta.
Add(String, Object, String, Boolean)	Crea un'associazione con il nome della proprietà del controllo, l'origine dati, il membro dati e le informazioni sull'abilitazione della formattazione specificati, infine aggiunge tale associazione alla raccolta.
Add(String, Object, String, Boolean, DataSourceUpdateMode)	Crea un'associazione tra la proprietà del controllo specificata e il membro dati indicato dell'origine dati specificata, facoltativamente abilita la formattazione, propaga i valori all'origine dati in base alle impostazioni di aggiornamento specificate e aggiunge l'associazione alla raccolta.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object)	Crea un'associazione tra la proprietà del controllo specificata e il membro dati indicato dell'origine dati specificata, facoltativamente abilita la formattazione, propaga i valori all'origine dati in base alle impostazioni di aggiornamento specificate, imposta la proprietà sul valore specificato quando l'origine dati restituisce l'oggetto DBNull e aggiunge l'associazione alla raccolta.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)	Crea un'associazione tra la proprietà del controllo specificata e il membro dati indicato dell'origine dati specificata, facoltativamente abilita la formattazione con la stringa di formato specificata, propaga i valori all'origine dati in base alle impostazioni di aggiornamento specificate, imposta la proprietà sul valore specificato quando l'origine dati restituisce l'oggetto DBNull e aggiunge l'associazione alla raccolta.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)	Crea un'associazione tra la proprietà del controllo specificata e il membro dati indicato dell'origine dati specificata, facoltativamente abilita la formattazione con la stringa di formato specificata, propaga i valori all'origine dati in base alle impostazioni di aggiornamento specificate, imposta la proprietà sul valore specificato quando l'origine dati restituisce l'oggetto DBNull, imposta il provider di formato specificato e aggiunge l'associazione alla raccolta.
AddCore(Binding)	Aggiunge un'associazione alla raccolta.
Clear()	Elimina la raccolta di tutte le associazioni.
ClearCore()	Cancella le associazioni della raccolta.
CopyTo(Array, Int32)	Copia tutti gli elementi dell'oggetto Array unidimensionale corrente nell'oggetto Array unidimensionale specificato a partire dall'indice Array di destinazione indicato. (Ereditato da BaseCollection)
CreateObjRef(Type)	Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto. (Ereditato da MarshalByRefObject)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetEnumerator()	Ottiene l'oggetto che consente di scorrere i membri dell'insieme. (Ereditato da BaseCollection)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetLifetimeService()	Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
InitializeLifetimeService()	Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)	Genera l'evento CollectionChanged. (Ereditato da BindingsCollection)
OnCollectionChanging(CollectionChangeEventArgs)	Genera l'evento CollectionChanging. (Ereditato da BindingsCollection)
Remove(Binding)	Elimina il Binding specificato dalla raccolta.
RemoveAt(Int32)	Elimina il Binding in corrispondenza dell'indice specificato.
RemoveCore(Binding)	Rimuove l'associazione specificata dalla raccolta.
ShouldSerializeMyAll()	Ottiene un valore che indica se è necessario serializzare la raccolta. (Ereditato da BindingsCollection)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Eventi

CollectionChanged	Si verifica in seguito alla modifica della raccolta. (Ereditato da BindingsCollection)
CollectionChanging	Si verifica quando la raccolta sta per essere modificata. (Ereditato da BindingsCollection)

Metodi di estensione