CurrencyManager Klasse

Definition

Verwaltet eine Liste von Binding-Objekten.Manages a list of Binding objects.

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
CurrencyManager

Beispiele

Im folgenden Codebeispiel wird ein TextBox-Steuerelement an eine-Spalte in einem-DataTablegebunden, der CurrencyManager für die Bindung abgerufen und seine Position festgelegt.The following code example binds a TextBox control to a column in a DataTable, gets the CurrencyManager for the binding, and sets its position.

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

Die CurrencyManager wird von der BindingManagerBase-Klasse abgeleitet.The CurrencyManager derives from the BindingManagerBase class. Verwenden Sie die BindingContext, um entweder eine CurrencyManager oder eine PropertyManagerzurückzugeben.Use the BindingContext to return either a CurrencyManager or a PropertyManager. Das tatsächlich zurückgegebene Objekt hängt von der Datenquelle und dem Datenmember ab, die an die Item[Object]-Eigenschaft des BindingContextweitergegeben wurden.The actual object returned depends on the data source and data member passed to the Item[Object] property of the BindingContext. Wenn die Datenquelle ein Objekt ist, das nur eine einzelne Eigenschaft (anstelle einer Liste von Objekten) zurückgeben kann, ist der Typ ein PropertyManager.If the data source is an object that can return only a single property (instead of a list of objects), the type will be a PropertyManager. Wenn Sie z. b. eine TextBox als Datenquelle angeben, wird ein PropertyManager zurückgegeben.For example, if you specify a TextBox as the data source, a PropertyManager will be returned. Wenn andererseits die Datenquelle ein Objekt ist, das die IList-, IListSource-oder IBindingList-Schnittstelle implementiert, wird eine CurrencyManager zurückgegeben.If, on the other hand, the data source is an object that implements the IList, IListSource, or IBindingList interface, a CurrencyManager will be returned.

Die Current-Eigenschaft gibt das aktuelle Element in der zugrunde liegenden Liste zurück.The Current property returns the current item in the underlying list. Um das aktuelle Element zu ändern, legen Sie die Position-Eigenschaft auf einen neuen Wert fest.To change the current item, set the Position property to a new value. Der Wert muss größer als 0 sein und muss kleiner sein als der Wert der Count-Eigenschaft.The value must be greater than 0 and must be less than the value of the Count property.

Wenn die zugrunde liegende Datenquelle die IBindingList-Schnittstelle implementiert und die AllowNew-Eigenschaft auf truefestgelegt ist, können Sie die AddNew-Methode verwenden.If the underlying data source implements the IBindingList interface, and the AllowNew property is set to true, you can use the AddNew method.

Felder

finalType

Gibt den Datentyp der Liste an.Specifies the data type of the list.

listposition

Gibt die aktuelle Position von CurrencyManager in der Liste an.Specifies the current position of the CurrencyManager in the list.

onCurrentChangedHandler

Gibt den Ereignishandler für das CurrentChanged-Ereignis an.Specifies the event handler for the CurrentChanged event.

(Geerbt von BindingManagerBase)
onPositionChangedHandler

Gibt den Ereignishandler für das PositionChanged-Ereignis an.Specifies the event handler for the PositionChanged event.

(Geerbt von BindingManagerBase)

Eigenschaften

Bindings

Ruft die Auflistung verwalteter Bindungen ab.Gets the collection of bindings being managed.

(Geerbt von BindingManagerBase)
Count

Ruft die Anzahl der Elemente in der Liste ab.Gets the number of items in the list.

Current

Ruft das aktuelle Element in der Liste ab.Gets the current item in the list.

IsBindingSuspended

Ruft einen Wert ab, der angibt, ob die Bindung aufgehoben ist.Gets a value indicating whether binding is suspended.

(Geerbt von BindingManagerBase)
List

Ruft die Liste für diesen CurrencyManager ab.Gets the list for this CurrencyManager.

Position

Ruft die Position ab, an der Sie sich in der Liste befinden, oder legt diese Position fest.Gets or sets the position you are at within the list.

Methoden

AddNew()

Fügt der zugrunde liegenden Liste ein neues Element hinzu.Adds a new item to the underlying list.

CancelCurrentEdit()

Bricht den aktuellen Bearbeitungsvorgang ab.Cancels the current edit operation.

CheckEmpty()

Löst eine Ausnahme aus, wenn keine Liste vorhanden bzw. wenn die Liste leer ist.Throws an exception if there is no list, or the list is empty.

EndCurrentEdit()

Beendet die aktuelle Bearbeitungsoperation.Ends the current edit operation.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetItemProperties()

Ruft die Eigenschaftendeskriptorauflistung für die zugrunde liegende Liste ab.Gets the property descriptor collection for the underlying list.

GetItemProperties(ArrayList, ArrayList)

Ruft mithilfe der angegebenen ArrayList die Auflistung von Eigenschaftenbezeichnern für die Bindung ab.Gets the collection of property descriptors for the binding using the specified ArrayList.

(Geerbt von BindingManagerBase)
GetItemProperties(Type, Int32, ArrayList, ArrayList)

Ruft die Liste der Eigenschaften für die Elemente ab, die von dieser BindingManagerBase verwaltet werden.Gets the list of properties of the items managed by this BindingManagerBase.

(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.Gets the name of the list supplying the data for the binding using the specified set of bound properties.

GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
OnBindingComplete(BindingCompleteEventArgs)

Löst das Ereignis BindingComplete aus.Raises the BindingComplete event.

(Geerbt von BindingManagerBase)
OnCurrentChanged(EventArgs)

Löst das Ereignis CurrentChanged aus.Raises the CurrentChanged event.

OnCurrentItemChanged(EventArgs)

Löst das Ereignis CurrentItemChanged aus.Raises the CurrentItemChanged event.

OnDataError(Exception)

Löst das Ereignis DataError aus.Raises the DataError event.

(Geerbt von BindingManagerBase)
OnItemChanged(ItemChangedEventArgs)

Löst das Ereignis ItemChanged aus.Raises the ItemChanged event.

OnMetaDataChanged(EventArgs)

Löst das Ereignis MetaDataChanged aus.Raises the MetaDataChanged event.

OnPositionChanged(EventArgs)

Löst das Ereignis PositionChanged aus.Raises the PositionChanged event.

PullData()

Zieht Daten aus dem datengebundenen Steuerelement in die Datenquelle und gibt dabei keine Informationen zurück.Pulls data from the data-bound control into the data source, returning no information.

(Geerbt von BindingManagerBase)
PushData()

Legt Daten aus der Datenquelle im datengebundenen Steuerelement ab und gibt dabei keine Informationen zurück.Pushes data from the data source into the data-bound control, returning no information.

(Geerbt von BindingManagerBase)
Refresh()

Erzwingt ein erneutes Auffüllen der datengebundenen Liste.Forces a repopulation of the data-bound list.

RemoveAt(Int32)

Entfernt das Element am angegebenen Index.Removes the item at the specified index.

ResumeBinding()

Setzt die Datenbindung fort.Resumes data binding.

SuspendBinding()

Unterbricht die Datenbindung, sodass die gebundene Datenquelle nicht durch Änderungen aktualisiert werden kann.Suspends data binding to prevents changes from updating the bound data source.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)
UpdateIsBinding()

Aktualisiert den Status der Bindung.Updates the status of the binding.

Ereignisse

BindingComplete

Tritt nach Abschluss eines Datenbindungsvorgangs ein.Occurs at the completion of a data-binding operation.

(Geerbt von BindingManagerBase)
CurrentChanged

Tritt ein, wenn das derzeit gebundene Element geändert wird.Occurs when the currently bound item changes.

(Geerbt von BindingManagerBase)
CurrentItemChanged

Tritt ein, wenn sich der Zustand des momentan gebundenen Elements ändert.Occurs when the state of the currently bound item changes.

(Geerbt von BindingManagerBase)
DataError

Tritt ein, wenn eine Exception automatisch durch die BindingManagerBase behandelt wird.Occurs when an Exception is silently handled by the BindingManagerBase.

(Geerbt von BindingManagerBase)
ItemChanged

Tritt ein, wenn das aktuelle Element geändert wurde.Occurs when the current item has been altered.

ListChanged

Tritt ein, wenn die Liste oder ein Element der Liste geändert wird.Occurs when the list changes or an item in the list changes.

MetaDataChanged

Tritt ein, wenn Metadaten der List geändert wurden.Occurs when the metadata of the List has changed.

PositionChanged

Tritt ein, nachdem sich der Wert der Position-Eigenschaft geändert hat.Occurs after the value of the Position property has changed.

(Geerbt von BindingManagerBase)

Gilt für:

Siehe auch