ControlBindingsCollection Klasse

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Stellt die Auflistung von Datenbindungen für ein Steuerelement dar.

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

Vererbung

Object

MarshalByRefObject

BaseCollection

BindingsCollection

ControlBindingsCollection

Attribute

TypeConverterAttribute

Beispiele

Im folgenden Codebeispiel werden einem von fünf Steuerelementen Objekte ControlBindingsCollection hinzugefügtBinding: vier TextBox Steuerelemente und ein DateTimePicker Steuerelement. Der Zugriff auf die ControlBindingsCollection erfolgt über die DataBindings-Eigenschaft der Control-Klasse.

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

Hinweise

Eine einfache Datenbindung wird erreicht, indem Objekte zu einem ControlBindingsCollectionhinzugefügt Binding werden. Jedes Objekt, das von der Control -Klasse erbt, kann über die DataBindings -Eigenschaft auf die ControlBindingsCollection zugreifen. Eine Liste der Windows-Steuerelemente, die Die Datenbindung unterstützen, finden Sie in der Binding -Klasse.

Enthält ControlBindingsCollection Standardauflistungsmethoden wie Add, Clearund Remove.

Um das Steuerelement abzurufen, zu dem das ControlBindingsCollection gehört, verwenden Sie die Control -Eigenschaft.

Konstruktoren

ControlBindingsCollection(IBindableComponent)

Initialisiert eine neue Instanz der ControlBindingsCollection-Klasse mit dem angegebenen bindbaren Steuerelement.

Eigenschaften

BindableComponent	Ruft die IBindableComponent ab, zu der die Bindungsauflistung gehört.
Control	Ruft das Steuerelement ab, zu dem die Auflistung gehört.
Count	Ruft die Gesamtanzahl der Bindungen in der Auflistung ab. (Geerbt von BindingsCollection)
DefaultDataSourceUpdateMode	Ruft den Standardwert-DataSourceUpdateMode für eine Binding in der Auflistung ab oder legt ihn fest.
IsReadOnly	Ruft einen Wert ab, der angibt, ob die Auflistung schreibgeschützt ist. (Geerbt von BaseCollection)
IsSynchronized	Ruft einen Wert ab, der angibt, ob der Zugriff auf die ICollection synchronisiert ist. (Geerbt von BaseCollection)
Item[Int32]	Ruft den Binding am angegebenen Index ab. (Geerbt von BindingsCollection)
Item[String]	Ruft die durch den Eigenschaftennamen des Steuerelements angegebene Binding ab.
List	Ruft die Bindungen in der Auflistung als Objekt ab. (Geerbt von BindingsCollection)
SyncRoot	Ruft ein Objekt ab, mit dem der Zugriff auf BaseCollection synchronisiert werden kann. (Geerbt von BaseCollection)

Methoden

Add(Binding)	Fügt der Auflistung den angegebenen Binding hinzu.
Add(String, Object, String)	Erstellt anhand des angegebenen Namens der Steuerelementeigenschaft, der angegebenen Datenquelle und des angegebenen Datenmembers ein Binding und fügt dieses der Auflistung hinzu.
Add(String, Object, String, Boolean)	Erstellt eine Bindung mit dem angegebenen Steuerelement-Eigenschaftennamen, der angegebenen Datenquelle, dem angegebenen Datenmember und den angegebenen Informationen dazu, ob die Formatierung aktiviert ist, und fügt der Auflistung diese Bindung hinzu.
Add(String, Object, String, Boolean, DataSourceUpdateMode)	Erstellt eine Bindung, die die angegebene Steuerelementeigenschaft an den angegebenen Datenmember der angegebenen Datenquelle bindet, wodurch optional die Formatierung aktiviert wird, Werte basierend auf der angegebenen Aktualisierungseinstellung an die Datenquelle weitergegeben werden und der Auflistung die Bindung hinzugefügt wird.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object)	Erstellt eine Bindung, die die angegebene Steuerelementeigenschaft an den angegebenen Datenmember der angegebenen Datenquelle bindet, wodurch optional die Formatierung aktiviert wird, Werte basierend auf der angegebenen Aktualisierungseinstellung an die Datenquelle weitergegeben werden, die Eigenschaft auf den angegebenen Wert festgelegt wird, wenn DBNull aus der Datenquelle zurückgegeben wird und der Auflistung die Bindung hinzugefügt wird.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)	Erstellt eine Bindung, die die angegebene Steuerelementeigenschaft an den angegebenen Datenmember der angegebenen Datenquelle bindet, wodurch optional die Formatierung mit der angegebenen Formatzeichenfolge aktiviert wird, Werte basierend auf der angegebenen Aktualisierungseinstellung an die Datenquelle weitergegeben werden, die Eigenschaft auf den angegebenen Wert festgelegt wird, wenn DBNull aus der Datenquelle zurückgegeben wird und der Auflistung die Bindung hinzugefügt wird.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)	Erstellt eine Bindung, die die angegebene Steuerelementeigenschaft an den angegebenen Datenmember der angegebenen Datenquelle bindet, wodurch optional die Formatierung mit der angegebenen Formatzeichenfolge aktiviert wird, Werte basierend auf der angegebenen Aktualisierungseinstellung an die Datenquelle weitergegeben werden, die Eigenschaft auf den angegebenen Wert festgelegt wird, wenn DBNull aus der Datenquelle zurückgegeben wird, der angegebene Formatanbieter festgelegt wird und der Auflistung die Bindung hinzugefügt wird.
AddCore(Binding)	Fügt der Auflistung eine Bindung hinzu.
Clear()	Löscht sämtliche Bindungen aus der Auflistung.
ClearCore()	Löscht die Bindungen in der Auflistung.
CopyTo(Array, Int32)	Kopiert alle Elemente des aktuellen eindimensionalen Array in das angegebene eindimensionale Array, beginnend am angegebenen Index des Ziel-Array. (Geerbt von BaseCollection)
CreateObjRef(Type)	Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetEnumerator()	Ruft das Objekt ab, mit dem die Member der Auflistung durchlaufen werden können. (Geerbt von BaseCollection)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
InitializeLifetimeService()	Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)	Löst das CollectionChanged-Ereignis aus. (Geerbt von BindingsCollection)
OnCollectionChanging(CollectionChangeEventArgs)	Löst das CollectionChanging-Ereignis aus. (Geerbt von BindingsCollection)
Remove(Binding)	Löscht die angegebene Binding aus der Auflistung.
RemoveAt(Int32)	Löscht die Binding am angegebenen Index.
RemoveCore(Binding)	Entfernt die angegebene Bindung aus der Auflistung.
ShouldSerializeMyAll()	Ruft einen Wert ab, der angibt, ob die Auflistung serialisiert werden soll. (Geerbt von BindingsCollection)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Ereignisse

CollectionChanged	Tritt ein, wenn die Auflistung geändert wurde. (Geerbt von BindingsCollection)
CollectionChanging	Tritt ein, wenn sich die Auflistung gerade ändert. (Geerbt von BindingsCollection)

Erweiterungsmethoden