CurrencyManager Classe

Definição

Gerir uma lista de Binding objetos.

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 seguinte associa um TextBox controlo a uma coluna em DataTable, obtém o CurrencyManager para a ligação e define a 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

Observações

Deriva CurrencyManager da BindingManagerBase classe. Use o BindingContext para devolver um CurrencyManager ou um PropertyManager. O objeto real devolvido depende da fonte de dados e do elemento de dados passado para a Item[] propriedade do BindingContext. Se a fonte de dados for um objeto que pode devolver apenas uma única propriedade (em vez de uma lista de objetos), o tipo será um PropertyManager. Por exemplo, se especificar a TextBox como fonte de dados, a PropertyManager será devolvido. Se, por outro lado, a fonte de dados for um objeto que implementa o IList, , ou IBindingList interface, um CurrencyManager será IListSourcedevolvido.

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

Se a fonte de dados subjacente implementar a IBindingList interface, e a AllowNew propriedade for definida para true, pode usar o AddNew método.

Campos

Name Description
finalType

Especifica o tipo de dado da lista.

listposition

Especifica a posição atual do CurrencyManager na lista.

onCurrentChangedHandler

Especifica o gestor de eventos para o CurrentChanged evento.

(Herdado de BindingManagerBase)
onPositionChangedHandler

Especifica o gestor de eventos para o PositionChanged evento.

(Herdado de BindingManagerBase)

Propriedades

Name Description
Bindings

Faz com que a coleção de encadernações seja gerida.

(Herdado de BindingManagerBase)
Count

Obtém o número de itens na lista.

Current

Recebe o item atual da lista.

IsBindingSuspended

Recebe um valor que indica se a ligação está suspensa.

(Herdado de BindingManagerBase)
List

Obtém a lista para isto CurrencyManager.

Position

Obtém ou definem a posição em que estás dentro da lista.

Métodos

Name Description
AddNew()

Adiciona um novo item à lista subjacente.

CancelCurrentEdit()

Cancela a operação de edição atual.

CheckEmpty()

Lança uma exceção se não houver lista, ou se a lista estiver vazia.

EndCurrentEdit()

Termina a operação de edição atual.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetItemProperties()

Obtém a coleção de descritores de propriedades para a lista subjacente.

GetItemProperties(ArrayList, ArrayList)

Obtém a coleção de descritores de propriedades para a ligação usando o especificado ArrayList.

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

Obtém a lista de propriedades dos itens geridos por este BindingManagerBase.

(Herdado de BindingManagerBase)
GetListName(ArrayList)

Obtém o nome da lista que fornece os dados para a ligação usando o conjunto especificado de propriedades ligadas.

GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
OnBindingComplete(BindingCompleteEventArgs)

Eleva o BindingComplete evento.

(Herdado de BindingManagerBase)
OnCurrentChanged(EventArgs)

Eleva o CurrentChanged evento.

OnCurrentItemChanged(EventArgs)

Eleva o CurrentItemChanged evento.

OnDataError(Exception)

Eleva o DataError evento.

(Herdado de BindingManagerBase)
OnItemChanged(ItemChangedEventArgs)

Eleva o ItemChanged evento.

OnMetaDataChanged(EventArgs)

Eleva o MetaDataChanged evento.

OnPositionChanged(EventArgs)

Eleva o PositionChanged evento.

PullData()

Puxa dados do controlo vinculado aos dados para a fonte de dados, não retornando qualquer informação.

(Herdado de BindingManagerBase)
PushData()

Envia dados da fonte de dados para o controlo de dados, sem devolver qualquer informação.

(Herdado de BindingManagerBase)
Refresh()

Força a repovoação da lista encadenada pelos dados.

RemoveAt(Int32)

Remove o item no índice especificado.

ResumeBinding()

Retoma a ligação de dados.

SuspendBinding()

Suspende a ligação de dados para impedir que alterações atualizem a fonte de dados vinculada.

ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)
UpdateIsBinding()

Atualiza o estado da ligação.

evento

Name Description
BindingComplete

Ocorre na conclusão de uma operação de ligação de dados.

(Herdado de BindingManagerBase)
CurrentChanged

Ocorre quando o item atualmente vinculado muda.

(Herdado de BindingManagerBase)
CurrentItemChanged

Ocorre quando o estado do item atualmente atribuído muda.

(Herdado de BindingManagerBase)
DataError

Ocorre quando um Exception é silenciosamente tratado pelo BindingManagerBase.

(Herdado de BindingManagerBase)
ItemChanged

Ocorre quando o item atual foi alterado.

ListChanged

Ocorre quando a lista muda ou um item da lista muda.

MetaDataChanged

Ocorre quando os metadados do List mudaram.

PositionChanged

Ocorre depois de o valor da Position propriedade ter mudado.

(Herdado de BindingManagerBase)

Aplica-se a

Ver também