Freigeben über


ControlBindingsCollection Klasse

Definition

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=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
Vererbung
Attribute

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

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

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

Cast<TResult>(IEnumerable)

Wandelt die Elemente eines IEnumerable in den angegebenen Typ um

OfType<TResult>(IEnumerable)

Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs

AsParallel(IEnumerable)

Ermöglicht die Parallelisierung einer Abfrage.

AsQueryable(IEnumerable)

Konvertiert einen IEnumerable in einen IQueryable.

Gilt für: