¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
CurrencyManager (Clase)
Collapse the table of content
Expand the table of content
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original

CurrencyManager (Clase)

Administra una lista de objetos Binding.

Espacio de nombres:  System.Windows.Forms
Ensamblado:  System.Windows.Forms (en System.Windows.Forms.dll)

public class CurrencyManager : BindingManagerBase

El tipo CurrencyManager expone los siguientes miembros.

  NombreDescripción
Propiedad públicaBindingsObtiene la colección de enlaces que se administra. (Se hereda de BindingManagerBase).
Propiedad públicaCountObtiene el número de elementos de la lista. (Invalida a BindingManagerBase.Count).
Propiedad públicaCurrentObtiene el elemento actual de la lista. (Invalida a BindingManagerBase.Current).
Propiedad públicaIsBindingSuspendedObtiene un valor que indica si el enlace se ha suspendido. (Se hereda de BindingManagerBase).
Propiedad públicaListObtiene la ruta de acceso para CurrencyManager.
Propiedad públicaPositionObtiene o establece la posición en la que se encuentra dentro de la lista (Invalida a BindingManagerBase.Position).
Arriba

  NombreDescripción
Método públicoAddNewAgrega un nuevo elemento a la lista subyacente. (Invalida a BindingManagerBase.AddNew()).
Método públicoCancelCurrentEditCancela la operación de edición actual. (Invalida a BindingManagerBase.CancelCurrentEdit()).
Método protegidoCheckEmptyInfraestructura. Produce una excepción si no hay ninguna lista o la lista está vacía.
Método públicoEndCurrentEditTermina la operación de edición actual. (Invalida a BindingManagerBase.EndCurrentEdit()).
Método públicoEquals(Object)Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
Método protegidoFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Se hereda de Object).
Método públicoGetHashCodeActúa como función hash para un tipo concreto. (Se hereda de Object).
Método públicoGetItemProperties()Obtiene la colección de descriptores de propiedades de la lista subyacente. (Invalida a BindingManagerBase.GetItemProperties()).
Método protegidoGetItemProperties(ArrayList, ArrayList)Obtiene la colección de descriptores de propiedades para el enlace con el objeto ArrayList especificado. (Se hereda de BindingManagerBase).
Método protegidoGetItemProperties(Type, Int32, ArrayList, ArrayList)Obtiene la lista de propiedades de los elementos administrados por BindingManagerBase. (Se hereda de BindingManagerBase).
Método protegidoGetListNameObtiene el nombre de la lista que proporciona los datos para el enlace que utiliza el conjunto de propiedades enlazadas especificado. (Invalida a BindingManagerBase.GetListName(ArrayList)).
Método públicoGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método protegidoMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método protegidoOnBindingCompleteProvoca el evento BindingComplete. (Se hereda de BindingManagerBase).
Método protegidoOnCurrentChangedProvoca el evento CurrentChanged. (Invalida a BindingManagerBase.OnCurrentChanged(EventArgs)).
Método protegidoOnCurrentItemChangedProvoca el evento CurrentItemChanged. (Invalida a BindingManagerBase.OnCurrentItemChanged(EventArgs)).
Método protegidoOnDataErrorProvoca el evento DataError. (Se hereda de BindingManagerBase).
Método protegidoOnItemChangedGenera el evento ItemChanged.
Método protegidoOnMetaDataChangedDesencadena el evento MetaDataChanged.
Método protegidoOnPositionChangedDesencadena el evento PositionChanged.
Método protegidoPullDataExtrae datos del control con enlace a datos y los aplica al origen de datos, y no devuelve ninguna información. (Se hereda de BindingManagerBase).
Método protegidoPushDataExtrae datos del origen de datos en el control con enlace a datos, y no devuelve ninguna información. (Se hereda de BindingManagerBase).
Método públicoRefreshHace que la lista enlazada a datos vuelva a llenarse.
Método públicoRemoveAtQuita el elemento en el índice especificado. (Invalida a BindingManagerBase.RemoveAt(Int32)).
Método públicoResumeBindingReanuda el enlace de datos. (Invalida a BindingManagerBase.ResumeBinding()).
Método públicoSuspendBindingSuspende el enlace de datos para evitar que los cambios actualicen el origen de datos enlazado. (Invalida a BindingManagerBase.SuspendBinding()).
Método públicoToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Método protegidoUpdateIsBindingInfraestructura. Actualiza el estado del enlace. (Invalida a BindingManagerBase.UpdateIsBinding()).
Arriba

  NombreDescripción
Evento públicoBindingCompleteSe produce cuando finaliza una operación de enlace de datos. (Se hereda de BindingManagerBase).
Evento públicoCurrentChanged Se produce cuando cambia el elemento enlazado actual. (Se hereda de BindingManagerBase).
Evento públicoCurrentItemChangedSe produce cuando el estado del elemento enlazado actualmente cambia. (Se hereda de BindingManagerBase).
Evento públicoDataErrorSe produce cuando BindingManagerBase controla silenciosamente Exception. (Se hereda de BindingManagerBase).
Evento públicoItemChangedSe produce cuando se ha modificado el elemento actual.
Evento públicoListChangedSe produce cuando cambia la lista o un elemento de la lista.
Evento públicoMetaDataChangedSe produce cuando los metadatos de List han cambiado.
Evento públicoPositionChangedSe produce después de que cambie el valor de la propiedad Position. (Se hereda de BindingManagerBase).
Arriba

  NombreDescripción
Campo protegidofinalTypeInfraestructura. Especifica el tipo de datos de la lista.
Campo protegidolistpositionInfraestructura. Especifica la posición actual del objeto CurrencyManager en la lista.
Campo protegidoonCurrentChangedHandlerEspecifica el controlador de eventos para el evento CurrentChanged. (Se hereda de BindingManagerBase).
Campo protegidoonPositionChangedHandlerEspecifica el controlador de eventos para el evento PositionChanged. (Se hereda de BindingManagerBase).
Arriba

CurrencyManager se deriva de la clase BindingManagerBase. Use BindingContext para devolver CurrencyManager o PropertyManager. El objeto real que se devuelve depende del origen de datos y del miembro de datos que se pasa a la propiedad Item de BindingContext. Si el origen de datos es un objeto que sólo puede devolver una única propiedad (en lugar de una lista de objetos), el tipo será PropertyManager. Por ejemplo, si especifica TextBox como origen de datos, se devolverá PropertyManager. Si, en cambio, el origen de datos es un objeto que implementa la interfaz IList, IListSource o IBindingList, se devolverá CurrencyManager.

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

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

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


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;
 }



.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft