BindingManagerBase Clase

Definición

public ref class BindingManagerBase abstract

public abstract class BindingManagerBase

type BindingManagerBase = class

Public MustInherit Class BindingManagerBase

Herencia

Object

BindingManagerBase

Derivado

System.Windows.Forms.CurrencyManager

System.Windows.Forms.PropertyManager

Ejemplos

En el ejemplo de código siguiente se usa para BindingContext devolver un BindingManagerBase para un origen de datos específico. (En el ejemplo se supone que ha declarado myBindingManagerBase en la sección Declaraciones del módulo). A continuación, en el ejemplo se agregan delegados de eventos a los CurrentChanged eventos y PositionChanged . Por último, el ejemplo contiene cuatro métodos (, , y MoveLast) que incrementan o disminuyen la Position propiedad y establecen en Position la primera o última fila de la MoveFirstlista. MovePreviousMoveNext La última fila de la lista se determina mediante la Count propiedad .

void GetBindingManagerBase()
{
   
   /* CustomersToOrders is the RelationName of a DataRelation. 
      Therefore, the list maintained by the BindingManagerBase is the
      list of orders that belong to a specific customer in the 
      DataTable named Customers, found in DataSet1. */
   myBindingManagerBase = this->BindingContext[DataSet1, "Customers.CustomersToOrders"];
   
   // Adds delegates to the CurrentChanged and PositionChanged events.
   myBindingManagerBase->PositionChanged += gcnew EventHandler( this, &Form1::BindingManagerBase_PositionChanged );
   myBindingManagerBase->CurrentChanged += gcnew EventHandler( this, &Form1::BindingManagerBase_CurrentChanged );
}

void BindingManagerBase_PositionChanged( Object^ sender, EventArgs^ /*e*/ )
{
   
   // Prints the new Position of the BindingManagerBase.
   Console::Write( "Position Changed: " );
   Console::WriteLine( (dynamic_cast<BindingManagerBase^>(sender))->Position );
}

void BindingManagerBase_CurrentChanged( Object^ sender, EventArgs^ /*e*/ )
{
   
   // Prints the new value of the current object.
   Console::Write( "Current Changed: " );
   Console::WriteLine( (dynamic_cast<BindingManagerBase^>(sender))->Current );
}

void MoveNext()
{
   
   // Increments the Position property value by one.
   myBindingManagerBase->Position = myBindingManagerBase->Position + 1;
}

void MovePrevious()
{
   
   // Decrements the Position property value by one.
   myBindingManagerBase->Position = myBindingManagerBase->Position - 1;
}

void MoveFirst()
{
   
   // Goes to the first row in the list.
   myBindingManagerBase->Position = 0;
}

void MoveLast()
{
   
   // Goes to the last row in the list.
   myBindingManagerBase->Position = myBindingManagerBase->Count - 1;
}

private void GetBindingManagerBase()
{
   /* CustomersToOrders is the RelationName of a DataRelation. 
   Therefore, the list maintained by the BindingManagerBase is the
   list of orders that belong to a specific customer in the 
   DataTable named Customers, found in DataSet1. */
   myBindingManagerBase = 
   this.BindingContext[DataSet1, "Customers.CustomersToOrders"];

   // Adds delegates to the CurrentChanged and PositionChanged events.
   myBindingManagerBase.PositionChanged += 
   new EventHandler(BindingManagerBase_PositionChanged);
   myBindingManagerBase.CurrentChanged +=
   new EventHandler(BindingManagerBase_CurrentChanged);
}

private void BindingManagerBase_PositionChanged
(object sender, EventArgs e)
{
   // Prints the new Position of the BindingManagerBase.
   Console.Write("Position Changed: ");
   Console.WriteLine(((BindingManagerBase)sender).Position);
}

private void BindingManagerBase_CurrentChanged
(object sender, EventArgs e)
{
   // Prints the new value of the current object.
   Console.Write("Current Changed: ");
   Console.WriteLine(((BindingManagerBase)sender).Current);
}

private void MoveNext()
{
   // Increments the Position property value by one.
   myBindingManagerBase.Position += 1;
}

private void MovePrevious()
{
   // Decrements the Position property value by one.
   myBindingManagerBase.Position -= 1;
}

private void MoveFirst()
{
   // Goes to the first row in the list.
   myBindingManagerBase.Position = 0;
}

private void MoveLast()
{
   // Goes to the last row in the list.
   myBindingManagerBase.Position = 
   myBindingManagerBase.Count - 1;
}

Private Sub GetBindingManagerBase
   ' CustomersToOrders is the RelationName of a DataRelation.
   ' Therefore, the list maintained by the BindingManagerBase is the
   ' list of orders that belong to a specific customer in the
   ' DataTable named Customers, found in DataSet.
   myBindingManagerBase = Me.BindingContext(DataSet1, _
   "Customers.CustomersToOrders")

   ' Adds delegates to the CurrentChanged and PositionChanged events.
   AddHandler myBindingManagerBase.PositionChanged, _
   AddressOf BindingManagerBase_PositionChanged
   AddHandler myBindingManagerBase.CurrentChanged, _
   AddressOf BindingManagerBase_CurrentChanged
End Sub

Private Sub BindingManagerBase_PositionChanged _
(sender As Object, e As EventArgs)

   ' Prints the new Position of the BindingManagerBase.
   Console.Write("Position Changed: ")
   Console.WriteLine(CType(sender, BindingManagerBase).Position)
End Sub

Private Sub BindingManagerBase_CurrentChanged _
(sender As Object, e As EventArgs)

   ' Prints the new value of the current object.
   Console.Write("Current Changed: ")
   Console.WriteLine(CType(sender, BindingManagerBase).Current)
End Sub

Private Sub MoveNext
   ' Increments the Position property value by one.
   myBindingManagerBase.Position += 1
End Sub

Private Sub MovePrevious
   ' Decrements the Position property value by one.
   myBindingManagerBase.Position -= 1
End Sub

Private Sub MoveFirst
   ' Goes to the first row in the list.
   myBindingManagerBase.Position = 0
End Sub

Private Sub MoveLast
   ' Goes to the last row in the list.
   myBindingManagerBase.Position = _
   myBindingManagerBase.Count - 1
End Sub

Comentarios

BindingManagerBase habilita la sincronización de controles enlazados a datos en un formulario Windows Forms enlazado al mismo origen de datos. (Para obtener más información sobre el enlace sencillo de un control a un origen de datos, vea la Binding clase ). Por ejemplo, supongamos que un formulario contiene dos TextBox controles enlazados al mismo origen de datos, pero a columnas diferentes. El origen de datos puede ser un DataTable que contiene nombres de cliente, mientras que las columnas pueden contener los nombres y apellidos. Los dos controles deben sincronizarse para mostrar los nombres y los apellidos correctos para el mismo cliente. , CurrencyManagerque hereda de la BindingManagerBase clase , realiza esta sincronización manteniendo un puntero al elemento actual del origen de datos. Los TextBox controles se enlazan al elemento actual para que muestren la información de la misma fila. Cuando cambia el elemento actual, CurrencyManager notifica a todos los controles enlazados para que puedan actualizar sus datos. Además, puede establecer la Position propiedad para especificar la fila en la DataTable que apuntan los controles. Para determinar cuántas filas existen en el origen de datos, use la Count propiedad .

CurrencyManager es necesario porque los orígenes de datos no mantienen necesariamente un puntero de elemento actual. Por ejemplo, las matrices y ArrayList los objetos pueden ser orígenes de datos, pero no tienen una propiedad que devuelva el elemento actual. Para obtener el elemento actual, use la Current propiedad .

PropertyManager También hereda de BindingManagerBase, y se usa para mantener la propiedad actual de un objeto, en lugar de la propiedad de un objeto actual en un origen de datos. Por este motivo, intentar establecer la Position propiedad o Count para un objeto PropertyManager no tiene ningún efecto.

Para crear un BindingManagerBase, use la BindingContext clase , que devuelve o CurrencyManager , PropertyManageren función del origen de datos que se administre.

Se recomienda a los programadores de soluciones enlazar controles directamente a un BindingSource componente, que actúa como un origen de datos y un conector de datos al origen de datos de destino real. BindingSource simplifica considerablemente el enlace de datos simple y complejo, incluida la administración de monedas entre el control y su destino.

Notas a los implementadores

Cuando hereda de BindingManagerBase, debe invalidar los siguientes miembros abstractos: AddNew(), Count, CancelCurrentEdit(), Current, GetItemProperties()RemoveAt(Int32)EndCurrentEdit()PositionResumeBinding()OnCurrentChanged(EventArgs), SuspendBinding()y .UpdateIsBinding()

Constructores

Campos

Propiedades

Métodos

Eventos

Se aplica a

Consulte también

• BindingSource
• BindingContext
• CurrencyManager
• PropertyManager