CurrencyManager Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
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) |