Compartilhar via


PriorityBinding Classe

Definição

Descreve uma coleção de objetos Binding que está conectada a uma propriedade única de destino da associação, que recebe seu valor da primeira associação da coleção que produz um valor com êxito.

public ref class PriorityBinding : System::Windows::Data::BindingBase, System::Windows::Markup::IAddChild
[System.Windows.Markup.ContentProperty("Bindings")]
public class PriorityBinding : System.Windows.Data.BindingBase, System.Windows.Markup.IAddChild
[<System.Windows.Markup.ContentProperty("Bindings")>]
type PriorityBinding = class
    inherit BindingBase
    interface IAddChild
Public Class PriorityBinding
Inherits BindingBase
Implements IAddChild
Herança
Atributos
Implementações

Comentários

PriorityBinding permite associar uma propriedade de destino de associação (destino) a uma lista de associações. A primeira associação que retorna um valor se torna a associação ativa com êxito.

Uma associação retornará um valor com êxito se:

  1. O caminho para a origem da associação é resolvido com êxito.

  2. O conversor de valor, se houver, é capaz de converter o valor resultante.

  3. O valor resultante é válido para a propriedade de destino.

O valor DependencyProperty.UnsetValue não é considerado um valor retornado bem-sucedido.

A prioridade das associações é determinada por sua ordem na lista. A associação que aparece primeiro na lista tem a prioridade mais alta.

O mecanismo de associação começa com a primeira associação na lista e verifica se essa associação retorna um valor com êxito; se isso acontecer, o valor dessa associação será usado. Se a primeira associação não retornar um valor com êxito, o mecanismo de associação examinará a segunda associação para determinar se ela retorna um valor com êxito; se isso acontecer, o valor da segunda associação se tornará o valor ativo. Esse processo de verificação continua até o final da lista de associações. Se nenhuma das associações retornar um valor com êxito, a associação usará o FallbackValue.

O mecanismo de associação continua a escutar alterações em todas as associações. Se em qualquer momento uma das associações que tem uma prioridade mais alta retornar um valor com êxito, o valor dessa associação se tornará o valor ativo e substituirá o valor atual.

Construtores

PriorityBinding()

Inicializa uma nova instância da classe PriorityBinding.

Propriedades

BindingGroupName

Obtém ou define o nome do BindingGroup ao qual esta associação pertence.

(Herdado de BindingBase)
Bindings

Obtém a coleção de objetos Binding estabelecida para essa instância de PriorityBinding.

Delay

Obtém ou define a quantidade de tempo, em milissegundos, de espera antes de atualizar a origem da associação após o valor das alterações de destino.

(Herdado de BindingBase)
FallbackValue

Obtém ou define o valor a ser usado quando a associação não é capaz de retornar um valor.

(Herdado de BindingBase)
StringFormat

Obtém ou define uma cadeia de caracteres que especifica como formatar a associação se ela exibir o valor associado como uma cadeia de caracteres.

(Herdado de BindingBase)
TargetNullValue

Obtém ou define o valor que é usado no destino quando o valor da fonte é null.

(Herdado de BindingBase)

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ProvideValue(IServiceProvider)

Retorna um objeto que deve ser definido na propriedade em que essa associação e extensão são aplicadas.

(Herdado de BindingBase)
ShouldSerializeBindings()

Retorna um valor que indica se o processo de serialização deve serializar o valor efetivo da propriedade Bindings em instâncias desta classe.

ShouldSerializeFallbackValue()

Retorna um valor que indica se o processo de serialização deve serializar o valor efetivo da propriedade FallbackValue em instâncias desta classe.

(Herdado de BindingBase)
ShouldSerializeTargetNullValue()

Retorna um valor que indica se a propriedade TargetNullValue deve ser serializada.

(Herdado de BindingBase)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Implantações explícitas de interface

IAddChild.AddChild(Object)

Esse membro dá suporte à infraestrutura de Windows Presentation Foundation (WPF) e não se destina a ser usado diretamente do seu código.

IAddChild.AddText(String)

Esse membro dá suporte à infraestrutura de Windows Presentation Foundation (WPF) e não se destina a ser usado diretamente do seu código.

Aplica-se a

Confira também