CurrencyManager Classe

Définition

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
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.

OnCurrentItemChanged(EventArgs)

Déclenche l’événement CurrentItemChanged.

(Hérité de BindingManagerBase)
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)

S’applique à

Voir aussi