CurrencyManager Clase

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Source:

CurrencyManager.cs

Administra una 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

Herencia

Object

BindingManagerBase

CurrencyManager

Ejemplos

En el ejemplo de código siguiente se enlaza un TextBox control a una columna de , DataTableobtiene para CurrencyManager el enlace y establece su posición.

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

Comentarios

CurrencyManager deriva de la BindingManagerBase clase . BindingContext Use para devolver o CurrencyManager .PropertyManager El objeto real devuelto depende del origen de datos y del miembro de datos pasado a la Item[] propiedad de BindingContext. Si el origen de datos es un objeto que solo puede devolver una sola propiedad (en lugar de una lista de objetos), el tipo será .PropertyManager Por ejemplo, si especifica un TextBox elemento como origen de datos, se devolverá .PropertyManager Si, por otro lado, el origen de datos es un objeto que implementa la IListinterfaz , IListSourceo IBindingList , se devolverá un CurrencyManager .

La Current propiedad devuelve el elemento actual de la lista subyacente. Para cambiar el elemento actual, establezca la Position propiedad en un nuevo valor. El valor debe ser mayor que 0 y debe ser menor que el valor de la Count propiedad .

Si el origen de datos subyacente implementa la IBindingList interfaz y la AllowNew propiedad se establece trueen , puede usar el AddNew método .

Campos

Nombre	Description
finalType	Especifica el tipo de datos de la lista.
listposition	Especifica la posición actual de en CurrencyManager la lista.
onCurrentChangedHandler	Especifica el controlador de eventos para el CurrentChanged evento. (Heredado de BindingManagerBase)
onPositionChangedHandler	Especifica el controlador de eventos para el PositionChanged evento. (Heredado de BindingManagerBase)

Propiedades

Nombre	Description
Bindings	Obtiene la colección de enlaces que se administran. (Heredado de BindingManagerBase)
Count	Obtiene el número de elementos de la lista.
Current	Obtiene el elemento actual de la lista.
IsBindingSuspended	Obtiene un valor que indica si el enlace está suspendido. (Heredado de BindingManagerBase)
List	Obtiene la lista de este CurrencyManagerobjeto .
Position	Obtiene o establece la posición que se encuentra en la lista.

Métodos

Nombre	Description
AddNew()	Agrega un nuevo elemento a la lista subyacente.
CancelCurrentEdit()	Cancela la operación de edición actual.
CheckEmpty()	Produce una excepción si no hay ninguna lista o la lista está vacía.
EndCurrentEdit()	Finaliza la operación de edición actual.
GetItemProperties()	Obtiene la colección de descriptores de propiedad de la lista subyacente.
GetItemProperties(ArrayList, ArrayList)	Obtiene la colección de descriptores de propiedad para el enlace mediante el especificado ArrayList. (Heredado de BindingManagerBase)
GetItemProperties(Type, Int32, ArrayList, ArrayList)	Obtiene la lista de propiedades de los elementos administrados por este BindingManagerBase. (Heredado de BindingManagerBase)
GetListName(ArrayList)	Obtiene el nombre de la lista que proporciona los datos para el enlace mediante el conjunto especificado de propiedades enlazadas.
OnBindingComplete(BindingCompleteEventArgs)	Genera el evento BindingComplete. (Heredado de BindingManagerBase)
OnCurrentChanged(EventArgs)	Genera el evento CurrentChanged.
OnCurrentItemChanged(EventArgs)	Genera el evento CurrentItemChanged.
OnDataError(Exception)	Genera el evento DataError. (Heredado de BindingManagerBase)
OnItemChanged(ItemChangedEventArgs)	Genera el evento ItemChanged.
OnMetaDataChanged(EventArgs)	Genera el evento MetaDataChanged.
OnPositionChanged(EventArgs)	Genera el evento PositionChanged.
PullData()	Extrae datos del control enlazado a datos en el origen de datos y no devuelve información. (Heredado de BindingManagerBase)
PushData()	Inserta datos del origen de datos en el control enlazado a datos y no devuelve información. (Heredado de BindingManagerBase)
Refresh()	Fuerza una repoblación de la lista enlazada a datos.
RemoveAt(Int32)	Quita el elemento en el índice especificado.
ResumeBinding()	Reanuda el enlace de datos.
SuspendBinding()	Suspende el enlace de datos para evitar que los cambios actualicen el origen de datos enlazado.
UpdateIsBinding()	Actualiza el estado del enlace.

Eventos

Nombre	Description
BindingComplete	Se produce al finalizar una operación de enlace de datos. (Heredado de BindingManagerBase)
CurrentChanged	Se produce cuando cambia el elemento enlazado actualmente. (Heredado de BindingManagerBase)
CurrentItemChanged	Se produce cuando cambia el estado del elemento enlazado actualmente. (Heredado de BindingManagerBase)
DataError	Se produce cuando el BindingManagerBasecontrol de un Exception objeto se controla de forma silenciosa. (Heredado de BindingManagerBase)
ItemChanged	Se produce cuando se ha modificado el elemento actual.
ListChanged	Se produce cuando cambia la lista o cambia un elemento de la lista.
MetaDataChanged	Se produce cuando han cambiado los metadatos de .List
PositionChanged	Se produce después de que el valor de la Position propiedad haya cambiado. (Heredado de BindingManagerBase)

Consulte también

• BindingsCollection
• BindingContext
• Binding