CurrencyManager Classe

Definição

Gerencia uma lista de objetos 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
Herança
CurrencyManager

Exemplos

O exemplo de código a seguir associa TextBox um controle a uma coluna em DataTableum, obtém CurrencyManager o para a associação e define sua posição.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

Comentários

O CurrencyManager derivaBindingManagerBase da classe.The CurrencyManager derives from the BindingManagerBase class. Use o BindingContext para retornar um CurrencyManager ou um PropertyManager.Use the BindingContext to return either a CurrencyManager or a PropertyManager. O objeto real retornado depende da fonte Item[Object] BindingContextde dados e do membro de dados passados para a propriedade do.The actual object returned depends on the data source and data member passed to the Item[Object] property of the BindingContext. Se a fonte de dados for um objeto que pode retornar apenas uma única propriedade (em vez de uma lista de objetos), o tipo será PropertyManagerum.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. Por exemplo, se você especificar um TextBox como a fonte de dados, PropertyManager um será retornado.For example, if you specify a TextBox as the data source, a PropertyManager will be returned. Se, por outro lado, a fonte de dados for um objeto que implementa a IListinterface IListSource, ou IBindingList , um CurrencyManager será retornado.If, on the other hand, the data source is an object that implements the IList, IListSource, or IBindingList interface, a CurrencyManager will be returned.

A Current propriedade retorna o item atual na lista subjacente.The Current property returns the current item in the underlying list. Para alterar o item atual, defina a Position Propriedade como um novo valor.To change the current item, set the Position property to a new value. O valor deve ser maior que 0 e deve ser menor que o valor da Count propriedade.The value must be greater than 0 and must be less than the value of the Count property.

Se a fonte de dados subjacente implementar IBindingList a interface e a AllowNew propriedade for definida como true, você poderá usar o AddNew método.If the underlying data source implements the IBindingList interface, and the AllowNew property is set to true, you can use the AddNew method.

Campos

finalType

Especifica o tipo de dados da lista.Specifies the data type of the list.

listposition

Especifica a posição atual do CurrencyManager na lista.Specifies the current position of the CurrencyManager in the list.

onCurrentChangedHandler

Especifica o manipulador de eventos para o evento CurrentChanged.Specifies the event handler for the CurrentChanged event.

(Herdado de BindingManagerBase)
onPositionChangedHandler

Especifica o manipulador de eventos para o evento PositionChanged.Specifies the event handler for the PositionChanged event.

(Herdado de BindingManagerBase)

Propriedades

Bindings

Obtém a coleção de associações sendo gerenciadas.Gets the collection of bindings being managed.

(Herdado de BindingManagerBase)
Count

Obtém o número de itens na lista.Gets the number of items in the list.

Current

Obtém o item atual na lista.Gets the current item in the list.

IsBindingSuspended

Obtém um valor que indica se a associação está suspensa.Gets a value indicating whether binding is suspended.

(Herdado de BindingManagerBase)
List

Obtém a lista para este CurrencyManager.Gets the list for this CurrencyManager.

Position

Obtém ou define a posição em que você está dentro da lista.Gets or sets the position you are at within the list.

Métodos

AddNew()

Adiciona um novo item à lista subjacente.Adds a new item to the underlying list.

CancelCurrentEdit()

Cancela a operação de edição atual.Cancels the current edit operation.

CheckEmpty()

Gera uma exceção se não há nenhuma lista ou se a lista está vazia.Throws an exception if there is no list, or the list is empty.

EndCurrentEdit()

Encerra a operação de edição atual.Ends the current edit operation.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetItemProperties()

Obtém a coleção de descritor de propriedade para a lista subjacente.Gets the property descriptor collection for the underlying list.

GetItemProperties(ArrayList, ArrayList)

Obtém a coleção de descritores de propriedade para a associação usando o ArrayList especificado.Gets the collection of property descriptors for the binding using the specified ArrayList.

(Herdado de BindingManagerBase)
GetItemProperties(Type, Int32, ArrayList, ArrayList)

Obtém a lista de propriedades dos itens gerenciados por este BindingManagerBase.Gets the list of properties of the items managed by this BindingManagerBase.

(Herdado de BindingManagerBase)
GetListName(ArrayList)

Obtém o nome da lista fornecendo os dados para a associação usando o conjunto de propriedades associadas especificado.Gets the name of the list supplying the data for the binding using the specified set of bound properties.

GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
OnBindingComplete(BindingCompleteEventArgs)

Aciona o evento BindingComplete.Raises the BindingComplete event.

(Herdado de BindingManagerBase)
OnCurrentChanged(EventArgs)

Aciona o evento CurrentChanged.Raises the CurrentChanged event.

OnCurrentItemChanged(EventArgs)

Aciona o evento CurrentItemChanged.Raises the CurrentItemChanged event.

OnDataError(Exception)

Aciona o evento DataError.Raises the DataError event.

(Herdado de BindingManagerBase)
OnItemChanged(ItemChangedEventArgs)

Aciona o evento ItemChanged.Raises the ItemChanged event.

OnMetaDataChanged(EventArgs)

Aciona o evento MetaDataChanged.Raises the MetaDataChanged event.

OnPositionChanged(EventArgs)

Aciona o evento PositionChanged.Raises the PositionChanged event.

PullData()

Efetua o pull de dados do controle associado a dados para a fonte de dados, não retornando nenhuma informação.Pulls data from the data-bound control into the data source, returning no information.

(Herdado de BindingManagerBase)
PushData()

Efetua o push de dados da fonte de dados para o controle associado a dados, não retornando nenhuma informação.Pushes data from the data source into the data-bound control, returning no information.

(Herdado de BindingManagerBase)
Refresh()

Força uma repopulação da lista com limite de dados.Forces a repopulation of the data-bound list.

RemoveAt(Int32)

Remove o item no índice especificado.Removes the item at the specified index.

ResumeBinding()

Retome a vinculação de dados.Resumes data binding.

SuspendBinding()

Suspende a vinculação de dados para evitar alterações de atualização da fonte de dados associada.Suspends data binding to prevents changes from updating the bound data source.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)
UpdateIsBinding()

Atualiza o status da associação.Updates the status of the binding.

Eventos

BindingComplete

Ocorre após a conclusão de uma operação de associação de dados.Occurs at the completion of a data-binding operation.

(Herdado de BindingManagerBase)
CurrentChanged

Ocorre quando o item associado no momento é alterado.Occurs when the currently bound item changes.

(Herdado de BindingManagerBase)
CurrentItemChanged

Ocorre quando o estado do item associado no momento é alterado.Occurs when the state of the currently bound item changes.

(Herdado de BindingManagerBase)
DataError

Ocorre quando uma Exception é manipulada silenciosamente pelo BindingManagerBase.Occurs when an Exception is silently handled by the BindingManagerBase.

(Herdado de BindingManagerBase)
ItemChanged

Ocorre quando o item atual foi alterado.Occurs when the current item has been altered.

ListChanged

Ocorre quando a lista ou um item na lista é alterado.Occurs when the list changes or an item in the list changes.

MetaDataChanged

Ocorre quando os metadados do List foram alterados.Occurs when the metadata of the List has changed.

PositionChanged

Ocorre depois que o valor da propriedade Position é alterado.Occurs after the value of the Position property has changed.

(Herdado de BindingManagerBase)

Aplica-se a

Veja também