CurrencyManager CurrencyManager CurrencyManager CurrencyManager Class

Définition

Gère une liste d'objets Binding.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
Héritage

Exemples

L’exemple de code suivant lie un TextBox contrôle à une colonne dans un DataTable, obtient le CurrencyManager pour la liaison et définit sa position.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

Remarques

Le CurrencyManager dérive de la BindingManagerBase classe.The CurrencyManager derives from the BindingManagerBase class. Utilisez pour retourner un CurrencyManager ou un PropertyManager. BindingContextUse the BindingContext to return either a CurrencyManager or a PropertyManager. L’objet réel retourné dépend de la source Item[Object] BindingContextde données et des données membres passées à la propriété de.The actual object returned depends on the data source and data member passed to the Item[Object] property of the BindingContext. Si la source de données est un objet qui ne peut retourner qu’une seule propriété (au lieu d’une liste d’objets), le type PropertyManagerest.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. Par exemple, si vous spécifiez TextBox un comme source de données, PropertyManager un est retourné.For example, if you specify a TextBox as the data source, a PropertyManager will be returned. En revanche, si la source de données est un objet qui IListimplémente l’interface, IListSourceou IBindingList , une CurrencyManager est retournée.If, on the other hand, the data source is an object that implements the IList, IListSource, or IBindingList interface, a CurrencyManager will be returned.

La Current propriété retourne l’élément actuel dans la liste sous-jacente.The Current property returns the current item in the underlying list. Pour modifier l’élément actuel, affectez Position une nouvelle valeur à la propriété.To change the current item, set the Position property to a new value. La valeur doit être supérieure à 0 et doit être inférieure à la valeur de la Count propriété.The value must be greater than 0 and must be less than the value of the Count property.

Si la source de données sous-jacente IBindingList implémente l’interface AllowNew et que la propriété truea la valeur, vous AddNew pouvez utiliser la méthode.If the underlying data source implements the IBindingList interface, and the AllowNew property is set to true, you can use the AddNew method.

Champs

finalType finalType finalType finalType

Spécifie le type de données de la liste.Specifies the data type of the list.

listposition listposition listposition listposition

Spécifie la position actuelle de CurrencyManager dans la liste.Specifies the current position of the CurrencyManager in the list.

onCurrentChangedHandler onCurrentChangedHandler onCurrentChangedHandler onCurrentChangedHandler

Spécifie le gestionnaire d'événements pour l'événement CurrentChanged.Specifies the event handler for the CurrentChanged event.

(Inherited from BindingManagerBase)
onPositionChangedHandler onPositionChangedHandler onPositionChangedHandler onPositionChangedHandler

Spécifie le gestionnaire d'événements pour l'événement PositionChanged.Specifies the event handler for the PositionChanged event.

(Inherited from BindingManagerBase)

Propriétés

Bindings Bindings Bindings Bindings

Extrait la collection des liaisons managées.Gets the collection of bindings being managed.

(Inherited from BindingManagerBase)
Count Count Count Count

Obtient le nombre d'éléments contenus dans la liste.Gets the number of items in the list.

Current Current Current Current

Obtient l'élément en cours dans la liste.Gets the current item in the list.

IsBindingSuspended IsBindingSuspended IsBindingSuspended IsBindingSuspended

Obtient une valeur indiquant si la liaison est suspendue.Gets a value indicating whether binding is suspended.

(Inherited from BindingManagerBase)
List List List List

Obtient la liste de ce CurrencyManager.Gets the list for this CurrencyManager.

Position Position Position Position

Obtient ou définit votre position dans la liste.Gets or sets the position you are at within the list.

Méthodes

AddNew() AddNew() AddNew() AddNew()

Ajoute un nouvel élément à la liste sous-jacente.Adds a new item to the underlying list.

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

Annule l'opération de modification actuelle.Cancels the current edit operation.

CheckEmpty() CheckEmpty() CheckEmpty() CheckEmpty()

Lève une exception s'il n'existe aucune liste ou si la liste est vide.Throws an exception if there is no list, or the list is empty.

EndCurrentEdit() EndCurrentEdit() EndCurrentEdit() EndCurrentEdit()

Met fin à l'opération de modification en cours.Ends the current edit operation.

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

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

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

Fait office de fonction de hachage par défaut.Serves as the default hash function.

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

Obtient la collection de descripteurs de propriété pour la liste sous-jacente.Gets the property descriptor collection for the underlying list.

GetItemProperties(ArrayList, ArrayList) GetItemProperties(ArrayList, ArrayList) GetItemProperties(ArrayList, ArrayList) GetItemProperties(ArrayList, ArrayList)

Obtient la collection des descripteurs de propriété pour la liaison en utilisant l'objet ArrayList spécifié.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)

Obtient la liste des propriétés des éléments managés par ce BindingManagerBase.Gets the list of properties of the items managed by this BindingManagerBase.

(Inherited from BindingManagerBase)
GetListName(ArrayList) GetListName(ArrayList) GetListName(ArrayList) GetListName(ArrayList)

Obtient le nom de la liste fournissant les données pour la liaison à l'aide du jeu de propriétés liées spécifié.Gets the name of the list supplying the data for the binding using the specified set of bound properties.

GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

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

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

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

Déclenche l'événement BindingComplete.Raises the BindingComplete event.

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

Déclenche l'événement CurrentChanged.Raises the CurrentChanged event.

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

Déclenche l'événement CurrentItemChanged.Raises the CurrentItemChanged event.

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

Déclenche l'événement DataError.Raises the DataError event.

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

Déclenche l'événement ItemChanged.Raises the ItemChanged event.

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

Déclenche l'événement MetaDataChanged.Raises the MetaDataChanged event.

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

Déclenche l'événement PositionChanged.Raises the PositionChanged event.

PullData() PullData() PullData() PullData()

Extrait des données du contrôle lié aux données vers la source de données sans retourner d'informations.Pulls data from the data-bound control into the data source, returning no information.

(Inherited from BindingManagerBase)
PushData() PushData() PushData() PushData()

Exécute un push à partir de la source de données dans le contrôle lié aux données, sans retourner d'informations.Pushes data from the data source into the data-bound control, returning no information.

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

Force un nouveau remplissage de la liste liée aux données.Forces a repopulation of the data-bound list.

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

Supprime l'élément au niveau de l'index spécifié.Removes the item at the specified index.

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

Relance la liaison de données.Resumes data binding.

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

Suspend la liaison de données pour empêcher que les modifications mettent à jour la source de données liée.Suspends data binding to prevents changes from updating the bound data source.

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

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

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

Met à jour l'état de la liaison.Updates the status of the binding.

Événements

BindingComplete BindingComplete BindingComplete BindingComplete

Se produit à la fin d'une opération de liaison de données.Occurs at the completion of a data-binding operation.

(Inherited from BindingManagerBase)
CurrentChanged CurrentChanged CurrentChanged CurrentChanged

Se produit quand l'élément actuellement lié change.Occurs when the currently bound item changes.

(Inherited from BindingManagerBase)
CurrentItemChanged CurrentItemChanged CurrentItemChanged CurrentItemChanged

Se produit quand l'état de l'élément lié aux données est modifié.Occurs when the state of the currently bound item changes.

(Inherited from BindingManagerBase)
DataError DataError DataError DataError

Se produit lorsqu'un Exception est géré silencieusement par le BindingManagerBase.Occurs when an Exception is silently handled by the BindingManagerBase.

(Inherited from BindingManagerBase)
ItemChanged ItemChanged ItemChanged ItemChanged

Se produit suite à la modification de l'élément en cours.Occurs when the current item has been altered.

ListChanged ListChanged ListChanged ListChanged

Se produit en cas de modification de la liste ou d'un de ses éléments.Occurs when the list changes or an item in the list changes.

MetaDataChanged MetaDataChanged MetaDataChanged MetaDataChanged

Se produit lorsque les métadonnées de la propriété List ont changé.Occurs when the metadata of the List has changed.

PositionChanged PositionChanged PositionChanged PositionChanged

Se produit une fois que la valeur de la propriété Position a été modifiée.Occurs after the value of the Position property has changed.

(Inherited from BindingManagerBase)

S’applique à

Voir aussi