BindingExpression Classe

Definição

Contém informações sobre uma instância única de uma Binding.Contains information about a single instance of a 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

Comentários

A Binding classe é a classe de alto nível para a declaração de uma associação.The Binding class is the high-level class for the declaration of a binding. A BindingExpression classe é o objeto subjacente que mantém a conexão entre a origem da associação e o destino da associação.The BindingExpression class is the underlying object that maintains the connection between the binding source and the binding target. Um Binding contém todas as informações que podem ser compartilhadas BindingExpression entre vários objetos.A Binding contains all the information that can be shared across several BindingExpression objects. Um BindingExpression é uma expressão de instância que não pode ser compartilhada e que contém todas as informações de Bindinginstância sobre o.A BindingExpression is an instance expression that cannot be shared and that contains all the instance information about the Binding.

Por exemplo, considere o seguinte, em myDataObject que é uma instância MyData da classe, myBinding é o objeto Binding de origem e MyData a classe é uma classe definida que contém uma propriedade de MyDataPropertycadeia de caracteres denominada.For example, consider the following, where myDataObject is an instance of the MyData class, myBinding is the source Binding object, and MyData class is a defined class that contains a string property named MyDataProperty. Este exemplo associa o conteúdo de texto de mytext, que é uma instância do TextBlock, ao MyDataProperty.This example binds the text content of mytext, which is an instance of TextBlock, to 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.You can use the same myBinding object to create other bindings. Por exemplo, você pode usar o myBinding objeto para associar o conteúdo de texto de uma caixa de MyDataPropertyseleção a.For example, you might use the myBinding object to bind the text content of a check box to MyDataProperty. Nesse cenário, haverá duas instâncias do BindingExpression que compartilham o myBinding objeto.In that scenario, there will be two instances of BindingExpression that share the myBinding object.

Você pode obter um BindingExpression objeto usando o GetBindingExpression método ou o GetBindingExpression método em um objeto associado a dados.You can obtain a BindingExpression object by using the GetBindingExpression method or the GetBindingExpression method on a data-bound object.

Propriedades

BindingGroup

Obtém o BindingGroup a que essa expressão de associação pertence.Gets the BindingGroup that this binding expression belongs to.

(Herdado de BindingExpressionBase)
DataItem

Obtém o objeto de origem da associação que essa BindingExpression usa.Gets the binding source object that this BindingExpression uses.

HasError

Obtém um valor que indica se a associação pai tem uma regra de validação com falha.Gets a value that indicates whether the parent binding has a failed validation rule.

(Herdado de BindingExpressionBase)
HasValidationError

Obtém um valor que indica se a associação pai tem uma regra de validação com falha.Gets a value that indicates whether the parent binding has a failed validation rule.

(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.Gets or sets a value that indicates whether the target of the binding has a value that has not been written to the source.

(Herdado de BindingExpressionBase)
ParentBinding

Retorna o objeto Binding do BindingExpression atual.Returns the Binding object of the current BindingExpression.

ParentBindingBase

Obtém o objeto BindingBase do qual este objeto BindingExpressionBase foi criado.Gets the BindingBase object from which this BindingExpressionBase object is created.

(Herdado de BindingExpressionBase)
ResolvedSource

Obtém o objeto de origem da associação para este BindingExpression.Gets the binding source object for this BindingExpression.

ResolvedSourcePropertyName

Obtém o nome da propriedade da origem da associação para este BindingExpression.Gets the name of the binding source property for this BindingExpression.

Status

Obtém o status da expressão de associação.Gets the status of the binding expression.

(Herdado de BindingExpressionBase)
Target

Obtém o elemento que é o objeto de destino da associação dessa expressão de associação.Gets the element that is the binding target object of this binding expression.

(Herdado de BindingExpressionBase)
TargetProperty

Obtém a propriedade de destino da associação desta expressão de associação.Gets the binding target property of this binding expression.

(Herdado de BindingExpressionBase)
ValidationError

Obtém o ValidationError que fez essa instância de BindingExpressionBase ser inválida.Gets the ValidationError that caused this instance of BindingExpressionBase to be invalid.

(Herdado de BindingExpressionBase)
ValidationErrors

Obtém uma coleção de objetos ValidationError que fez essa instância de BindingExpressionBase ser inválida.Gets a collection of ValidationError objects that caused this instance of BindingExpressionBase to be invalid.

(Herdado de BindingExpressionBase)

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(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.Sends the current binding target value to the binding source property in TwoWay or OneWayToSource bindings.

UpdateTarget()

Força uma transferência de dados da propriedade de origem de associação para a propriedade de destino de associação.Forces a data transfer from the binding source property to the binding target property.

ValidateWithoutUpdate()

Executa quaisquer objetos ValidationRule no Binding associado que têm a propriedade ValidationStep definida como RawProposedValue ou ConvertedProposedValue.Runs any ValidationRule objects on the associated Binding that have the ValidationStep property set to RawProposedValue or ConvertedProposedValue. Este método não atualiza a origem.This method does not update the source.

(Herdado de BindingExpressionBase)

Implantações explícitas de interface

IWeakEventListener.ReceiveWeakEvent(Type, Object, EventArgs)

Este membro dá suporte à infraestrutura Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) e não se destina a ser usado diretamente do código.This member supports the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

Aplica-se a