BindingManagerBase Classe

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Gestisce tutti gli oggetti Binding associati alla stessa origine dati e allo stesso membro dati. Questa classe è astratta.

public ref class BindingManagerBase abstract

public abstract class BindingManagerBase

type BindingManagerBase = class

Public MustInherit Class BindingManagerBase

Ereditarietà

Object

BindingManagerBase

Derivato

System.Windows.Forms.CurrencyManager

System.Windows.Forms.PropertyManager

Esempio

Nell'esempio di codice seguente viene utilizzato per BindingContext restituire un BindingManagerBase oggetto per un'origine dati specifica. L'esempio presuppone che sia stato dichiarato myBindingManagerBase nella sezione Dichiarazioni del modulo. Nell'esempio vengono quindi aggiunti delegati di evento agli CurrentChanged eventi e PositionChanged . Infine, l'esempio contiene quattro metodi (, , e ) che incrementa o decrementa la Position proprietà e imposta l'oggetto Position sulla prima o sull'ultima riga dell'elenco.MoveLastMoveFirstMovePreviousMoveNext L'ultima riga nell'elenco viene determinata utilizzando la Count proprietà .

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

Commenti

Abilita BindingManagerBase la sincronizzazione dei controlli associati a dati in un Windows Form associato alla stessa origine dati. Per altre informazioni sull'associazione semplice di un controllo a un'origine dati, vedere la Binding classe . Si supponga, ad esempio, che un modulo contenga due TextBox controlli associati alla stessa origine dati ma a colonne diverse. L'origine dati potrebbe essere un DataTable oggetto contenente i nomi dei clienti, mentre le colonne potrebbero contenere il nome e il cognome. I due controlli devono essere sincronizzati per visualizzare il nome e il cognome corretti per lo stesso cliente. L'oggetto CurrencyManager, che eredita dalla BindingManagerBase classe , esegue questa sincronizzazione mantenendo un puntatore all'elemento corrente nell'origine dati. I TextBox controlli sono associati all'elemento corrente in modo che visualizzino le informazioni per la stessa riga. Quando l'elemento corrente viene modificato, CurrencyManager invia una notifica a tutti i controlli associati in modo che possano aggiornare i dati. Inoltre, è possibile impostare la Position proprietà per specificare la riga nell'oggetto DataTable a cui puntano i controlli. Per determinare il numero di righe presenti nell'origine dati, utilizzare la Count proprietà .

È CurrencyManager necessario perché le origini dati non mantengono necessariamente un puntatore all'elemento corrente. Ad esempio, matrici e ArrayList oggetti possono essere origini dati, ma non hanno una proprietà che restituisce l'elemento corrente. Per ottenere l'elemento corrente, utilizzare la Current proprietà .

Eredita PropertyManager anche da BindingManagerBasee viene utilizzata per mantenere la proprietà corrente di un oggetto, anziché la proprietà di un oggetto corrente in un'origine dati. Per questo motivo, il tentativo di impostare la Position proprietà o Count per un PropertyManager oggetto non ha alcun effetto.

Per creare un BindingManagerBaseoggetto , usare la BindingContext classe , che restituisce un CurrencyManager oggetto o PropertyManager, a seconda dell'origine dati gestita.

I programmatori di soluzioni sono invitati a associare i controlli direttamente a un BindingSource componente, che funge sia da origine dati che da connettore dati all'origine dati di destinazione effettiva. BindingSource semplifica notevolmente sia il data binding semplice che quello complesso, inclusa la gestione della valuta tra il controllo e la destinazione.

Note per gli implementatori

Quando si eredita da BindingManagerBase, è necessario eseguire l'override dei membri astratti seguenti: AddNew(), Count, CancelCurrentEdit(), EndCurrentEdit()Current, , GetItemProperties(), PositionRemoveAt(Int32)ResumeBinding()OnCurrentChanged(EventArgs)SuspendBinding(), , e .UpdateIsBinding()

Costruttori

BindingManagerBase()

Inizializza una nuova istanza della classe BindingManagerBase.

Campi

onCurrentChangedHandler	Specifica il gestore eventi per l'evento CurrentChanged.
onPositionChangedHandler	Specifica il gestore eventi per l'evento PositionChanged.

Proprietà

Bindings	Ottiene la raccolta di associazioni che si sta gestendo.
Count	In caso di override in una classe derivata, ottiene il numero di righe gestite da BindingManagerBase.
Current	Quando viene sottoposto a override in una classe derivata, ottiene l'oggetto corrente.
IsBindingSuspended	Ottiene un valore che indica se l'associazione è sospesa.
Position	Quando viene sottoposto a override in una classe derivata, ottiene o imposta la posizione nell'elenco sottostante a cui fanno riferimento i controlli associati a questa origine dati.

Metodi

AddNew()	Quando viene sottoposto a override in una classe derivata, aggiunge un nuovo elemento all'elenco sottostante.
CancelCurrentEdit()	Quando viene sottoposto a override in una classe derivata, annulla la modifica corrente.
EndCurrentEdit()	Quando viene sottoposto a override in una classe derivata, termina la modifica corrente.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetItemProperties()	Quando viene sottoposto a override in una classe derivata, ottiene la raccolta di descrittori di proprietà per l'associazione.
GetItemProperties(ArrayList, ArrayList)	Ottiene l'insieme di descrittori di proprietà per l'associazione mediante il controllo ArrayList specificato.
GetItemProperties(Type, Int32, ArrayList, ArrayList)	Ottiene l'elenco delle proprietà degli elementi gestiti da questa classe BindingManagerBase.
GetListName(ArrayList)	Quando viene sottoposto a override in una classe derivata, ottiene il nome dell'elenco che fornisce i dati per l'associazione.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnBindingComplete(BindingCompleteEventArgs)	Genera l'evento BindingComplete.
OnCurrentChanged(EventArgs)	Genera l'evento CurrentChanged.
OnCurrentItemChanged(EventArgs)	Genera l'evento CurrentItemChanged.
OnDataError(Exception)	Genera l'evento DataError.
PullData()	Ottiene i dati dal controllo associato a dati e li inserisce nell'origine dati, senza restituire alcuna informazione.
PushData()	Ottiene i dati dall'origine dati e li inserisce nel controllo associato a dati, senza restituire alcuna informazione.
RemoveAt(Int32)	Quando viene sottoposto a override in una classe derivata, elimina la riga in corrispondenza dell'indice specificato dall'elenco sottostante.
ResumeBinding()	Quando viene sottoposto a override in una classe derivata, ripristina l'associazione dati.
SuspendBinding()	Quando viene sottoposto a override in una classe derivata, sospende il data binding.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
UpdateIsBinding()	Quando viene sottoposto a override in una classe derivata, aggiorna l'associazione.

Eventi

BindingComplete	Si verifica al completamento di un'operazione di associazione dati.
CurrentChanged	Si verifica quando l'elemento attualmente associato viene modificato.
CurrentItemChanged	Si verifica quando lo stato dell'elemento attualmente associato viene modificato.
DataError	Si verifica quando un oggetto Exception viene gestito in modo invisibile all'utente dall'oggetto BindingManagerBase.
PositionChanged	Si verifica in seguito alla modifica del valore della proprietà Position.

Vedi anche

• BindingSource
• BindingContext
• CurrencyManager
• PropertyManager