CurrencyManager Classe

Definizione

Gestisce un elenco di oggetti Binding.Manages a list of Binding objects.

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
Ereditarietà
CurrencyManager

Esempi

Nell'esempio di codice seguente viene associato TextBox un controllo a una colonna in DataTableun oggetto, CurrencyManager viene ottenuto l'oggetto per l'associazione e viene impostata la relativa posizione.The following code example binds a TextBox control to a column in a DataTable, gets the CurrencyManager for the binding, and sets its 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

Commenti

CurrencyManager DerivaBindingManagerBase dalla classe.The CurrencyManager derives from the BindingManagerBase class. Usare per restituire un CurrencyManager oggetto o un oggetto PropertyManager. BindingContextUse the BindingContext to return either a CurrencyManager or a PropertyManager. L'oggetto effettivo restituito dipende dall'origine dati e dal membro dati passati alla Item[Object] proprietà BindingContextdi.The actual object returned depends on the data source and data member passed to the Item[Object] property of the BindingContext. Se l'origine dati è un oggetto che può restituire solo una singola proprietà (anziché un elenco di oggetti), il tipo sarà PropertyManager.If the data source is an object that can return only a single property (instead of a list of objects), the type will be a PropertyManager. Se ad esempio si specifica TextBox come origine dati, verrà restituito un oggetto. PropertyManagerFor example, if you specify a TextBox as the data source, a PropertyManager will be returned. Se invece l'origine dati è un oggetto IListche implementa l'interfaccia, IListSourceo IBindingList , verrà restituito un CurrencyManager oggetto.If, on the other hand, the data source is an object that implements the IList, IListSource, or IBindingList interface, a CurrencyManager will be returned.

La Current proprietà restituisce l'elemento corrente nell'elenco sottostante.The Current property returns the current item in the underlying list. Per modificare l'elemento corrente, impostare la Position proprietà su un nuovo valore.To change the current item, set the Position property to a new value. Il valore deve essere maggiore di 0 e deve essere minore del valore della Count proprietà.The value must be greater than 0 and must be less than the value of the Count property.

Se l'origine dati sottostante implementa l' IBindingList interfaccia e la AllowNew proprietà è impostata su true, è possibile utilizzare il AddNew metodo.If the underlying data source implements the IBindingList interface, and the AllowNew property is set to true, you can use the AddNew method.

Campi

finalType

Specifica il tipo di dati dell'elenco.Specifies the data type of the list.

listposition

Specifica la posizione corrente dell'oggetto CurrencyManager nell'elenco.Specifies the current position of the CurrencyManager in the list.

onCurrentChangedHandler

Specifica il gestore eventi per l'evento CurrentChanged.Specifies the event handler for the CurrentChanged event.

(Ereditato da BindingManagerBase)
onPositionChangedHandler

Specifica il gestore eventi per l'evento PositionChanged.Specifies the event handler for the PositionChanged event.

(Ereditato da BindingManagerBase)

Proprietà

Bindings

Ottiene l'insieme di associazioni che si sta gestendo.Gets the collection of bindings being managed.

(Ereditato da BindingManagerBase)
Count

Ottiene il numero di elementi nell'elenco.Gets the number of items in the list.

Current

Ottiene l'elemento corrente dell'elenco.Gets the current item in the list.

IsBindingSuspended

Ottiene un valore che indica se l'associazione è sospesa.Gets a value indicating whether binding is suspended.

(Ereditato da BindingManagerBase)
List

Ottiene l'elenco per CurrencyManager.Gets the list for this CurrencyManager.

Position

Ottiene o imposta la posizione dell'elenco in cui ci si trova.Gets or sets the position you are at within the list.

Metodi

AddNew()

Aggiunge un nuovo elemento all'elenco sottostante.Adds a new item to the underlying list.

CancelCurrentEdit()

Annulla l'operazione di modifica corrente.Cancels the current edit operation.

CheckEmpty()

Genera un'eccezione se non esiste alcun elenco oppure l'elenco è vuoto.Throws an exception if there is no list, or the list is empty.

EndCurrentEdit()

Termina l'operazione di modifica corrente.Ends the current edit operation.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetItemProperties()

Ottiene l'insieme dei descrittori di proprietà per l'elenco sottostante.Gets the property descriptor collection for the underlying list.

GetItemProperties(ArrayList, ArrayList)

Ottiene l'insieme di descrittori di proprietà per l'associazione mediante il controllo ArrayList specificato.Gets the collection of property descriptors for the binding using the specified ArrayList.

(Ereditato da BindingManagerBase)
GetItemProperties(Type, Int32, ArrayList, ArrayList)

Ottiene l'elenco delle proprietà degli elementi gestiti da questa classe BindingManagerBase.Gets the list of properties of the items managed by this BindingManagerBase.

(Ereditato da BindingManagerBase)
GetListName(ArrayList)

Ottiene il nome dell'elenco che fornisce i dati per l'associazione utilizzando il gruppo di proprietà di associazione specificato.Gets the name of the list supplying the data for the binding using the specified set of bound properties.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
OnBindingComplete(BindingCompleteEventArgs)

Genera l'evento BindingComplete.Raises the BindingComplete event.

(Ereditato da BindingManagerBase)
OnCurrentChanged(EventArgs)

Genera l'evento CurrentChanged.Raises the CurrentChanged event.

OnCurrentItemChanged(EventArgs)

Genera l'evento CurrentItemChanged.Raises the CurrentItemChanged event.

OnDataError(Exception)

Genera l'evento DataError.Raises the DataError event.

(Ereditato da BindingManagerBase)
OnItemChanged(ItemChangedEventArgs)

Genera l'evento ItemChanged.Raises the ItemChanged event.

OnMetaDataChanged(EventArgs)

Genera l'evento MetaDataChanged.Raises the MetaDataChanged event.

OnPositionChanged(EventArgs)

Genera l'evento PositionChanged.Raises the PositionChanged event.

PullData()

Ottiene i dati dal controllo con associazione a dati e li inserisce nell'origine dati, senza restituire alcuna informazione.Pulls data from the data-bound control into the data source, returning no information.

(Ereditato da BindingManagerBase)
PushData()

Ottiene i dati dall'origine dati e li inserisce nel controllo con associazione a dati, senza restituire alcuna informazione.Pushes data from the data source into the data-bound control, returning no information.

(Ereditato da BindingManagerBase)
Refresh()

Impone una ricompilazione dell'elenco con associazione a dati.Forces a repopulation of the data-bound list.

RemoveAt(Int32)

Rimuove l'elemento in corrispondenza dell'indice specificato.Removes the item at the specified index.

ResumeBinding()

Riprende l'associazione dati.Resumes data binding.

SuspendBinding()

Sospende l'associazione dati per impedire alle modifiche di aggiornare l'origine dati associata.Suspends data binding to prevents changes from updating the bound data source.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)
UpdateIsBinding()

Aggiorna lo stato dell'associazione.Updates the status of the binding.

Eventi

BindingComplete

Si verifica al completamento di un'operazione di associazione dati.Occurs at the completion of a data-binding operation.

(Ereditato da BindingManagerBase)
CurrentChanged

Si verifica quando l'elemento attualmente associato viene modificato.Occurs when the currently bound item changes.

(Ereditato da BindingManagerBase)
CurrentItemChanged

Si verifica quando lo stato dell'elemento attualmente associato viene modificato.Occurs when the state of the currently bound item changes.

(Ereditato da BindingManagerBase)
DataError

Si verifica quando un oggetto Exception viene gestito in modo invisibile all'utente dall'oggetto BindingManagerBase.Occurs when an Exception is silently handled by the BindingManagerBase.

(Ereditato da BindingManagerBase)
ItemChanged

Si verifica quando l'elemento corrente è stato alterato.Occurs when the current item has been altered.

ListChanged

Si verifica quando viene modificato l'elenco o un elemento dell'elenco.Occurs when the list changes or an item in the list changes.

MetaDataChanged

si verifica quando i metadati della proprietà List vengono modificati.Occurs when the metadata of the List has changed.

PositionChanged

Si verifica in seguito alla modifica del valore della proprietà Position.Occurs after the value of the Position property has changed.

(Ereditato da BindingManagerBase)

Si applica a

Vedi anche