Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe BindingManagerBase

 

Gerencia todos os objetos Binding associados à mesma fonte de dados e ao mesmo membro de dados. Esta classe é abstrata.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (em System.Windows.Forms.dll)


public abstract class BindingManagerBase

NomeDescrição
System_CAPS_pubmethodBindingManagerBase()

Inicializa uma nova instância da classe BindingManagerBase.

NomeDescrição
System_CAPS_pubpropertyBindings

Obtém a coleção de associações que está sendo gerenciado.

System_CAPS_pubpropertyCount

Quando substituído em uma classe derivada, obtém o número de linhas gerenciados pelo BindingManagerBase.

System_CAPS_pubpropertyCurrent

Quando substituído em uma classe derivada, obtém o objeto atual.

System_CAPS_pubpropertyIsBindingSuspended

Obtém um valor que indica se a associação está suspenso.

System_CAPS_pubpropertyPosition

Quando substituído em uma classe derivada, obtém ou define a posição na lista subjacente para a qual os controles associados a essa fonte de dados apontam.

NomeDescrição
System_CAPS_pubmethodAddNew()

Quando substituído em uma classe derivada, adiciona um novo item à lista subjacente.

System_CAPS_pubmethodCancelCurrentEdit()

Quando substituído em uma classe derivada, cancela a edição atual.

System_CAPS_pubmethodEndCurrentEdit()

Ao ser substituído em uma classe derivada, finaliza a edição atual.

System_CAPS_pubmethodEquals(Object)

Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)

System_CAPS_protmethodFinalize()

Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)

System_CAPS_pubmethodGetHashCode()

Serve como a função de hash padrão.(Herdado de Object.)

System_CAPS_pubmethodGetItemProperties()

Quando substituído em uma classe derivada, obtém a coleção de descritores de propriedades para a associação.

System_CAPS_protmethodGetItemProperties(ArrayList, ArrayList)

Obtém a coleção de descritores de propriedades para a associação usando especificado ArrayList.

System_CAPS_protmethodGetItemProperties(Type, Int32, ArrayList, ArrayList)

Obtém a lista de propriedades dos itens gerenciados por este BindingManagerBase.

System_CAPS_protmethodGetListName(ArrayList)

Quando substituído em uma classe derivada, obtém o nome da lista fornecendo dados para a associação.

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_protmethodMemberwiseClone()

Cria uma cópia superficial do Object atual.(Herdado de Object.)

System_CAPS_protmethodOnBindingComplete(BindingCompleteEventArgs)

Gera o BindingComplete evento.

System_CAPS_protmethodOnCurrentChanged(EventArgs)

Gera o CurrentChanged evento.

System_CAPS_protmethodOnCurrentItemChanged(EventArgs)

Gera o CurrentItemChanged evento.

System_CAPS_protmethodOnDataError(Exception)

Gera o DataError evento.

System_CAPS_protmethodPullData()

Extrai dados do controle ligado a dados na fonte de dados, não retornando nenhuma informação.

System_CAPS_protmethodPushData()

Envia dados da fonte de dados para o controle ligado a dados, não retornando nenhuma informação.

System_CAPS_pubmethodRemoveAt(Int32)

Quando substituído em uma classe derivada, exclui a linha no índice especificado da lista subjacente.

System_CAPS_pubmethodResumeBinding()

Quando substituído em uma classe derivada, retoma a associação de dados.

System_CAPS_pubmethodSuspendBinding()

Quando substituído em uma classe derivada, suspende a vinculação de dados.

System_CAPS_pubmethodToString()

Retorna uma string que representa o objeto atual.(Herdado de Object.)

System_CAPS_protmethodUpdateIsBinding()

Quando substituído em uma classe derivada, atualiza a associação.

NomeDescrição
System_CAPS_protfieldonCurrentChangedHandler

Especifica o manipulador de eventos para o CurrentChanged evento.

System_CAPS_protfieldonPositionChangedHandler

Especifica o manipulador de eventos para o PositionChanged evento.

NomeDescrição
System_CAPS_pubeventBindingComplete

Ocorre após a conclusão de uma operação de associação de dados.

System_CAPS_pubeventCurrentChanged

Ocorre quando o item associado no momento é alterado.

System_CAPS_pubeventCurrentItemChanged

Ocorre quando o estado do item associado no momento é alterado.

System_CAPS_pubeventDataError

Ocorre quando um Exception silenciosamente é tratada pelo BindingManagerBase.

System_CAPS_pubeventPositionChanged

Ocorre depois que o valor da propriedade Position é alterado.

The T:System.Windows.Forms.BindingManagerBase enables the synchronization of data-bound controls on a Windows Form that are bound to the same data source. (For more information about simple binding a control to a data source, see the T:System.Windows.Forms.Binding class.) For example, suppose that a form contains two T:System.Windows.Forms.TextBox controls that are bound to the same data source but to different columns. The data source might be a T:System.Data.DataTable that contains customer names, while the columns might contain the first and last names. The two controls must be synchronized in order to display the correct first and last names together for the same customer. The T:System.Windows.Forms.CurrencyManager, which inherits from the T:System.Windows.Forms.BindingManagerBase class, accomplishes this synchronization by maintaining a pointer to the current item in the data source. The T:System.Windows.Forms.TextBox controls are bound to the current item so they display the information for the same row. When the current item changes, the T:System.Windows.Forms.CurrencyManager notifies all the bound controls so that they can refresh their data. Furthermore, you can set the P:System.Windows.Forms.BindingManagerBase.Position property to specify the row in the T:System.Data.DataTable that the controls point to. To determine how many rows exist in the data source, use the P:System.Windows.Forms.BindingManagerBase.Count property.

The T:System.Windows.Forms.CurrencyManager is necessary because data sources do not necessarily maintain a current-item pointer. For instance, arrays and T:System.Collections.ArrayList objects can be data sources, but they do not have a property that returns the current item. To get the current item, use the P:System.Windows.Forms.BindingManagerBase.Current property.

The T:System.Windows.Forms.PropertyManager also inherits from the T:System.Windows.Forms.BindingManagerBase, and it is used to maintain the current property of an object, rather than the property of a current object in a data source. For this reason, trying to set the P:System.Windows.Forms.BindingManagerBase.Position or P:System.Windows.Forms.BindingManagerBase.Count property for a T:System.Windows.Forms.PropertyManager has no effect.

To create a T:System.Windows.Forms.BindingManagerBase, use the T:System.Windows.Forms.BindingContext class, which returns either a T:System.Windows.Forms.CurrencyManager or a T:System.Windows.Forms.PropertyManager, depending on the data source being managed.

Solutions programmers are encouraged to bind controls directly to a T:System.Windows.Forms.BindingSource component, which acts as both a data source and data connector to the actual target data source. T:System.Windows.Forms.BindingSource greatly simplifies both simple and complex data binding, including managing currency between the control and its target.

Observações para os Herdeiros:

When you inherit from T:System.Windows.Forms.BindingManagerBase, you must override the following abstract members: M:System.Windows.Forms.BindingManagerBase.AddNew, P:System.Windows.Forms.BindingManagerBase.Count, M:System.Windows.Forms.BindingManagerBase.CancelCurrentEdit, P:System.Windows.Forms.BindingManagerBase.Current, M:System.Windows.Forms.BindingManagerBase.EndCurrentEdit, M:System.Windows.Forms.BindingManagerBase.GetItemProperties, M:System.Windows.Forms.BindingManagerBase.OnCurrentChanged(System.EventArgs), P:System.Windows.Forms.BindingManagerBase.Position, M:System.Windows.Forms.BindingManagerBase.RemoveAt(System.Int32), M:System.Windows.Forms.BindingManagerBase.ResumeBinding, M:System.Windows.Forms.BindingManagerBase.SuspendBinding, and M:System.Windows.Forms.BindingManagerBase.UpdateIsBinding.

The following code example uses the T:System.Windows.Forms.BindingContext to return a T:System.Windows.Forms.BindingManagerBase for a specific data source. (The example assumes you have declared myBindingManagerBase in the Declarations section of the module.) The example then adds event delegates to the E:System.Windows.Forms.BindingManagerBase.CurrentChanged and E:System.Windows.Forms.BindingManagerBase.PositionChanged events. Lastly, the example contains four methods (MoveNext, MovePrevious, MoveFirst, and MoveLast) that increment or decrement the P:System.Windows.Forms.BindingManagerBase.Position property, and set the P:System.Windows.Forms.BindingManagerBase.Position to the first or last row in the list. The last row in the list is determined by using the P:System.Windows.Forms.BindingManagerBase.Count property.

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

.NET Framework
Disponível desde 1.1

Quaisquer membros estáticos públicos ( Compartilhado no Visual Basic) desse tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Retornar ao início
Mostrar: