CurrencyManager Classe

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Gerencia uma lista de objetos 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

Herança

Object

BindingManagerBase

CurrencyManager

Exemplos

O exemplo de código a seguir associa um TextBox controle a uma coluna em um DataTable, obtém o CurrencyManager para a associação e define sua posição.

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 deriva da BindingManagerBase classe . Use o BindingContext para retornar um CurrencyManager ou um PropertyManager. O objeto real retornado depende da fonte de dados e do membro de dados passados para a Item[] propriedade do 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á um PropertyManager. Por exemplo, se você especificar um TextBox como a fonte de dados, um PropertyManager será retornado. Se, por outro lado, a fonte de dados for um objeto que implementa a IListinterface , IListSourceou IBindingList , um CurrencyManager será retornado.

A Current propriedade retorna o item atual na lista subjacente. Para alterar o item atual, defina a Position propriedade como um novo valor. O valor deve ser maior que 0 e deve ser menor que o valor da Count propriedade.

Se a fonte de dados subjacente implementar a IBindingList interface e a AllowNew propriedade estiver definida como true, você poderá usar o AddNew método .

Campos

finalType	Especifica o tipo de dados da lista.
listposition	Especifica a posição atual do CurrencyManager na lista.
onCurrentChangedHandler	Especifica o manipulador de eventos para o evento CurrentChanged. (Herdado de BindingManagerBase)
onPositionChangedHandler	Especifica o manipulador de eventos para o evento PositionChanged. (Herdado de BindingManagerBase)

Propriedades

Bindings	Obtém a coleção de associações sendo gerenciadas. (Herdado de BindingManagerBase)
Count	Obtém o número de itens na lista.
Current	Obtém o item atual na lista.
IsBindingSuspended	Obtém um valor que indica se a associação está suspensa. (Herdado de BindingManagerBase)
List	Obtém a lista para este CurrencyManager.
Position	Obtém ou define a posição em que você está dentro da lista.

Métodos

AddNew()	Adiciona um novo item à lista subjacente.
CancelCurrentEdit()	Cancela a operação de edição atual.
CheckEmpty()	Gera uma exceção se não há nenhuma lista ou se a lista está vazia.
EndCurrentEdit()	Encerra a operação de edição atual.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetItemProperties()	Obtém a coleção de descritor de propriedade para a lista subjacente.
GetItemProperties(ArrayList, ArrayList)	Obtém a coleção de descritores de propriedade para a associação usando o ArrayList especificado. (Herdado de BindingManagerBase)
GetItemProperties(Type, Int32, ArrayList, ArrayList)	Obtém a lista de propriedades dos itens gerenciados por este 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.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnBindingComplete(BindingCompleteEventArgs)	Aciona o evento BindingComplete. (Herdado de BindingManagerBase)
OnCurrentChanged(EventArgs)	Aciona o evento CurrentChanged.
OnCurrentItemChanged(EventArgs)	Aciona o evento CurrentItemChanged.
OnDataError(Exception)	Aciona o evento DataError. (Herdado de BindingManagerBase)
OnItemChanged(ItemChangedEventArgs)	Aciona o evento ItemChanged.
OnMetaDataChanged(EventArgs)	Aciona o evento MetaDataChanged.
OnPositionChanged(EventArgs)	Aciona o evento PositionChanged.
PullData()	Efetua o pull de dados do controle associado a dados para a fonte de dados, não retornando nenhuma informação. (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. (Herdado de BindingManagerBase)
Refresh()	Força uma repopulação da lista com limite de dados.
RemoveAt(Int32)	Remove o item no índice especificado.
ResumeBinding()	Retome a vinculação de dados.
SuspendBinding()	Suspende a vinculação de dados para evitar alterações de atualização da fonte de dados associada.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
UpdateIsBinding()	Atualiza o status da associação.

Eventos

BindingComplete	Ocorre após a conclusão de uma operação de associação de dados. (Herdado de BindingManagerBase)
CurrentChanged	Ocorre quando o item associado no momento é alterado. (Herdado de BindingManagerBase)
CurrentItemChanged	Ocorre quando o estado do item associado no momento é alterado. (Herdado de BindingManagerBase)
DataError	Ocorre quando uma Exception é manipulada silenciosamente pelo BindingManagerBase. (Herdado de BindingManagerBase)
ItemChanged	Ocorre quando o item atual foi alterado.
ListChanged	Ocorre quando a lista ou um item na lista é alterado.
MetaDataChanged	Ocorre quando os metadados do List foram alterados.
PositionChanged	Ocorre depois que o valor da propriedade Position é alterado. (Herdado de BindingManagerBase)

Confira também

• BindingsCollection
• BindingContext
• Binding