CurrencyManager Classe

Definição

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
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.

OnCurrentItemChanged(EventArgs)

Aciona o evento CurrentItemChanged.

(Herdado de BindingManagerBase)
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)

Aplica-se a

Confira também