BindingsCollection Klasse

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Stellt eine Auflistung von Binding-Objekten für ein Steuerelement dar.

public ref class BindingsCollection : System::Windows::Forms::BaseCollection

public class BindingsCollection : System.Windows.Forms.BaseCollection

type BindingsCollection = class
    inherit BaseCollection

Public Class BindingsCollection
Inherits BaseCollection

Vererbung

Object

MarshalByRefObject

BaseCollection

BindingsCollection

Abgeleitet

System.Windows.Forms.ControlBindingsCollection

Beispiele

Im folgenden Beispiel wird die Text -Eigenschaft eines TextBox Steuerelements an ein Feld in einer Datenbank gebunden.

private:
   void BindTextBoxControl()
   {
      DataSet^ myDataSet = gcnew DataSet;
      /* Insert code to populate the DataSet with tables, 
      columns, and data. */

      // Creates a new Binding object. 
      Binding^ myBinding = gcnew Binding(
         "Text",myDataSet,"customers.custToOrders.OrderAmount" );
      
      // Adds event delegates for the Parse and Format events.
      myBinding->Parse += gcnew ConvertEventHandler( this, &Form1::CurrencyToDecimal );
      myBinding->Format += gcnew ConvertEventHandler( this, &Form1::DecimalToCurrency );
      
      // Adds the new Binding to the BindingsCollection.
      text1->DataBindings->Add( myBinding );
   }

   void DecimalToCurrency( Object^ /*sender*/, ConvertEventArgs^ cevent )
   {
      /* This method is the Format event handler. Whenever the 
      control displays a new value, the value is converted from 
      its native Decimal type to a string. The ToString method 
      then formats the value as a Currency, by using the 
      formatting character "c". */
      cevent->Value = safe_cast<Decimal ^>(cevent->Value)->ToString(  "c" );
   }

   void CurrencyToDecimal( Object^ /*sender*/, ConvertEventArgs^ cevent )
   {
      /* This method is the Parse event handler. The Parse event 
      occurs whenever the displayed value changes. The static 
      Parse method of the Decimal structure converts the 
      string back to its native Decimal type. */
      cevent->Value = Decimal::Parse( cevent->Value->ToString(),
         NumberStyles::Currency, nullptr );
   }

private void BindTextBoxControl()
{
   DataSet myDataSet = new DataSet();
   /* Insert code to populate the DataSet with tables, 
   columns, and data. */

   // Creates a new Binding object. 
   Binding myBinding = new Binding
   ("Text", myDataSet, "customers.custToOrders.OrderAmount");

   // Adds event delegates for the Parse and Format events.
   myBinding.Parse += new ConvertEventHandler(CurrencyToDecimal);
   myBinding.Format += new ConvertEventHandler(DecimalToCurrency);

   // Adds the new Binding to the BindingsCollection.
   text1.DataBindings.Add(myBinding);
}

private void DecimalToCurrency(object sender, 
   ConvertEventArgs cevent)
{
   /* This method is the Format event handler. Whenever the 
   control displays a new value, the value is converted from 
   its native Decimal type to a string. The ToString method 
   then formats the value as a Currency, by using the 
   formatting character "c". */
   cevent.Value = ((decimal) cevent.Value).ToString("c");
}

private void CurrencyToDecimal(object sender, 
   ConvertEventArgs cevent)
{   
   /* This method is the Parse event handler. The Parse event 
   occurs whenever the displayed value changes. The static 
   Parse method of the Decimal structure converts the 
   string back to its native Decimal type. */
   cevent.Value = Decimal.Parse(cevent.Value.ToString(),
   NumberStyles.Currency, null);
}

Private Sub BindTextBoxControl()
   Dim myDataSet As New DataSet()
   ' Insert code to populate the DataSet with tables, columns, and data.

   ' Creates a new Binding object. 
   Dim myBinding As New Binding("Text", myDataSet, _
   "customers.custToOrders.OrderAmount")
   
   ' Adds event delegates for the Parse and Format events.
   AddHandler myBinding.Parse, AddressOf CurrencyToDecimal
   AddHandler myBinding.Format, AddressOf DecimalToCurrency
     
   ' Adds the new Binding to the BindingsCollection.
   text1.DataBindings.Add(myBinding)
End Sub 
    
Private Sub DecimalToCurrency(sender As Object, _
   cevent As ConvertEventArgs)
   ' This method is the Format event handler. Whenever the
   ' control displays a new value, the value is converted from
   ' its native Decimal type to a string. The ToString method
   ' then formats the value as a Currency, by using the
   ' formatting character "c". 
   cevent.Value = CDec(cevent.Value).ToString("c")
End Sub 
    
Private Sub CurrencyToDecimal(sender As Object, _
cevent As ConvertEventArgs)
   ' This method is the Parse event handler. The Parse event
   ' occurs whenever the displayed value changes. The static
   ' Parse method of the Decimal structure converts the 
   ' string back to its native Decimal type. 
   cevent.Value = Decimal.Parse(cevent.Value.ToString(), _
   NumberStyles.Currency, nothing)
   End Sub

Hinweise

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

Eigenschaften

Count	Ruft die Gesamtanzahl der Bindungen in der Auflistung ab.
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.
List	Ruft die Bindungen in der Auflistung als Objekt ab.
SyncRoot	Ruft ein Objekt ab, mit dem der Zugriff auf BaseCollection synchronisiert werden kann. (Geerbt von BaseCollection)

Methoden

Add(Binding)	Fügt der Auflistung die angegebene Bindung hinzu.
AddCore(Binding)	Fügt der Auflistung eine Binding hinzu.
Clear()	Löscht die Auflistung aus Bindungsobjekten.
ClearCore()	Löscht die Auflistung aller Member.
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.
OnCollectionChanging(CollectionChangeEventArgs)	Löst das CollectionChanging-Ereignis aus.
Remove(Binding)	Löscht die angegebene Bindung aus der Auflistung.
RemoveAt(Int32)	Löscht die Bindung am angegebenen Index aus der Auflistung.
RemoveCore(Binding)	Entfernt den angegebenen Binding aus der Auflistung.
ShouldSerializeMyAll()	Ruft einen Wert ab, der angibt, ob die Auflistung serialisiert werden soll.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Ereignisse

CollectionChanged	Tritt ein, wenn die Auflistung geändert wurde.
CollectionChanging	Tritt ein, wenn sich die Auflistung gerade ändert.

Erweiterungsmethoden

Weitere Informationen

• CurrencyManager