Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase CurrencyManager

 

Publicado: octubre de 2016

Administra una lista de Binding objetos.

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

System.Object
  System.Windows.Forms.BindingManagerBase
    System.Windows.Forms.CurrencyManager

public class CurrencyManager : BindingManagerBase

NombreDescripción
System_CAPS_pubpropertyBindings

Obtiene la colección de enlaces que se administra.(Heredado de BindingManagerBase).

System_CAPS_pubpropertyCount

Obtiene el número de elementos de la lista.(Invalida BindingManagerBase.Count).

System_CAPS_pubpropertyCurrent

Obtiene el elemento actual de la lista.(Invalida BindingManagerBase.Current).

System_CAPS_pubpropertyIsBindingSuspended

Obtiene un valor que indica si el enlace se ha suspendido.(Heredado de BindingManagerBase).

System_CAPS_pubpropertyList

Obtiene la lista de este CurrencyManager.

System_CAPS_pubpropertyPosition

Obtiene o establece la posición en la que se encuentra dentro de la lista.(Invalida BindingManagerBase.Position).

NombreDescripción
System_CAPS_pubmethodAddNew()

Agrega un nuevo elemento a la lista subyacente.(Invalida BindingManagerBase.AddNew()).

System_CAPS_pubmethodCancelCurrentEdit()

Cancela la operación de edición actual.(Invalida BindingManagerBase.CancelCurrentEdit()).

System_CAPS_protmethodCheckEmpty()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Produce una excepción si no hay ninguna lista o la lista está vacía.

System_CAPS_pubmethodEndCurrentEdit()

Termina la operación de edición actual.(Invalida BindingManagerBase.EndCurrentEdit()).

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetItemProperties()

Obtiene la colección de descriptores de propiedades de la lista subyacente.(Invalida BindingManagerBase.GetItemProperties()).

System_CAPS_protmethodGetItemProperties(ArrayList, ArrayList)

Obtiene la colección de descriptores de propiedades para el enlace con el especificado ArrayList.(Heredado de BindingManagerBase).

System_CAPS_protmethodGetItemProperties(Type, Int32, ArrayList, ArrayList)

Obtiene la lista de propiedades de los elementos administrados por este BindingManagerBase.(Heredado de BindingManagerBase).

System_CAPS_protmethodGetListName(ArrayList)

Obtiene el nombre de la lista que proporciona los datos para el enlace que utiliza el conjunto de propiedades enlazadas especificado.(Invalida BindingManagerBase.GetListName(ArrayList)).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_protmethodOnBindingComplete(BindingCompleteEventArgs)

Genera el evento BindingComplete.(Heredado de BindingManagerBase).

System_CAPS_protmethodOnCurrentChanged(EventArgs)
System_CAPS_protmethodOnCurrentItemChanged(EventArgs)
System_CAPS_protmethodOnDataError(Exception)

Genera el evento DataError.(Heredado de BindingManagerBase).

System_CAPS_protmethodOnItemChanged(ItemChangedEventArgs)

Genera el evento ItemChanged.

System_CAPS_protmethodOnMetaDataChanged(EventArgs)

Genera el evento MetaDataChanged.

System_CAPS_protmethodOnPositionChanged(EventArgs)

Genera el evento PositionChanged.

System_CAPS_protmethodPullData()

Extrae datos del control con enlace a datos y los aplica al origen de datos, y no devuelve ninguna información.(Heredado de BindingManagerBase).

System_CAPS_protmethodPushData()

Extrae datos del origen de datos en el control con enlace a datos, y no devuelve ninguna información.(Heredado de BindingManagerBase).

System_CAPS_pubmethodRefresh()

Hace que la lista enlazada a datos vuelva a rellenarse.

System_CAPS_pubmethodRemoveAt(Int32)

Quita el elemento en el índice especificado.(Invalida BindingManagerBase.RemoveAt(Int32)).

System_CAPS_pubmethodResumeBinding()

Reanuda el enlace de datos.(Invalida BindingManagerBase.ResumeBinding()).

System_CAPS_pubmethodSuspendBinding()

Suspende el enlace de datos para evitar que los cambios actualicen el origen de datos enlazado.(Invalida BindingManagerBase.SuspendBinding()).

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

System_CAPS_protmethodUpdateIsBinding()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Actualiza el estado del enlace.(Invalida BindingManagerBase.UpdateIsBinding()).

NombreDescripción
System_CAPS_protfieldfinalType

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Especifica el tipo de datos de la lista.

System_CAPS_protfieldlistposition

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Especifica la posición actual de la CurrencyManager en la lista.

System_CAPS_protfieldonCurrentChangedHandler

Especifica el controlador de eventos para el CurrentChanged eventos.(Heredado de BindingManagerBase).

System_CAPS_protfieldonPositionChangedHandler

Especifica el controlador de eventos para el PositionChanged eventos.(Heredado de BindingManagerBase).

NombreDescripción
System_CAPS_pubeventBindingComplete

Se produce cuando finaliza una operación de enlace de datos.(Heredado de BindingManagerBase).

System_CAPS_pubeventCurrentChanged

Se produce cuando cambia el elemento enlazado actual. (Heredado de BindingManagerBase).

System_CAPS_pubeventCurrentItemChanged

Se produce cuando el estado del elemento enlazado actualmente cambia.(Heredado de BindingManagerBase).

System_CAPS_pubeventDataError

Se produce cuando un Exception controla silenciosamente el BindingManagerBase.(Heredado de BindingManagerBase).

System_CAPS_pubeventItemChanged

Se produce cuando se ha modificado el elemento actual.

System_CAPS_pubeventListChanged

Se produce cuando cambia la lista o un elemento de la lista.

System_CAPS_pubeventMetaDataChanged

Se produce cuando los metadatos de la List ha cambiado.

System_CAPS_pubeventPositionChanged

Se produce después del valor de la Position propiedad ha cambiado.(Heredado de BindingManagerBase).

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

El Current propiedad devuelve el elemento actual en la lista subyacente. Para cambiar el elemento actual, establezca el 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 el AllowNew propiedad se establece en true, puede utilizar el AddNew método.

El siguiente código de ejemplo se enlaza un TextBox control a una columna de un DataTable, obtiene la 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
Disponible desde 1.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: