CurrencyManager Classe

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Gère une liste d'objets Binding.

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

Object

BindingManagerBase

CurrencyManager

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.

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

dérive CurrencyManager de la BindingManagerBase classe . Utilisez pour BindingContext retourner un CurrencyManager ou un PropertyManager. L’objet retourné dépend de la source de données et du membre de données transmis à la Item[] propriété du 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 est un PropertyManager. Par exemple, si vous spécifiez un TextBox comme source de données, un PropertyManager sera retourné. Si, en revanche, la source de données est un objet qui implémente l’interface IList, IListSourceou IBindingList , un CurrencyManager sera retourné.

La Current propriété retourne l’élément actif dans la liste sous-jacente. Pour modifier l’élément actif, définissez la Position propriété sur une nouvelle valeur. La valeur doit être supérieure à 0 et doit être inférieure à la valeur de la Count propriété.

Si la source de données sous-jacente implémente l’interface IBindingList et que la propriété a la AllowNewtruevaleur , vous pouvez utiliser la AddNew méthode .

Champs

finalType	Spécifie le type de données de la liste.
listposition	Spécifie la position actuelle de CurrencyManager dans la liste.
onCurrentChangedHandler	Spécifie le gestionnaire d'événements pour l'événement CurrentChanged. (Hérité de BindingManagerBase)
onPositionChangedHandler	Spécifie le gestionnaire d'événements pour l'événement PositionChanged. (Hérité de BindingManagerBase)

Propriétés

Bindings	Extrait la collection des liaisons managées. (Hérité de BindingManagerBase)
Count	Obtient le nombre d'éléments contenus dans la liste.
Current	Obtient l'élément en cours dans la liste.
IsBindingSuspended	Obtient une valeur indiquant si la liaison est suspendue. (Hérité de BindingManagerBase)
List	Obtient la liste de ce CurrencyManager.
Position	Obtient ou définit votre position dans la liste.

Méthodes

AddNew()	Ajoute un nouvel élément à la liste sous-jacente.
CancelCurrentEdit()	Annule l'opération de modification actuelle.
CheckEmpty()	Lève une exception s'il n'existe aucune liste ou si la liste est vide.
EndCurrentEdit()	Met fin à l'opération de modification en cours.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetItemProperties()	Obtient la collection de descripteurs de propriété pour la liste sous-jacente.
GetItemProperties(ArrayList, ArrayList)	Obtient la collection des descripteurs de propriété pour la liaison en utilisant l'objet ArrayList spécifié. (Hérité de BindingManagerBase)
GetItemProperties(Type, Int32, ArrayList, ArrayList)	Obtient la liste des propriétés des éléments managés par ce BindingManagerBase. (Hérité de BindingManagerBase)
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é.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OnBindingComplete(BindingCompleteEventArgs)	Déclenche l’événement BindingComplete. (Hérité de BindingManagerBase)
OnCurrentChanged(EventArgs)	Déclenche l’événement CurrentChanged.
OnCurrentItemChanged(EventArgs)	Déclenche l’événement CurrentItemChanged.
OnDataError(Exception)	Déclenche l’événement DataError. (Hérité de BindingManagerBase)
OnItemChanged(ItemChangedEventArgs)	Déclenche l’événement ItemChanged.
OnMetaDataChanged(EventArgs)	Déclenche l’événement MetaDataChanged.
OnPositionChanged(EventArgs)	Déclenche l’événement PositionChanged.
PullData()	Extrait des données du contrôle lié aux données vers la source de données sans retourner d'informations. (Hérité de BindingManagerBase)
PushData()	Exécute un push à partir de la source de données dans le contrôle lié aux données, sans retourner d'informations. (Hérité de BindingManagerBase)
Refresh()	Force un nouveau remplissage de la liste liée aux données.
RemoveAt(Int32)	Supprime l'élément à l'index spécifié.
ResumeBinding()	Relance la liaison de données.
SuspendBinding()	Suspend la liaison de données pour empêcher que les modifications mettent à jour la source de données liée.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
UpdateIsBinding()	Met à jour l'état de la liaison.

Événements

BindingComplete	Se produit à la fin d'une opération de liaison de données. (Hérité de BindingManagerBase)
CurrentChanged	Se produit quand l'élément actuellement lié change. (Hérité de BindingManagerBase)
CurrentItemChanged	Se produit quand l'état de l'élément lié aux données est modifié. (Hérité de BindingManagerBase)
DataError	Se produit lorsqu'un Exception est géré silencieusement par le BindingManagerBase. (Hérité de BindingManagerBase)
ItemChanged	Se produit suite à la modification de l'élément en cours.
ListChanged	Se produit en cas de modification de la liste ou d'un de ses éléments.
MetaDataChanged	Se produit lorsque les métadonnées de la propriété List ont changé.
PositionChanged	Se produit une fois que la valeur de la propriété Position a été modifiée. (Hérité de BindingManagerBase)

Voir aussi

• BindingsCollection
• BindingContext
• Binding