BindingExpression Classe

Referência

Definição

Namespace:: System.Windows.Data

Assembly:: PresentationFramework.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Contém informações sobre uma instância única de uma Binding.

public ref class BindingExpression sealed : System::Windows::Data::BindingExpressionBase, System::Windows::IWeakEventListener

public sealed class BindingExpression : System.Windows.Data.BindingExpressionBase, System.Windows.IWeakEventListener

type BindingExpression = class
    inherit BindingExpressionBase
    interface IWeakEventListener

Public NotInheritable Class BindingExpression
Inherits BindingExpressionBase
Implements IWeakEventListener

Herança: Object

Expression

BindingExpressionBase
BindingExpression

Implementações: IWeakEventListener

Comentários

A Binding classe é a classe de alto nível para a declaração de uma associação. A BindingExpression classe é o objeto subjacente que mantém a conexão entre a origem da associação e o destino de associação. Uma Binding contém todas as informações que podem ser compartilhadas entre vários BindingExpression objetos. Uma BindingExpression é uma expressão de instância que não pode ser compartilhada e que contém todas as informações da instância sobre o Binding.

Por exemplo, considere o seguinte, onde myDataObject está uma instância da MyData classe, myBinding é o objeto de origem Binding e MyData a classe é uma classe definida que contém uma propriedade de cadeia de caracteres chamada MyDataProperty. Este exemplo associa o conteúdo de texto de mytext, que é uma instância de TextBlock, a MyDataProperty.

// Make a new source.
MyData myDataObject = new MyData(DateTime.Now);      
Binding myBinding = new Binding("MyDataProperty");
myBinding.Source = myDataObject;
// Bind the new data source to the myText TextBlock control's Text dependency property.
myText.SetBinding(TextBlock.TextProperty, myBinding);

' Make a new source.
Dim data1 As New MyData(DateTime.Now)
Dim binding1 As New Binding("MyDataProperty")
binding1.Source = data1
' Bind the new data source to the myText TextBlock control's Text dependency property.
Me.myText.SetBinding(TextBlock.TextProperty, binding1)

Você pode usar o mesmo myBinding objeto para criar outras associações. Por exemplo, você pode usar o myBinding objeto para associar o conteúdo de texto de uma caixa de seleção a MyDataProperty. Nesse cenário, haverá duas instâncias que BindingExpression compartilham o myBinding objeto.

Você pode obter um BindingExpression objeto usando o GetBindingExpression método ou o GetBindingExpression método em um objeto associado a dados.

Propriedades

BindingGroup	Obtém o BindingGroup a que essa expressão de associação pertence. (Herdado de BindingExpressionBase)
DataItem	Obtém o objeto de origem da associação que essa BindingExpression usa.
HasError	Obtém um valor que indica se a associação pai tem uma regra de validação com falha. (Herdado de BindingExpressionBase)
HasValidationError	Obtém um valor que indica se a associação pai tem uma regra de validação com falha. (Herdado de BindingExpressionBase)
IsDirty	Obtém ou define um valor que indica se o destino da associação tem um valor que não foi gravado na origem. (Herdado de BindingExpressionBase)
ParentBinding	Retorna o objeto Binding do BindingExpression atual.
ParentBindingBase	Obtém o objeto BindingBase do qual este objeto BindingExpressionBase foi criado. (Herdado de BindingExpressionBase)
ResolvedSource	Obtém o objeto de origem da associação para este BindingExpression.
ResolvedSourcePropertyName	Obtém o nome da propriedade da origem da associação para este BindingExpression.
Status	Obtém o status da expressão de associação. (Herdado de BindingExpressionBase)
Target	Obtém o elemento que é o objeto de destino da associação dessa expressão de associação. (Herdado de BindingExpressionBase)
TargetProperty	Obtém a propriedade de destino da associação desta expressão de associação. (Herdado de BindingExpressionBase)
ValidationError	Obtém o ValidationError que fez essa instância de BindingExpressionBase ser inválida. (Herdado de BindingExpressionBase)
ValidationErrors	Obtém uma coleção de objetos ValidationError que fez essa instância de BindingExpressionBase ser inválida. (Herdado de BindingExpressionBase)

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)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
UpdateSource()	Envia o valor atual de destino de associação para a propriedade de fonte de associação em associações TwoWay ou OneWayToSource.
UpdateTarget()	Força uma transferência de dados da propriedade de origem de associação para a propriedade de destino de associação.
ValidateWithoutUpdate()	Executa quaisquer objetos ValidationRule no Binding associado que têm a propriedade ValidationStep definida como RawProposedValue ou ConvertedProposedValue. Este método não atualiza a origem. (Herdado de BindingExpressionBase)

Implantações explícitas de interface

IWeakEventListener.ReceiveWeakEvent(Type, Object, EventArgs)

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

Partilhar via