CurrencyManager Clase

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

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

Herencia

Object

BindingManagerBase

CurrencyManager

Ejemplos

En el ejemplo de código siguiente se enlaza un TextBox control a una columna de , DataTablese obtiene para CurrencyManager el enlace y se 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 el miembro de datos pasados 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 como TextBox origen de datos, se devolverá .PropertyManager Por otro lado, si el origen de datos es un objeto que implementa la IListinterfaz , IListSourceo IBindingList , se devolverá .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

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

Propiedades

Bindings	Obtiene la colección de enlaces que se administra. (Heredado de BindingManagerBase)
Count	Obtiene el número total de elementos de la lista.
Current	Obtiene el elemento actual de la lista.
IsBindingSuspended	Obtiene un valor que indica si el enlace se ha suspendido. (Heredado de BindingManagerBase)
List	Obtiene la ruta de acceso para CurrencyManager.
Position	Obtiene o establece la posición en la que se encuentra dentro de la lista.

Métodos

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()	Termina la operación de edición actual.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetItemProperties()	Obtiene la colección de descriptores de propiedades de la lista subyacente.
GetItemProperties(ArrayList, ArrayList)	Obtiene la colección de descriptores de propiedades para el enlace con el objeto ArrayList especificado. (Heredado de BindingManagerBase)
GetItemProperties(Type, Int32, ArrayList, ArrayList)	Obtiene la lista de propiedades de los elementos administrados por BindingManagerBase. (Heredado de BindingManagerBase)
GetListName(ArrayList)	Obtiene el nombre de la lista que proporciona los datos para el enlace que utiliza el conjunto de propiedades enlazadas especificado.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
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 con enlace a datos y los aplica al origen de datos, y no devuelve ninguna información. (Heredado de BindingManagerBase)
PushData()	Extrae datos del origen de datos en el control con enlace a datos, y no devuelve ninguna información. (Heredado de BindingManagerBase)
Refresh()	Hace que la lista enlazada a datos vuelva a rellenarse.
RemoveAt(Int32)	Quita el elemento del í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.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
UpdateIsBinding()	Actualiza el estado del enlace.

Eventos

BindingComplete	Se produce cuando finaliza 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 el estado del elemento enlazado actualmente cambia. (Heredado de BindingManagerBase)
DataError	Se produce cuando Exception controla silenciosamente BindingManagerBase. (Heredado de BindingManagerBase)
ItemChanged	Se produce cuando se ha modificado el elemento actual.
ListChanged	Se produce cuando cambia la lista o un elemento de la lista.
MetaDataChanged	Se produce cuando los metadatos de List han cambiado.
PositionChanged	Se produce después de haber cambiado el valor de la propiedad Position. (Heredado de BindingManagerBase)

Consulte también

• BindingsCollection
• BindingContext
• Binding