BindingExpression Classe

Definição

Contém informação sobre uma única instância de um 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
Implementações

Observações

A Binding disciplina é a de nível superior para a declaração de uma ligação. A BindingExpression classe é o objeto subjacente que mantém a ligação entre a fonte de ligação e o destino de ligação. A Binding contém toda a informação que pode ser partilhada por vários BindingExpression objetos. A BindingExpression é uma expressão de instância que não pode ser partilhada e que contém toda a informação de instância sobre o Binding.

Por exemplo, considere o seguinte, onde myDataObject é uma instância da MyData classe, myBinding é o objeto fonte Binding , e MyData a classe é uma classe definida que contém uma propriedade de cadeia chamada MyDataProperty. Este exemplo vincula o conteúdo do 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)

Podes usar o mesmo myBinding objeto para criar outras ligações. Por exemplo, pode usar o myBinding objeto para atribuir o conteúdo de texto de uma caixa de seleção a MyDataProperty. Nesse cenário, haverá duas instâncias que BindingExpression partilham o myBinding objeto.

Pode obter um BindingExpression objeto usando o GetBindingExpression método ou o GetBindingExpression método num objeto ligado a dados.

Propriedades

Name Description
BindingGroup

Obtém-se o BindingGroup que esta expressão de ligação pertence.

(Herdado de BindingExpressionBase)
DataItem

Obtém o objeto fonte de ligação que isto BindingExpression utiliza.

HasError

Recebe um valor que indica se a ligação do pai tem uma regra de validação falhada.

(Herdado de BindingExpressionBase)
HasValidationError

Recebe um valor que indica se a ligação do pai tem uma regra de validação falhada.

(Herdado de BindingExpressionBase)
IsDirty

Recebe ou define um valor que indica se o destino da ligação tem um valor que não foi escrito na fonte.

(Herdado de BindingExpressionBase)
ParentBinding

Devolve o Binding objeto da corrente BindingExpression.

ParentBindingBase

Obtém o BindingBase objeto a partir do qual esse BindingExpressionBase objeto é criado.

(Herdado de BindingExpressionBase)
ResolvedSource

Obtém o objeto fonte de ligação para este BindingExpression.

ResolvedSourcePropertyName

Obtém o nome da propriedade fonte de ligação para esta BindingExpression.

Status

Obtém o estado da expressão de ligação.

(Herdado de BindingExpressionBase)
Target

Obtém o elemento que é o objeto alvo de ligação desta expressão de ligação.

(Herdado de BindingExpressionBase)
TargetProperty

Obtém a propriedade de alvo de ligação desta expressão de ligação.

(Herdado de BindingExpressionBase)
ValidationError

Faz com que o ValidationError que causou esta instância seja BindingExpressionBase inválida.

(Herdado de BindingExpressionBase)
ValidationErrors

Obtém uma coleção de ValidationError objetos que tornaram esta instância de BindingExpressionBase inválida.

(Herdado de BindingExpressionBase)

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)
UpdateSource()

Envia o valor alvo de ligação atual para a propriedade de ligação da fonte em TwoWay ou OneWayToSource bindings.

UpdateTarget()

Força uma transferência de dados da propriedade de origem de ligação para a propriedade de alvo de ligação.

ValidateWithoutUpdate()

Executa quaisquer ValidationRule objetos associados Binding que tenham ValidationStep a propriedade definida como RawProposedValue ou ConvertedProposedValue. Este método não atualiza a fonte.

(Herdado de BindingExpressionBase)

Implementações de Interface Explícita

Name Description
IWeakEventListener.ReceiveWeakEvent(Type, Object, EventArgs)

Este membro suporta a infraestrutura Windows Presentation Foundation (WPF) e não foi concebido para ser usado diretamente a partir do seu código.

Aplica-se a