BindingManagerBase Classe

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Manage tous les objets Binding qui sont liés aux mêmes sources de données et données membres. Cette classe est abstraite.

public ref class BindingManagerBase abstract

public abstract class BindingManagerBase

type BindingManagerBase = class

Public MustInherit Class BindingManagerBase

Héritage

Object

BindingManagerBase

Dérivé

System.Windows.Forms.CurrencyManager

System.Windows.Forms.PropertyManager

Exemples

L’exemple de code suivant utilise pour BindingContext renvoyer un BindingManagerBase pour une source de données spécifique. (L’exemple suppose que vous avez déclaré myBindingManagerBase dans la section Déclarations du module.) L’exemple ajoute ensuite des délégués d’événements CurrentChanged aux événements et PositionChanged . Enfin, l’exemple contient quatre méthodes (MoveNext, MovePrevious, MoveFirstet MoveLast) qui incrémentent ou décrémentent la Position propriété et définissent sur Position la première ou la dernière ligne de la liste. La dernière ligne de la liste est déterminée à l’aide de la Count propriété .

void GetBindingManagerBase()
{
   
   /* CustomersToOrders is the RelationName of a DataRelation. 
      Therefore, the list maintained by the BindingManagerBase is the
      list of orders that belong to a specific customer in the 
      DataTable named Customers, found in DataSet1. */
   myBindingManagerBase = this->BindingContext[DataSet1, "Customers.CustomersToOrders"];
   
   // Adds delegates to the CurrentChanged and PositionChanged events.
   myBindingManagerBase->PositionChanged += gcnew EventHandler( this, &Form1::BindingManagerBase_PositionChanged );
   myBindingManagerBase->CurrentChanged += gcnew EventHandler( this, &Form1::BindingManagerBase_CurrentChanged );
}

void BindingManagerBase_PositionChanged( Object^ sender, EventArgs^ /*e*/ )
{
   
   // Prints the new Position of the BindingManagerBase.
   Console::Write( "Position Changed: " );
   Console::WriteLine( (dynamic_cast<BindingManagerBase^>(sender))->Position );
}

void BindingManagerBase_CurrentChanged( Object^ sender, EventArgs^ /*e*/ )
{
   
   // Prints the new value of the current object.
   Console::Write( "Current Changed: " );
   Console::WriteLine( (dynamic_cast<BindingManagerBase^>(sender))->Current );
}

void MoveNext()
{
   
   // Increments the Position property value by one.
   myBindingManagerBase->Position = myBindingManagerBase->Position + 1;
}

void MovePrevious()
{
   
   // Decrements the Position property value by one.
   myBindingManagerBase->Position = myBindingManagerBase->Position - 1;
}

void MoveFirst()
{
   
   // Goes to the first row in the list.
   myBindingManagerBase->Position = 0;
}

void MoveLast()
{
   
   // Goes to the last row in the list.
   myBindingManagerBase->Position = myBindingManagerBase->Count - 1;
}

private void GetBindingManagerBase()
{
   /* CustomersToOrders is the RelationName of a DataRelation. 
   Therefore, the list maintained by the BindingManagerBase is the
   list of orders that belong to a specific customer in the 
   DataTable named Customers, found in DataSet1. */
   myBindingManagerBase = 
   this.BindingContext[DataSet1, "Customers.CustomersToOrders"];

   // Adds delegates to the CurrentChanged and PositionChanged events.
   myBindingManagerBase.PositionChanged += 
   new EventHandler(BindingManagerBase_PositionChanged);
   myBindingManagerBase.CurrentChanged +=
   new EventHandler(BindingManagerBase_CurrentChanged);
}

private void BindingManagerBase_PositionChanged
(object sender, EventArgs e)
{
   // Prints the new Position of the BindingManagerBase.
   Console.Write("Position Changed: ");
   Console.WriteLine(((BindingManagerBase)sender).Position);
}

private void BindingManagerBase_CurrentChanged
(object sender, EventArgs e)
{
   // Prints the new value of the current object.
   Console.Write("Current Changed: ");
   Console.WriteLine(((BindingManagerBase)sender).Current);
}

private void MoveNext()
{
   // Increments the Position property value by one.
   myBindingManagerBase.Position += 1;
}

private void MovePrevious()
{
   // Decrements the Position property value by one.
   myBindingManagerBase.Position -= 1;
}

private void MoveFirst()
{
   // Goes to the first row in the list.
   myBindingManagerBase.Position = 0;
}

private void MoveLast()
{
   // Goes to the last row in the list.
   myBindingManagerBase.Position = 
   myBindingManagerBase.Count - 1;
}

Private Sub GetBindingManagerBase
   ' CustomersToOrders is the RelationName of a DataRelation.
   ' Therefore, the list maintained by the BindingManagerBase is the
   ' list of orders that belong to a specific customer in the
   ' DataTable named Customers, found in DataSet.
   myBindingManagerBase = Me.BindingContext(DataSet1, _
   "Customers.CustomersToOrders")

   ' Adds delegates to the CurrentChanged and PositionChanged events.
   AddHandler myBindingManagerBase.PositionChanged, _
   AddressOf BindingManagerBase_PositionChanged
   AddHandler myBindingManagerBase.CurrentChanged, _
   AddressOf BindingManagerBase_CurrentChanged
End Sub

Private Sub BindingManagerBase_PositionChanged _
(sender As Object, e As EventArgs)

   ' Prints the new Position of the BindingManagerBase.
   Console.Write("Position Changed: ")
   Console.WriteLine(CType(sender, BindingManagerBase).Position)
End Sub

Private Sub BindingManagerBase_CurrentChanged _
(sender As Object, e As EventArgs)

   ' Prints the new value of the current object.
   Console.Write("Current Changed: ")
   Console.WriteLine(CType(sender, BindingManagerBase).Current)
End Sub

Private Sub MoveNext
   ' Increments the Position property value by one.
   myBindingManagerBase.Position += 1
End Sub

Private Sub MovePrevious
   ' Decrements the Position property value by one.
   myBindingManagerBase.Position -= 1
End Sub

Private Sub MoveFirst
   ' Goes to the first row in the list.
   myBindingManagerBase.Position = 0
End Sub

Private Sub MoveLast
   ' Goes to the last row in the list.
   myBindingManagerBase.Position = _
   myBindingManagerBase.Count - 1
End Sub

Remarques

active BindingManagerBase la synchronisation des contrôles liés aux données sur un Windows Form qui sont liés à la même source de données. (Pour plus d’informations sur la liaison simple d’un contrôle à une source de données, consultez la Binding classe .) Par exemple, supposons qu’un formulaire contienne deux TextBox contrôles liés à la même source de données, mais à des colonnes différentes. La source de données peut être un qui contient des DataTable noms de clients, tandis que les colonnes peuvent contenir le prénom et le nom. Les deux contrôles doivent être synchronisés afin d’afficher les prénoms et les noms corrects pour le même client. , CurrencyManagerqui hérite de la BindingManagerBase classe , effectue cette synchronisation en conservant un pointeur vers l’élément actif dans la source de données. Les TextBox contrôles étant liés à l’élément actif, ils affichent les informations de la même ligne. Lorsque l’élément actuel change, le CurrencyManager avertit tous les contrôles liés afin qu’ils puissent actualiser leurs données. En outre, vous pouvez définir la Position propriété pour spécifier la ligne dans le DataTable vers laquelle les contrôles pointent. Pour déterminer le nombre de lignes disponibles dans la source de données, utilisez la Count propriété .

Est CurrencyManager nécessaire, car les sources de données ne gèrent pas nécessairement un pointeur d’élément actif. Pour instance, les tableaux et ArrayList les objets peuvent être des sources de données, mais ils n’ont pas de propriété qui retourne l’élément actif. Pour obtenir l’élément actif, utilisez la Current propriété .

Le PropertyManager hérite également de , BindingManagerBaseet il est utilisé pour conserver la propriété actuelle d’un objet, plutôt que la propriété d’un objet actif dans une source de données. Pour cette raison, la tentative de définir la Position propriété ou Count pour un PropertyManager n’a aucun effet.

Pour créer un BindingManagerBase, utilisez la BindingContext classe , qui retourne un CurrencyManager ou un PropertyManager, en fonction de la source de données gérée.

Les programmeurs de solutions sont encouragés à lier des contrôles directement à un BindingSource composant, qui sert à la fois de source de données et de connecteur de données à la source de données cible réelle. BindingSource simplifie grandement la liaison de données simple et complexe, y compris la gestion de la devise entre le contrôle et sa cible.

Notes pour les responsables de l’implémentation

Lorsque vous héritez de BindingManagerBase, vous devez remplacer les membres abstraits suivants : AddNew(), Count, , GetItemProperties()OnCurrentChanged(EventArgs)CancelCurrentEdit()CurrentEndCurrentEdit(), Position, , RemoveAt(Int32), , ResumeBinding(), , SuspendBinding()et .UpdateIsBinding()

Constructeurs

BindingManagerBase()

Initialise une nouvelle instance de la classe BindingManagerBase.

Champs

onCurrentChangedHandler	Spécifie le gestionnaire d'événements pour l'événement CurrentChanged.
onPositionChangedHandler	Spécifie le gestionnaire d'événements pour l'événement PositionChanged.

Propriétés

Bindings	Extrait la collection des liaisons managées.
Count	En cas de substitution dans une classe dérivée, obtient le nombre de lignes managées par BindingManagerBase.
Current	En cas de substitution dans une classe dérivée, obtient l'objet en cours.
IsBindingSuspended	Obtient une valeur indiquant si la liaison est suspendue.
Position	En cas de substitution dans une classe dérivée, obtient ou définit la position dans la liste sous-jacente vers laquelle pointent les contrôles liés à cette source de données.

Méthodes

AddNew()	En cas de substitution dans une classe dérivée, ajoute un nouvel élément à la liste sous-jacente.
CancelCurrentEdit()	En cas de substitution dans une classe dérivée, annule la modification en cours.
EndCurrentEdit()	En cas de substitution dans une classe dérivée, termine la 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()	En cas de substitution dans une classe dérivée, obtient la collection des descripteurs de propriété pour la liaison.
GetItemProperties(ArrayList, ArrayList)	Obtient la collection des descripteurs de propriété pour la liaison en utilisant l'objet ArrayList spécifié.
GetItemProperties(Type, Int32, ArrayList, ArrayList)	Obtient la liste des propriétés des éléments managés par ce BindingManagerBase.
GetListName(ArrayList)	En cas de substitution dans une classe dérivée, obtient le nom de la liste fournissant les données pour la liaison.
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.
OnCurrentChanged(EventArgs)	Déclenche l’événement CurrentChanged.
OnCurrentItemChanged(EventArgs)	Déclenche l’événement CurrentItemChanged.
OnDataError(Exception)	Déclenche l’événement DataError.
PullData()	Extrait des données du contrôle lié aux données vers la source de données sans retourner d'informations.
PushData()	Exécute un push à partir de la source de données dans le contrôle lié aux données, sans retourner d'informations.
RemoveAt(Int32)	En cas de substitution dans une classe dérivée, supprime la ligne à l'index spécifié de la liste sous-jacente.
ResumeBinding()	En cas de substitution dans une classe dérivée, rétablit la liaison de données.
SuspendBinding()	En cas de substitution dans une classe dérivée, suspend la liaison de données.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
UpdateIsBinding()	En cas de substitution dans une classe dérivée, met à jour la liaison de données.

Événements

BindingComplete	Se produit à la fin d'une opération de liaison de données.
CurrentChanged	Se produit quand l'élément actuellement lié change.
CurrentItemChanged	Se produit quand l'état de l'élément lié aux données est modifié.
DataError	Se produit lorsqu'un Exception est géré silencieusement par le BindingManagerBase.
PositionChanged	Se produit une fois que la valeur de la propriété Position a été modifiée.

Voir aussi

• BindingSource
• BindingContext
• CurrencyManager
• PropertyManager