CurrencyManager Clase

Definición

Administra una lista de objetos Binding.Manages a list of Binding objects.

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
CurrencyManager

Ejemplos

En el ejemplo de código siguiente se TextBox enlaza un control a una columna de CurrencyManager ,seobtieneelparaelenlaceyseDataTableestablece su posición.The following code example binds a TextBox control to a column in a DataTable, gets the CurrencyManager for the binding, and sets its position.

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

Deriva de la BindingManagerBaseclase. CurrencyManagerThe CurrencyManager derives from the BindingManagerBase class. Utilice para devolver CurrencyManager o PropertyManager. BindingContextUse the BindingContext to return either a CurrencyManager or a PropertyManager. El objeto real devuelto depende del origen Item[Object] BindingContextde datos y del miembro de datos que se pasa a la propiedad de.The actual object returned depends on the data source and data member passed to the Item[Object] property of the BindingContext. Si el origen de datos es un objeto que solo puede devolver una propiedad (en lugar de una lista de objetos), el tipo PropertyManagerserá.If the data source is an object that can return only a single property (instead of a list of objects), the type will be a PropertyManager. Por ejemplo, si especifica TextBox como origen de datos, se devolverá un. PropertyManagerFor example, if you specify a TextBox as the data source, a PropertyManager will be returned. Por otro lado, si el origen de datos es un objeto IListque implementa la interfaz, IListSourceo IBindingList , se devolverá CurrencyManager un.If, on the other hand, the data source is an object that implements the IList, IListSource, or IBindingList interface, a CurrencyManager will be returned.

La Current propiedad devuelve el elemento actual de la lista subyacente.The Current property returns the current item in the underlying list. Para cambiar el elemento actual, establezca la Position propiedad en un nuevo valor.To change the current item, set the Position property to a new value. El valor debe ser mayor que 0 y debe ser menor que el valor de la Count propiedad.The value must be greater than 0 and must be less than the value of the Count property.

Si el origen de datos subyacente implementa la IBindingList interfaz y la AllowNew propiedad está establecida en true, puede utilizar el AddNew método.If the underlying data source implements the IBindingList interface, and the AllowNew property is set to true, you can use the AddNew method.

Campos

finalType

Especifica el tipo de datos de la lista.Specifies the data type of the list.

listposition

Especifica la posición actual del objeto CurrencyManager en la lista.Specifies the current position of the CurrencyManager in the list.

onCurrentChangedHandler

Especifica el controlador de eventos para el evento CurrentChanged.Specifies the event handler for the CurrentChanged event.

(Heredado de BindingManagerBase)
onPositionChangedHandler

Especifica el controlador de eventos para el evento PositionChanged.Specifies the event handler for the PositionChanged event.

(Heredado de BindingManagerBase)

Propiedades

Bindings

Obtiene la colección de enlaces que se administra.Gets the collection of bindings being managed.

(Heredado de BindingManagerBase)
Count

Obtiene el número de elementos de la lista.Gets the number of items in the list.

Current

Obtiene el elemento actual de la lista.Gets the current item in the list.

IsBindingSuspended

Obtiene un valor que indica si el enlace se ha suspendido.Gets a value indicating whether binding is suspended.

(Heredado de BindingManagerBase)
List

Obtiene la ruta de acceso para CurrencyManager.Gets the list for this CurrencyManager.

Position

Obtiene o establece la posición en la que se encuentra dentro de la listaGets or sets the position you are at within the list.

Métodos

AddNew()

Agrega un nuevo elemento a la lista subyacente.Adds a new item to the underlying list.

CancelCurrentEdit()

Cancela la operación de edición actual.Cancels the current edit operation.

CheckEmpty()

Produce una excepción si no hay ninguna lista o la lista está vacía.Throws an exception if there is no list, or the list is empty.

EndCurrentEdit()

Termina la operación de edición actual.Ends the current edit operation.

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetItemProperties()

Obtiene la colección de descriptores de propiedades de la lista subyacente.Gets the property descriptor collection for the underlying list.

GetItemProperties(ArrayList, ArrayList)

Obtiene la colección de descriptores de propiedades para el enlace con el objeto ArrayList especificado.Gets the collection of property descriptors for the binding using the specified ArrayList.

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

Obtiene la lista de propiedades de los elementos administrados por BindingManagerBase.Gets the list of properties of the items managed by this 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.Gets the name of the list supplying the data for the binding using the specified set of bound properties.

GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
OnBindingComplete(BindingCompleteEventArgs)

Genera el evento BindingComplete.Raises the BindingComplete event.

(Heredado de BindingManagerBase)
OnCurrentChanged(EventArgs)

Genera el evento CurrentChanged.Raises the CurrentChanged event.

OnCurrentItemChanged(EventArgs)

Genera el evento CurrentItemChanged.Raises the CurrentItemChanged event.

OnDataError(Exception)

Genera el evento DataError.Raises the DataError event.

(Heredado de BindingManagerBase)
OnItemChanged(ItemChangedEventArgs)

Genera el evento ItemChanged.Raises the ItemChanged event.

OnMetaDataChanged(EventArgs)

Genera el evento MetaDataChanged.Raises the MetaDataChanged event.

OnPositionChanged(EventArgs)

Genera el evento PositionChanged.Raises the PositionChanged event.

PullData()

Extrae datos del control con enlace a datos y los aplica al origen de datos, y no devuelve ninguna información.Pulls data from the data-bound control into the data source, returning no information.

(Heredado de BindingManagerBase)
PushData()

Extrae datos del origen de datos en el control con enlace a datos, y no devuelve ninguna información.Pushes data from the data source into the data-bound control, returning no information.

(Heredado de BindingManagerBase)
Refresh()

Hace que la lista enlazada a datos vuelva a llenarse.Forces a repopulation of the data-bound list.

RemoveAt(Int32)

Quita el elemento en el índice especificado.Removes the item at the specified index.

ResumeBinding()

Reanuda el enlace de datos.Resumes data binding.

SuspendBinding()

Suspende el enlace de datos para evitar que los cambios actualicen el origen de datos enlazado.Suspends data binding to prevents changes from updating the bound data source.

ToString()

Devuelve un valor de tipo string que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)
UpdateIsBinding()

Actualiza el estado del enlace.Updates the status of the binding.

Eventos

BindingComplete

Se produce cuando finaliza una operación de enlace de datos.Occurs at the completion of a data-binding operation.

(Heredado de BindingManagerBase)
CurrentChanged

Se produce cuando cambia el elemento enlazado actualmente.Occurs when the currently bound item changes.

(Heredado de BindingManagerBase)
CurrentItemChanged

Se produce cuando el estado del elemento enlazado actualmente cambia.Occurs when the state of the currently bound item changes.

(Heredado de BindingManagerBase)
DataError

Se produce cuando Exception controla silenciosamente BindingManagerBase.Occurs when an Exception is silently handled by the BindingManagerBase.

(Heredado de BindingManagerBase)
ItemChanged

Se produce cuando se ha modificado el elemento actual.Occurs when the current item has been altered.

ListChanged

Se produce cuando cambia la lista o un elemento de la lista.Occurs when the list changes or an item in the list changes.

MetaDataChanged

Se produce cuando los metadatos de List han cambiado.Occurs when the metadata of the List has changed.

PositionChanged

Se produce después de haber cambiado el valor de la propiedad Position.Occurs after the value of the Position property has changed.

(Heredado de BindingManagerBase)

Se aplica a

Consulte también: