CurrencyManager Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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
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) |