PriorityBinding Classe

Definição

Namespace:

System.Windows.Data

Assembly:

PresentationFramework.dll

Descreve uma coleção de Binding objetos que é anexada a uma única propriedade de destino de associação, que recebe seu valor da primeira associação na 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

Object

MarkupExtension

BindingBase

PriorityBinding

Atributos

ContentPropertyAttribute

Implementações

IAddChild

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 fonte de 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 as alterações em todas as associações. Se em algum 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

Nome	Description
PriorityBinding()	Inicializa uma nova instância da classe PriorityBinding.

Propriedades

Nome	Description
BindingGroupName	Obtém ou define o nome do BindingGroup ao qual essa associação pertence. (Herdado de BindingBase)
Bindings	Obtém a coleção de Binding objetos que é estabelecida para esta instância de PriorityBinding.
Delay	Obtém ou define a quantidade de tempo, em milissegundos, para aguardar antes de atualizar a fonte de associação após o valor nas alterações de destino. (Herdado de BindingBase)
FallbackValue	Obtém ou define o valor a ser usado quando a associação não pode 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 usado no destino quando o valor da origem é null. (Herdado de BindingBase)

Métodos

Nome	Description
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função hash predefinida. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (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 os processos de serialização devem serializar o valor efetivo da Bindings propriedade em instâncias dessa classe.
ShouldSerializeFallbackValue()	Retorna um valor que indica se os processos de serialização devem serializar o valor efetivo da FallbackValue propriedade em instâncias dessa classe. (Herdado de BindingBase)
ShouldSerializeTargetNullValue()	Retorna um valor que indica se a TargetNullValue propriedade 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

Nome	Description
IAddChild.AddChild(Object)	Esse membro dá suporte à infraestrutura do WPF (Windows Presentation Foundation) e não se destina a ser usado diretamente do seu código.
IAddChild.AddText(String)	Esse membro dá suporte à infraestrutura do WPF (Windows Presentation Foundation) e não se destina a ser usado diretamente do seu código.

Confira também

• PriorityBindingExpression
• IValueConverter