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 Binding objetos vinculados para o mesmo membro de dados e fonte 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 que controles vinculados a esse ponto de origem de dados para.

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()

Quando substituído em uma classe derivada, termina 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 associaçã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 vinculação de dados.

System_CAPS_pubeventCurrentChanged

Ocorre quando o item vinculado é alterado.

System_CAPS_pubeventCurrentItemChanged

Ocorre quando o estado do item vinculado é alterado.

System_CAPS_pubeventDataError

Ocorre quando um Exception silenciosamente é tratada pelo BindingManagerBase.

System_CAPS_pubeventPositionChanged

Ocorre após o valor de Position propriedade foi alterada.

O BindingManagerBase habilita a sincronização de controles ligados a dados em um Windows Form que estão associados à mesma fonte de dados. (Para obter mais informações sobre simples associando um controle a uma fonte de dados, consulte o Binding classe.) Por exemplo, suponha que um formulário contém dois TextBox controles que estão associados à mesma fonte de dados, mas em colunas diferentes. A fonte de dados pode ser um DataTable que contém nomes de clientes, enquanto as colunas contêm os nomes e sobrenomes. Os dois controles devem ser sincronizados para exibir os nomes e sobrenomes corretos para o mesmo cliente. O CurrencyManager, que herda o BindingManagerBase da classe, realiza essa sincronização mantendo um ponteiro para o item atual na fonte de dados. O TextBox controles estão associados ao item atual para que sejam exibidas as informações para a mesma linha. Quando o item atual for alterado, o CurrencyManager notifica todos o limite controles de modo que eles podem atualizar seus dados. Além disso, você pode definir o Position propriedade para especificar a linha de DataTable que os controles apontam para. Para determinar quantas linhas existem na fonte de dados, use o Count propriedade.

O CurrencyManager é necessária porque as fontes de dados não necessariamente mantêm um ponteiro de item atual. Por exemplo, matrizes e ArrayList objetos podem ser fontes de dados, mas eles não têm uma propriedade que retorna o item atual. Para obter o item atual, use o Current propriedade.

O PropertyManager também herda a partir de BindingManagerBase, e ele é usado para manter a propriedade atual de um objeto, em vez da propriedade de um objeto em uma fonte de dados atual. Por esse motivo, ao tentar definir o Position ou Count propriedade para um PropertyManager não tem nenhum efeito.

Para criar um BindingManagerBase, use o BindingContext classe, que retorna um CurrencyManager ou um PropertyManager, dependendo da fonte de dados que está sendo gerenciada.

Os programadores de soluções são incentivados a associar controles diretamente a um BindingSource componente, que atua como uma fonte de dados e o conector de dados para a fonte de dados de destino real. BindingSource simplifica os dois vinculação de dados simples e complexas, incluindo o gerenciamento de moeda entre o controle e seu destino.

Observações para os Herdeiros:

Quando você herdar de BindingManagerBase, você deve substituir os seguintes membros abstratos: AddNew, Count, CancelCurrentEdit, Current, EndCurrentEdit, GetItemProperties, OnCurrentChanged, Position, RemoveAt, ResumeBinding, SuspendBinding, e UpdateIsBinding.

O seguinte exemplo de código usa o BindingContext para retornar um BindingManagerBase para uma fonte de dados específico. (O exemplo pressupõe que você declarou myBindingManagerBase na seção de declarações do módulo.) O exemplo adiciona representantes de eventos para o CurrentChanged e PositionChanged eventos. Por fim, o exemplo contém quatro métodos (MoveNext, MovePrevious, MoveFirst, e MoveLast) que incrementar ou decrementar o Position propriedade e defina o Position para a primeira ou última linha na lista. A última linha na lista é determinada por meio de Count propriedade.

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: