Binding Binding Binding Binding Class

Definizione

Offre un accesso di alto livello alla definizione di un'associazione, che connette le proprietà di oggetti di destinazione del binding (in genere, elementi WPF) e a qualsiasi origine dati, ad esempio un database, un file XML o qualsiasi oggetto che contiene dati.Provides high-level access to the definition of a binding, which connects the properties of binding target objects (typically, WPF elements), and any data source (for example, a database, an XML file, or any object that contains data).

public ref class Binding : System::Windows::Data::BindingBase
public class Binding : System.Windows.Data.BindingBase
type Binding = class
    inherit BindingBase
Public Class Binding
Inherits BindingBase
Ereditarietà

Commenti

Il data binding di Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) rappresenta per le applicazioni un modo semplice e coerente di presentare i dati e interagire con essi.Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) data binding provides a simple and consistent way for applications to present and interact with data. Il data binding consente di sincronizzare i valori delle proprietà di due oggetti diversi.Data binding enables you to synchronize the values of the properties of two different objects.

Per stabilire un'associazione, utilizzare la Binding classe o una delle altre classi che ereditano BindingBase.To establish a binding, use the Binding class or one of the other classes that inherit BindingBase. Indipendentemente dall'oggetto che si sta associando e dalla natura dell'origine dati, ogni binding segue il modello illustrato nella figura seguente.Regardless of what object you are binding and the nature of your data source, each binding follows the model illustrated by the following figure.

![Diagramma data binding di base] (~/add/media/databindingmostbasic.png "Diagramma data binding di base")Basic data binding diagram

Nella figura vengono illustrati i WPFWPF concetti fondamentali data binding seguenti.The figure demonstrates the following fundamental WPFWPF data binding concepts.

  • Ogni Binding dispone in genere di questi quattro componenti: un oggetto di destinazione del binding, una proprietà di destinazione, un' Path origine di associazione e un al valore nell'origine di associazione da usare.Each binding typically has these four components: a binding target object, a target property, a binding source, and a Path to the value in the binding source to use. Se ad esempio si vuole associare il contenuto di un TextBox oggetto alla proprietà Name di un oggetto Employee, l'oggetto di destinazione TextBoxè, la proprietà di destinazione è la Text proprietà, il valore da usare è Name e l'oggetto di origine è il dipendente oggetto.For example, if you want to bind the content of a TextBox to the Name property of an Employee object, your target object is the TextBox, the target property is the Text property, the value to use is Name, and the source object is the Employee object.

  • La proprietà di destinazione deve essere una proprietà di dipendenza.The target property must be a dependency property. Ciò significa anche che non è possibile associare un campo.This also means that you cannot bind a field. La maggior parte UIElement delle proprietà degli oggetti sono proprietà di dipendenza e la maggior parte delle proprietà di dipendenza, tranne quelle di sola lettura, supportano data binding per impostazione predefinita.Most properties of UIElement objects are dependency properties and most dependency properties, except read-only ones, support data binding by default. Solo DependencyObject i tipi possono definire le proprietà di dipendenza UIElement e tutti gli oggetti DependencyObjectderivano da.(Only DependencyObject types can define dependency properties and all UIElement objects derive from DependencyObject.)

  • Sebbene non sia specificato nella figura, è importante notare che l'oggetto di origine del binding non è necessariamente costituito da un oggetto CLRCLR personalizzato.Although not specified in the figure, it should be noted that the binding source object is not restricted to being a custom CLRCLR object. Il data binding WPFWPF supporta dati nel formato di oggetti CLRCLR e XMLXML.WPFWPF data binding supports data in the form of CLRCLR objects and XMLXML. Per fornire alcuni esempi, l'origine del binding può essere UIElementun, qualsiasi oggetto elenco, CLRCLR un oggetto associato a ADO.NETADO.NET dati o servizi Web o un XmlNode che contiene i XMLXML dati.To provide some examples, your binding source may be a UIElement, any list object, a CLRCLR object that is associated with ADO.NETADO.NET data or Web Services, or an XmlNode that contains your XMLXML data.

Utilizzare la Mode proprietà per specificare la direzione del flusso di dati.Use the Mode property to specify the direction of the data flow. Per rilevare le modifiche di origine nelle associazioni unidirezionali o bidirezionali, l'origine deve implementare un meccanismo di notifica delle modifiche di proprietà appropriato INotifyPropertyChanged, ad esempio.To detect source changes in one-way or two-way bindings, the source must implement a suitable property change notification mechanism such as INotifyPropertyChanged. Per un esempio, vedere Procedura: Implementare la notificadi modifica della proprietà.For an example, see How to: Implement Property Change Notification. La UpdateSourceTrigger proprietà specifica la tempistica degli aggiornamenti dell'origine.The UpdateSourceTrigger property specifies the timing of source updates. Per ulteriori informazioni, vedere "concetti di base sul data binding" in Cenni preliminari sul data binding.For more information, see "Basic Data Binding Concepts" in Data Binding Overview.

Uso della sintassi XAML per gli attributiXAML Attribute Usage

<object property="{Binding  declaration}"/>  

Valori XAMLXAML Values

declarationdeclaration
Zero o più clausole di assegnazione di attributi separate da virgole (,).Zero or more attribute-assignment clauses separated by commas (,). Per altre informazioni, vedere Binding Markup Extension o Binding Declarations Overview.For more information, see Binding Markup Extension or Binding Declarations Overview.

Costruttori

Binding() Binding() Binding() Binding()

Inizializza una nuova istanza della classe Binding.Initializes a new instance of the Binding class.

Binding(String) Binding(String) Binding(String) Binding(String)

Inizializza una nuova istanza della classe Binding con un percorso iniziale.Initializes a new instance of the Binding class with an initial path.

Campi

DoNothing DoNothing DoNothing DoNothing

Usato come valore restituito per indicare al motore di associazione di non eseguire alcuna azione.Used as a returned value to instruct the binding engine not to perform any action.

IndexerName IndexerName IndexerName IndexerName

Utilizzato come PropertyName di PropertyChangedEventArgs per indicare che una proprietà di un indicizzatore è stata modificata.Used as the PropertyName of PropertyChangedEventArgs to indicate that an indexer property has changed.

SourceUpdatedEvent SourceUpdatedEvent SourceUpdatedEvent SourceUpdatedEvent

Identifica l'evento associato SourceUpdated.Identifies the SourceUpdated attached event.

TargetUpdatedEvent TargetUpdatedEvent TargetUpdatedEvent TargetUpdatedEvent

Identifica l'evento associato TargetUpdated.Identifies the TargetUpdated attached event.

XmlNamespaceManagerProperty XmlNamespaceManagerProperty XmlNamespaceManagerProperty XmlNamespaceManagerProperty

Identifica la proprietà associata XmlNamespaceManager.Identifies the XmlNamespaceManager attached property.

Proprietà

AsyncState AsyncState AsyncState AsyncState

Ottiene o imposta dati opachi passati al dispatcher di dati asincrono.Gets or sets opaque data passed to the asynchronous data dispatcher.

BindingGroupName BindingGroupName BindingGroupName BindingGroupName

Ottiene o imposta il nome dell'oggetto BindingGroup a cui appartiene questa associazione.Gets or sets the name of the BindingGroup to which this binding belongs.

(Inherited from BindingBase)
BindsDirectlyToSource BindsDirectlyToSource BindsDirectlyToSource BindsDirectlyToSource

Ottiene o imposta un valore che indica se valutare la proprietà Path relativa all'elemento dati oppure l'oggetto DataSourceProvider.Gets or sets a value that indicates whether to evaluate the Path relative to the data item or the DataSourceProvider object.

Converter Converter Converter Converter

Ottiene o imposta il convertitore da usare.Gets or sets the converter to use.

ConverterCulture ConverterCulture ConverterCulture ConverterCulture

Ottiene o imposta l'impostazione cultura in cui valutare il convertitore.Gets or sets the culture in which to evaluate the converter.

ConverterParameter ConverterParameter ConverterParameter ConverterParameter

Ottiene o imposta il parametro da passare all'oggetto Converter.Gets or sets the parameter to pass to the Converter.

Delay Delay Delay Delay

Ottiene o imposta l'intervallo di tempo, in millisecondi, per l'attesa prima di aggiornare l'origine di associazione dopo la modifica del valore della destinazione.Gets or sets the amount of time, in milliseconds, to wait before updating the binding source after the value on the target changes.

(Inherited from BindingBase)
ElementName ElementName ElementName ElementName

Ottiene o imposta il nome dell'elemento da usare come oggetto di origine dell'associazione.Gets or sets the name of the element to use as the binding source object.

FallbackValue FallbackValue FallbackValue FallbackValue

Ottiene o imposta il valore da usare quando l'associazione non è in grado di restituire un valore.Gets or sets the value to use when the binding is unable to return a value.

(Inherited from BindingBase)
IsAsync IsAsync IsAsync IsAsync

Ottiene o imposta un valore che indica se l'oggetto Binding deve ottenere e impostare i valori in modo asincrono.Gets or sets a value that indicates whether the Binding should get and set values asynchronously.

Mode Mode Mode Mode

Ottiene o imposta un valore che indica la direzione del flusso di dati del binding.Gets or sets a value that indicates the direction of the data flow in the binding.

NotifyOnSourceUpdated NotifyOnSourceUpdated NotifyOnSourceUpdated NotifyOnSourceUpdated

Ottiene o imposta un valore che indica se generare l'evento SourceUpdated quando un valore viene trasferito dalla destinazione del binding all'origine dell'associazione.Gets or sets a value that indicates whether to raise the SourceUpdated event when a value is transferred from the binding target to the binding source.

NotifyOnTargetUpdated NotifyOnTargetUpdated NotifyOnTargetUpdated NotifyOnTargetUpdated

Ottiene o imposta un valore che indica se generare l'evento TargetUpdated quando un valore viene trasferito dall'origine dell'associazione alla destinazione del binding.Gets or sets a value that indicates whether to raise the TargetUpdated event when a value is transferred from the binding source to the binding target.

NotifyOnValidationError NotifyOnValidationError NotifyOnValidationError NotifyOnValidationError

Ottiene o imposta un valore che indica se generare l'evento associato Error sull'oggetto associato.Gets or sets a value that indicates whether to raise the Error attached event on the bound object.

Path Path Path Path

Ottiene o imposta il percorso della proprietà di origine di associazione.Gets or sets the path to the binding source property.

RelativeSource RelativeSource RelativeSource RelativeSource

Ottiene o imposta l'origine di associazione specificandone il percorso in relazione alla posizione della destinazione del binding.Gets or sets the binding source by specifying its location relative to the position of the binding target.

Source Source Source Source

Ottiene o imposta l'oggetto da usare come origine di associazione.Gets or sets the object to use as the binding source.

StringFormat StringFormat StringFormat StringFormat

Ottiene o imposta una stringa che specifica come formattare l'associazione se il valore associato viene visualizzato come stringa.Gets or sets a string that specifies how to format the binding if it displays the bound value as a string.

(Inherited from BindingBase)
TargetNullValue TargetNullValue TargetNullValue TargetNullValue

Ottiene o imposta il valore utilizzato nella destinazione quando il valore dell'origine è null.Gets or sets the value that is used in the target when the value of the source is null.

(Inherited from BindingBase)
UpdateSourceExceptionFilter UpdateSourceExceptionFilter UpdateSourceExceptionFilter UpdateSourceExceptionFilter

Ottiene o imposta un gestore che è possibile usare per rendere disponibile logica personalizzata per la gestione delle eccezioni rilevate dal motore di associazione durante l'aggiornamento del valore di origine di associazione.Gets or sets a handler you can use to provide custom logic for handling exceptions that the binding engine encounters during the update of the binding source value. Questa proprietà è applicabile solo se è stato associato un oggetto ExceptionValidationRule all'associazione.This is only applicable if you have associated an ExceptionValidationRule with your binding.

UpdateSourceTrigger UpdateSourceTrigger UpdateSourceTrigger UpdateSourceTrigger

Ottiene o imposta un valore che determina gli intervalli di tempo degli aggiornamenti dell'origine di associazione.Gets or sets a value that determines the timing of binding source updates.

ValidatesOnDataErrors ValidatesOnDataErrors ValidatesOnDataErrors ValidatesOnDataErrors

Ottiene o imposta un valore che indica se includere DataErrorValidationRule.Gets or sets a value that indicates whether to include the DataErrorValidationRule.

ValidatesOnExceptions ValidatesOnExceptions ValidatesOnExceptions ValidatesOnExceptions

Ottiene o imposta un valore che indica se includere ExceptionValidationRule.Gets or sets a value that indicates whether to include the ExceptionValidationRule.

ValidatesOnNotifyDataErrors ValidatesOnNotifyDataErrors ValidatesOnNotifyDataErrors ValidatesOnNotifyDataErrors

Ottiene o imposta un valore che indica se includere NotifyDataErrorValidationRule.Gets or sets a value that indicates whether to include the NotifyDataErrorValidationRule.

ValidationRules ValidationRules ValidationRules ValidationRules

Ottiene una raccolta di regole che controllano la validità dell'input dell'utente.Gets a collection of rules that check the validity of the user input.

XPath XPath XPath XPath

Ottiene o imposta una query XPath che restituisce il valore nell'origine di associazione XMLXML da usare.Gets or sets an XPath query that returns the value on the XMLXML binding source to use.

Proprietà associate

XmlNamespaceManager XmlNamespaceManager XmlNamespaceManager XmlNamespaceManager

Ottiene o imposta l'oggetto XmlNamespaceManager usato per eseguire query XPath con supporto degli spazi dei nomi nelle associazioni XML.Gets or sets the XmlNamespaceManager used to perform namespace-aware XPath queries in XML bindings.

Metodi

AddSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) AddSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) AddSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) AddSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)

Aggiunge un gestore per l'evento associato SourceUpdated.Adds a handler for the SourceUpdated attached event.

AddTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) AddTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) AddTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) AddTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)

Aggiunge un gestore per l'evento associato TargetUpdated.Adds a handler for the TargetUpdated attached event.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
GetXmlNamespaceManager(DependencyObject) GetXmlNamespaceManager(DependencyObject) GetXmlNamespaceManager(DependencyObject) GetXmlNamespaceManager(DependencyObject)

Restituisce un oggetto gestore dello spazio dei nomi XMLXML usato dall'associazione allegata all'oggetto specificato.Returns an XMLXML namespace manager object used by the binding attached to the specified object.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
ProvideValue(IServiceProvider) ProvideValue(IServiceProvider) ProvideValue(IServiceProvider) ProvideValue(IServiceProvider)

Restituisce un oggetto che deve essere impostato sulla proprietà in cui vengono applicate l'associazione e l'estensione.Returns an object that should be set on the property where this binding and extension are applied.

(Inherited from BindingBase)
RemoveSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) RemoveSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) RemoveSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) RemoveSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)

Rimuove un gestore per l'evento associato SourceUpdated.Removes a handler for the SourceUpdated attached event.

RemoveTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) RemoveTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) RemoveTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>) RemoveTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)

Rimuove un gestore per l'evento associato TargetUpdated.Removes a handler for the TargetUpdated attached event.

SetXmlNamespaceManager(DependencyObject, XmlNamespaceManager) SetXmlNamespaceManager(DependencyObject, XmlNamespaceManager) SetXmlNamespaceManager(DependencyObject, XmlNamespaceManager) SetXmlNamespaceManager(DependencyObject, XmlNamespaceManager)

Imposta un oggetto gestore dello spazio dei nomi usato dal binding associato all'elemento fornito.Sets a namespace manager object used by the binding attached to the provided element.

ShouldSerializeFallbackValue() ShouldSerializeFallbackValue() ShouldSerializeFallbackValue() ShouldSerializeFallbackValue()

Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore effettivo della proprietà FallbackValue su istanze di questa classe.Returns a value that indicates whether serialization processes should serialize the effective value of the FallbackValue property on instances of this class.

(Inherited from BindingBase)
ShouldSerializePath() ShouldSerializePath() ShouldSerializePath() ShouldSerializePath()

Indica se la proprietà Path deve essere mantenuta.Indicates whether the Path property should be persisted.

ShouldSerializeSource() ShouldSerializeSource() ShouldSerializeSource() ShouldSerializeSource()

Indica se la proprietà Source deve essere mantenuta.Indicates whether the Source property should be persisted.

ShouldSerializeTargetNullValue() ShouldSerializeTargetNullValue() ShouldSerializeTargetNullValue() ShouldSerializeTargetNullValue()

Restituisce un valore che indica se la proprietà TargetNullValue deve essere serializzata.Returns a value that indicates whether the TargetNullValue property should be serialized.

(Inherited from BindingBase)
ShouldSerializeValidationRules() ShouldSerializeValidationRules() ShouldSerializeValidationRules() ShouldSerializeValidationRules()

Indica se la proprietà ValidationRules deve essere mantenuta.Indicates whether the ValidationRules property should be persisted.

ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Eventi associati

SourceUpdated SourceUpdated SourceUpdated SourceUpdated

Si verifica quando un valore viene trasferito dalla destinazione del binding all'origine del binding, ma solo per i binding con il valore NotifyOnSourceUpdated impostato su true.Occurs when a value is transferred from the binding target to the binding source, but only for bindings with the NotifyOnSourceUpdated value set to true.

TargetUpdated TargetUpdated TargetUpdated TargetUpdated

Si verifica quando un valore viene trasferito dall'origine del binding alla destinazione del binding, ma solo per i binding con il valore NotifyOnTargetUpdated impostato su true.Occurs when a value is transferred from the binding source to the binding target, but only for bindings with the NotifyOnTargetUpdated value set to true.

Si applica a

Vedi anche