Partager via


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 la CurrencyManager 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 l’option BindingContext pour retourner un CurrencyManager ou un PropertyManager. L’objet réel 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 une TextBox source de données, un PropertyManager sera retourné. Si, d’autre part, la source de données est un objet qui implémente le IList, IListSourceou IBindingList l’interface, un CurrencyManager sera retourné.

La Current propriété retourne l’élément actif dans la liste sous-jacente. Pour modifier l’élément actuel, 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 AllowNew propriété est définie truesur , vous pouvez utiliser la AddNew méthode.

Champs

Nom Description
finalType

Spécifie le type de données de la liste.

listposition

Spécifie la position actuelle de la CurrencyManager 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

Nom Description
Bindings

Obtient la collection de liaisons gérées.

(Hérité de BindingManagerBase)
Count

Obtient le nombre d’éléments de la liste.

Current

Obtient l’élément actif 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 la position à laquelle vous vous trouvez dans la liste.

Méthodes

Nom Description
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()

Termine l’opération de modification actuelle.

Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetItemProperties()

Obtient la collection de descripteur de propriété pour la liste sous-jacente.

GetItemProperties(ArrayList, ArrayList)

Obtient la collection de descripteurs de propriété pour la liaison à l’aide du .ArrayList

(Hérité de BindingManagerBase)
GetItemProperties(Type, Int32, ArrayList, ArrayList)

Obtient la liste des propriétés des éléments gérés par ce BindingManagerBase.

(Hérité de BindingManagerBase)
GetListName(ArrayList)

Obtient le nom de la liste fournissant les données de la liaison à l’aide de l’ensemble spécifié de propriétés liées.

GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(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 les données du contrôle lié aux données dans la source de données, en retournant aucune information.

(Hérité de BindingManagerBase)
PushData()

Envoie des données de la source de données dans le contrôle lié aux données, en retournant aucune information.

(Hérité de BindingManagerBase)
Refresh()

Force une repopulation de la liste liée aux données.

RemoveAt(Int32)

Supprime l’élément à l’index spécifié.

ResumeBinding()

Reprend la liaison de données.

SuspendBinding()

Suspend la liaison de données pour empêcher la mise à jour de 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

Nom Description
BindingComplete

Se produit à l’achèvement d’une opération de liaison de données.

(Hérité de BindingManagerBase)
CurrentChanged

Se produit lorsque l’élément actuellement lié change.

(Hérité de BindingManagerBase)
CurrentItemChanged

Se produit lorsque l’état de l’élément actuellement lié change.

(Hérité de BindingManagerBase)
DataError

Se produit lorsqu’un Exception élément est géré en mode silencieux par le BindingManagerBase.

(Hérité de BindingManagerBase)
ItemChanged

Se produit lorsque l’élément actuel a été modifié.

ListChanged

Se produit lorsque la liste change ou qu’un élément de la liste change.

MetaDataChanged

Se produit lorsque les métadonnées du fichier List ont changé.

PositionChanged

Se produit après la modification de la valeur de la Position propriété.

(Hérité de BindingManagerBase)

S’applique à

Voir aussi