CurrencyManager CurrencyManager CurrencyManager CurrencyManager Class

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

Beispiele

Im folgenden Codebeispiel wird ein TextBox -Steuerelement an eine- DataTableSpalte in einer CurrencyManager gebunden, das-Element 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

Der CurrencyManager wird von der BindingManagerBase -Klasse abgeleitet.The CurrencyManager derives from the BindingManagerBase class. Verwenden Sie, um CurrencyManager entweder oder PropertyManagerzurückzugeben. BindingContextUse 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 Item[Object] , die an BindingContextdie-Eigenschaft von weitergegeben 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 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. TextBox als Datenquelle angeben, wird eine 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 IList, das die-, 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 Position Sie die-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 AllowNew und die-Eigenschaft trueauf festgelegt ist, AddNew können Sie die-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 finalType finalType finalType

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

listposition listposition listposition listposition

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

onCurrentChangedHandler onCurrentChangedHandler onCurrentChangedHandler onCurrentChangedHandler

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

(Inherited from BindingManagerBase)
onPositionChangedHandler onPositionChangedHandler onPositionChangedHandler onPositionChangedHandler

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

(Inherited from BindingManagerBase)

Eigenschaften

Bindings Bindings Bindings Bindings

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

(Inherited from BindingManagerBase)
Count Count Count Count

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

Current Current Current Current

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

IsBindingSuspended IsBindingSuspended IsBindingSuspended IsBindingSuspended

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

(Inherited from BindingManagerBase)
List List List List

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

Position Position Position 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() AddNew() AddNew() AddNew()

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

CancelCurrentEdit() CancelCurrentEdit() CancelCurrentEdit() CancelCurrentEdit()

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

CheckEmpty() CheckEmpty() CheckEmpty() 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() EndCurrentEdit() EndCurrentEdit() EndCurrentEdit()

Beendet die aktuelle Bearbeitungsoperation.Ends the current edit operation.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetItemProperties() GetItemProperties() GetItemProperties() GetItemProperties()

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

GetItemProperties(ArrayList, ArrayList) GetItemProperties(ArrayList, ArrayList) GetItemProperties(ArrayList, ArrayList) 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.

(Inherited from BindingManagerBase)
GetItemProperties(Type, Int32, ArrayList, ArrayList) GetItemProperties(Type, Int32, ArrayList, ArrayList) GetItemProperties(Type, Int32, ArrayList, ArrayList) 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.

(Inherited from BindingManagerBase)
GetListName(ArrayList) GetListName(ArrayList) GetListName(ArrayList) 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() GetType() GetType() GetType()

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

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
OnBindingComplete(BindingCompleteEventArgs) OnBindingComplete(BindingCompleteEventArgs) OnBindingComplete(BindingCompleteEventArgs) OnBindingComplete(BindingCompleteEventArgs)

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

(Inherited from BindingManagerBase)
OnCurrentChanged(EventArgs) OnCurrentChanged(EventArgs) OnCurrentChanged(EventArgs) OnCurrentChanged(EventArgs)

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

OnCurrentItemChanged(EventArgs) OnCurrentItemChanged(EventArgs) OnCurrentItemChanged(EventArgs) OnCurrentItemChanged(EventArgs)

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

OnDataError(Exception) OnDataError(Exception) OnDataError(Exception) OnDataError(Exception)

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

(Inherited from BindingManagerBase)
OnItemChanged(ItemChangedEventArgs) OnItemChanged(ItemChangedEventArgs) OnItemChanged(ItemChangedEventArgs) OnItemChanged(ItemChangedEventArgs)

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

OnMetaDataChanged(EventArgs) OnMetaDataChanged(EventArgs) OnMetaDataChanged(EventArgs) OnMetaDataChanged(EventArgs)

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

OnPositionChanged(EventArgs) OnPositionChanged(EventArgs) OnPositionChanged(EventArgs) OnPositionChanged(EventArgs)

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

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

(Inherited from BindingManagerBase)
PushData() PushData() PushData() 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.

(Inherited from BindingManagerBase)
Refresh() Refresh() Refresh() Refresh()

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

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

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

ResumeBinding() ResumeBinding() ResumeBinding() ResumeBinding()

Setzt die Datenbindung fort.Resumes data binding.

SuspendBinding() SuspendBinding() SuspendBinding() SuspendBinding()

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

ToString() ToString() ToString() ToString()

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

(Inherited from Object)
UpdateIsBinding() UpdateIsBinding() UpdateIsBinding() UpdateIsBinding()

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

Ereignisse

BindingComplete BindingComplete BindingComplete BindingComplete

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

(Inherited from BindingManagerBase)
CurrentChanged CurrentChanged CurrentChanged CurrentChanged

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

(Inherited from BindingManagerBase)
CurrentItemChanged CurrentItemChanged CurrentItemChanged CurrentItemChanged

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

(Inherited from BindingManagerBase)
DataError DataError DataError DataError

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

(Inherited from BindingManagerBase)
ItemChanged ItemChanged ItemChanged ItemChanged

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

ListChanged ListChanged ListChanged 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 MetaDataChanged MetaDataChanged MetaDataChanged

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

PositionChanged PositionChanged PositionChanged PositionChanged

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

(Inherited from BindingManagerBase)

Gilt für:

Siehe auch