CurrencyManager Klasse

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Verwaltet eine Liste von Binding-Objekten.

public ref class CurrencyManager : System::Windows::Forms::BindingManagerBase

public class CurrencyManager : System.Windows.Forms.BindingManagerBase

type CurrencyManager = class
    inherit BindingManagerBase

Public Class CurrencyManager
Inherits BindingManagerBase

Vererbung

Object

BindingManagerBase

CurrencyManager

Beispiele

Im folgenden Codebeispiel wird ein TextBox Steuerelement an eine Spalte in einem DataTablegebunden, ruft die CurrencyManager für die Bindung ab und legt dessen Position fest.

CurrencyManager^ myCurrencyManager;
void BindControl( DataTable^ myTable )
{
   
   // Bind a TextBox control to a DataTable column in a DataSet.
   textBox1->DataBindings->Add( "Text", myTable, "CompanyName" );
   
   // Specify the CurrencyManager for the DataTable.
   this->myCurrencyManager = dynamic_cast<CurrencyManager^>(this->BindingContext[ myTable ]);
   
   // Set the initial Position of the control.
   this->myCurrencyManager->Position = 0;
}

void MoveNext( CurrencyManager^ myCurrencyManager )
{
   if ( myCurrencyManager->Position == myCurrencyManager->Count - 1 )
   {
      MessageBox::Show( "You're at end of the records" );
   }
   else
   {
      myCurrencyManager->Position += 1;
   }
}

void MoveFirst( CurrencyManager^ myCurrencyManager )
{
   myCurrencyManager->Position = 0;
}

void MovePrevious( CurrencyManager^ myCurrencyManager )
{
   if ( myCurrencyManager->Position == 0 )
   {
      MessageBox::Show( "You're at the beginning of the records." );
   }
   else
   {
      myCurrencyManager->Position -= 1;
   }
}

void MoveLast( CurrencyManager^ myCurrencyManager )
{
   myCurrencyManager->Position = myCurrencyManager->Count - 1;
}

private CurrencyManager myCurrencyManager;
 
 private void BindControl(DataTable myTable){
    // Bind a TextBox control to a DataTable column in a DataSet.
    textBox1.DataBindings.Add("Text", myTable, "CompanyName");
    // Specify the CurrencyManager for the DataTable.
    myCurrencyManager = (CurrencyManager)this.BindingContext[myTable];
    // Set the initial Position of the control.
    myCurrencyManager.Position = 0;
 }
 
 private void MoveNext(CurrencyManager myCurrencyManager){
    if (myCurrencyManager.Position == myCurrencyManager.Count - 1){
       MessageBox.Show("You're at end of the records");
    }
    else{
      myCurrencyManager.Position += 1;
    }
 }
 
 private void MoveFirst(CurrencyManager myCurrencyManager){
    myCurrencyManager.Position = 0;
 }
 
 private void MovePrevious(CurrencyManager myCurrencyManager ){
    if(myCurrencyManager.Position == 0) {
       MessageBox.Show("You're at the beginning of the records.");
    }   
    else{
       myCurrencyManager.Position -= 1;
    }
 }
 
 private void MoveLast(CurrencyManager myCurrencyManager){
    myCurrencyManager.Position = myCurrencyManager.Count - 1;
 }

' Place the next line into the Declarations section of the form.
 Private myCurrencyManager As CurrencyManager
 
 Private Sub BindControl(myTable As DataTable)
    ' Bind a TextBox control to a DataTable column in a DataSet.
    TextBox1.DataBindings.Add("Text", myTable, "CompanyName")
    ' Specify the CurrencyManager for the DataTable.
    myCurrencyManager = CType(me.BindingContext(myTable), CurrencyManager)
    ' Set the initial Position of the control.
    myCurrencyManager.Position = 0
 End Sub
 
 Private Sub MoveNext(myCurrencyManager As CurrencyManager)
    If myCurrencyManager.Position = myCurrencyManager.Count - 1 Then 
       MessageBox.Show("You're at end of the records")
    Else
       myCurrencyManager.Position += 1
    End If
 End Sub
 
 Private Sub MoveFirst(myCurrencyManager As CurrencyManager)
    myCurrencyManager.Position = 0
 End Sub
 
 Private Sub MovePrevious(myCurrencyManager As CurrencyManager)
    If myCurrencyManager.Position = 0 Then
       MessageBox.Show("You're at the beginning of the records.")
    Else
       myCurrencyManager.Position -= 1
    End if
 End Sub
 
 Private Sub MoveLast(myCurrencyManager As CurrencyManager)
    myCurrencyManager.Position = myCurrencyManager.Count - 1
 End Sub

Hinweise

Der CurrencyManager wird von der BindingManagerBase -Klasse abgeleitet. Verwenden Sie , BindingContext um entweder einen CurrencyManager oder einen PropertyManagerzurückzugeben. Das tatsächlich zurückgegebene Objekt hängt von der Datenquelle und dem Datenmember ab, die an die Item[] -Eigenschaft des BindingContextübergeben werden. Wenn es sich bei der Datenquelle um ein Objekt handelt, das nur eine einzelne Eigenschaft (anstelle einer Liste von Objekten) zurückgeben kann, ist der Typ ein PropertyManager. Wenn Sie beispielsweise ein TextBox als Datenquelle angeben, wird ein PropertyManager zurückgegeben. Wenn die Datenquelle hingegen ein Objekt ist, das die IListSchnittstelle , IListSourceoder IBindingList implementiert, wird zurückgegeben CurrencyManager .

Die Current -Eigenschaft gibt das aktuelle Element in der zugrunde liegenden Liste zurück. Um das aktuelle Element zu ändern, legen Sie die Position -Eigenschaft auf einen neuen Wert fest. Der Wert muss größer als 0 und kleiner als der Wert der Count -Eigenschaft sein.

Wenn die zugrunde liegende Datenquelle die IBindingList -Schnittstelle implementiert und die AllowNew -Eigenschaft auf truefestgelegt ist, können Sie die AddNew -Methode verwenden.

Felder

finalType	Gibt den Datentyp der Liste an.
listposition	Gibt die aktuelle Position von CurrencyManager in der Liste an.
onCurrentChangedHandler	Gibt den Ereignishandler für das CurrentChanged-Ereignis an. (Geerbt von BindingManagerBase)
onPositionChangedHandler	Gibt den Ereignishandler für das PositionChanged-Ereignis an. (Geerbt von BindingManagerBase)

Eigenschaften

Bindings	Ruft die Auflistung verwalteter Bindungen ab. (Geerbt von BindingManagerBase)
Count	Ruft die Anzahl der Elemente in der Liste ab.
Current	Ruft das aktuelle Element in der Liste ab.
IsBindingSuspended	Ruft einen Wert ab, der angibt, ob die Bindung aufgehoben ist. (Geerbt von BindingManagerBase)
List	Ruft die Liste für diesen CurrencyManager ab.
Position	Ruft die Position ab, an der Sie sich in der Liste befinden, oder legt diese Position fest.

Methoden

AddNew()	Fügt der zugrunde liegenden Liste ein neues Element hinzu.
CancelCurrentEdit()	Bricht den aktuellen Bearbeitungsvorgang ab.
CheckEmpty()	Löst eine Ausnahme aus, wenn keine Liste vorhanden bzw. wenn die Liste leer ist.
EndCurrentEdit()	Beendet die aktuelle Bearbeitungsoperation.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetItemProperties()	Ruft die Eigenschaftendeskriptorauflistung für die zugrunde liegende Liste ab.
GetItemProperties(ArrayList, ArrayList)	Ruft mithilfe der angegebenen ArrayList die Auflistung von Eigenschaftenbezeichnern für die Bindung ab. (Geerbt von BindingManagerBase)
GetItemProperties(Type, Int32, ArrayList, ArrayList)	Ruft die Liste der Eigenschaften für die Elemente ab, die von dieser BindingManagerBase verwaltet werden. (Geerbt von BindingManagerBase)
GetListName(ArrayList)	Ruft den Namen der Liste ab, die mithilfe der angegebenen Gruppe gebundener Eigenschaften die Daten für die Bindung bereitstellt.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnBindingComplete(BindingCompleteEventArgs)	Löst das BindingComplete-Ereignis aus. (Geerbt von BindingManagerBase)
OnCurrentChanged(EventArgs)	Löst das CurrentChanged-Ereignis aus.
OnCurrentItemChanged(EventArgs)	Löst das CurrentItemChanged-Ereignis aus.
OnDataError(Exception)	Löst das DataError-Ereignis aus. (Geerbt von BindingManagerBase)
OnItemChanged(ItemChangedEventArgs)	Löst das ItemChanged-Ereignis aus.
OnMetaDataChanged(EventArgs)	Löst das MetaDataChanged-Ereignis aus.
OnPositionChanged(EventArgs)	Löst das PositionChanged-Ereignis aus.
PullData()	Zieht Daten aus dem datengebundenen Steuerelement in die Datenquelle und gibt dabei keine Informationen zurück. (Geerbt von BindingManagerBase)
PushData()	Legt Daten aus der Datenquelle im datengebundenen Steuerelement ab und gibt dabei keine Informationen zurück. (Geerbt von BindingManagerBase)
Refresh()	Erzwingt ein erneutes Auffüllen der datengebundenen Liste.
RemoveAt(Int32)	Entfernt das Element am angegebenen Index.
ResumeBinding()	Setzt die Datenbindung fort.
SuspendBinding()	Unterbricht die Datenbindung, sodass die gebundene Datenquelle nicht durch Änderungen aktualisiert werden kann.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
UpdateIsBinding()	Aktualisiert den Status der Bindung.

Ereignisse

BindingComplete	Tritt nach Abschluss eines Datenbindungsvorgangs ein. (Geerbt von BindingManagerBase)
CurrentChanged	Tritt ein, wenn das derzeit gebundene Element geändert wird. (Geerbt von BindingManagerBase)
CurrentItemChanged	Tritt ein, wenn sich der Zustand des momentan gebundenen Elements ändert. (Geerbt von BindingManagerBase)
DataError	Tritt ein, wenn eine Exception automatisch durch die BindingManagerBase behandelt wird. (Geerbt von BindingManagerBase)
ItemChanged	Tritt ein, wenn das aktuelle Element geändert wurde.
ListChanged	Tritt ein, wenn die Liste oder ein Element der Liste geändert wird.
MetaDataChanged	Tritt ein, wenn Metadaten der List geändert wurden.
PositionChanged	Tritt ein, nachdem sich der Wert der Position-Eigenschaft geändert hat. (Geerbt von BindingManagerBase)

Weitere Informationen

• BindingsCollection
• BindingContext
• Binding