Binding Classe

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Data

Assembly:: PresentationFramework.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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.

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à: Object

MarkupExtension

BindingBase
Binding

Commenti

L'associazione dei dati di Windows Presentation Foundation (WPF) offre alle applicazioni un modo semplice e coerente di presentare i dati e interagire con essi. Il data binding consente di sincronizzare i valori delle proprietà di due oggetti diversi.

Per stabilire un'associazione, usare la Binding classe o una delle altre classi che ereditano BindingBase. Indipendentemente dall'oggetto a cui si esegue il binding e dalla natura dell'origine dati, ogni associazione segue il modello illustrato nella figura seguente.

binding di base Diagramma Diagramma di data di data

La figura illustra i concetti fondamentali del data binding WPF seguenti.

Ogni associazione include in genere questi quattro componenti: un oggetto di destinazione dell'associazione, una proprietà di destinazione, un'origine di associazione e un Path al valore nell'origine di associazione da usare. Ad esempio, se si desidera 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 utilizzare è Name e l'oggetto di origine è l'oggetto Employee.
La proprietà di destinazione deve essere una proprietà di dipendenza. Ciò significa anche che non è possibile associare un campo. La maggior parte delle proprietà degli oggetti sono proprietà di dipendenza e la maggior parte delle proprietà di dipendenza, ad eccezione di quelle di UIElement sola lettura, supporta il data binding per impostazione predefinita. Solo i DependencyObject tipi possono definire proprietà di dipendenza e tutti gli UIElement oggetti derivano da DependencyObject.
Anche se non specificato nella figura, è necessario notare che l'oggetto origine dell'associazione non è limitato a essere un oggetto CLR personalizzato. Il data binding WPF supporta i dati sotto forma di oggetti CLR e XML. Per fornire alcuni esempi, l'origine dell'associazione può essere un UIElementoggetto , qualsiasi oggetto elenco, un oggetto CLR associato a ADO.NET dati o servizi Web o un xmlNode contenente i dati XML.

Utilizzare la Mode proprietà per specificare la direzione del flusso di dati. Per rilevare le modifiche all'origine in associazioni unidirezionale o bidirezionale, l'origine deve implementare un meccanismo di notifica delle modifiche delle proprietà appropriato, ad esempio INotifyPropertyChanged. Per un esempio, vedere Procedura: Implementare la notifica di modifica delle proprietà. La UpdateSourceTrigger proprietà specifica l'intervallo di aggiornamento dell'origine. Per altre informazioni, vedere "Concetti di base sul data binding" in Panoramica del data binding.

Uso della sintassi XAML per gli attributi

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

Valori XAML

dichiarazione
Zero o più clausole di assegnazione di attributi separate da virgole (,). Per altre informazioni, vedere Binding Markup Extension or Binding Declarations Overview.For more information, see Binding Markup Extension or Binding Declarations Overview.

Costruttori

Binding()	Inizializza una nuova istanza della classe Binding.
Binding(String)	Inizializza una nuova istanza della classe Binding con un percorso iniziale.

Campi

DoNothing	Usato come valore restituito per indicare al motore di associazione di non eseguire alcuna azione.
IndexerName	Utilizzato come PropertyName di PropertyChangedEventArgs per indicare che una proprietà di un indicizzatore è stata modificata.
SourceUpdatedEvent	Identifica l'evento associato SourceUpdated.
TargetUpdatedEvent	Identifica l'evento associato TargetUpdated.
XmlNamespaceManagerProperty	Identifica la proprietà associata XmlNamespaceManager.

Proprietà

AsyncState	Ottiene o imposta dati opachi passati al dispatcher di dati asincrono.
BindingGroupName	Ottiene o imposta il nome dell'oggetto BindingGroup a cui appartiene questa associazione. (Ereditato da BindingBase)
BindsDirectlyToSource	Ottiene o imposta un valore che indica se valutare la proprietà Path relativa all'elemento dati oppure l'oggetto DataSourceProvider.
Converter	Ottiene o imposta il convertitore da usare.
ConverterCulture	Ottiene o imposta l'impostazione cultura in cui valutare il convertitore.
ConverterParameter	Ottiene o imposta il parametro da passare all'oggetto Converter.
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. (Ereditato da BindingBase)
ElementName	Ottiene o imposta il nome dell'elemento da usare come oggetto di origine dell'associazione.
FallbackValue	Ottiene o imposta il valore da usare quando l'associazione non è in grado di restituire un valore. (Ereditato da BindingBase)
IsAsync	Ottiene o imposta un valore che indica se l'oggetto Binding deve ottenere e impostare i valori in modo asincrono.
Mode	Ottiene o imposta un valore che indica la direzione del flusso di dati del binding.
NotifyOnSourceUpdated	Ottiene o imposta un valore che indica se generare l'evento SourceUpdated quando un valore viene trasferito dalla destinazione del binding all'origine di associazione.
NotifyOnTargetUpdated	Ottiene o imposta un valore che indica se generare l'evento TargetUpdated quando un valore viene trasferito dall'origine di associazione alla destinazione del binding.
NotifyOnValidationError	Ottiene o imposta un valore che indica se generare l'evento associato Error sull'oggetto associato.
Path	Ottiene o imposta il percorso della proprietà di origine di associazione.
RelativeSource	Ottiene o imposta l'origine di associazione specificandone il percorso in relazione alla posizione della destinazione del binding.
Source	Ottiene o imposta l'oggetto da usare come origine di associazione.
StringFormat	Ottiene o imposta una stringa che specifica come formattare l'associazione se il valore associato viene visualizzato come stringa. (Ereditato da BindingBase)
TargetNullValue	Ottiene o imposta il valore utilizzato nella destinazione quando il valore dell'origine è `null`. (Ereditato da BindingBase)
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. Questa proprietà è applicabile solo se è stato associato un oggetto ExceptionValidationRule all'associazione.
UpdateSourceTrigger	Ottiene o imposta un valore che determina gli intervalli di tempo degli aggiornamenti dell'origine di associazione.
ValidatesOnDataErrors	Ottiene o imposta un valore che indica se includere DataErrorValidationRule.
ValidatesOnExceptions	Ottiene o imposta un valore che indica se includere ExceptionValidationRule.
ValidatesOnNotifyDataErrors	Ottiene o imposta un valore che indica se includere NotifyDataErrorValidationRule.
ValidationRules	Ottiene una raccolta di regole che controllano la validità dell'input dell'utente.
XPath	Ottiene o imposta una `XPath` query che restituisce il valore nell'origine di associazione XML da utilizzare.

Proprietà associate

XmlNamespaceManager

Ottiene o imposta l'oggetto XmlNamespaceManager usato per eseguire query XPath con supporto degli spazi dei nomi nelle associazioni XML.

Metodi

AddSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Aggiunge un gestore per l'evento associato SourceUpdated.
AddTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Aggiunge un gestore per l'evento associato TargetUpdated.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
GetXmlNamespaceManager(DependencyObject)	Restituisce un oggetto gestore dello spazio dei nomi XML utilizzato dall'associazione associata all'oggetto specificato.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ProvideValue(IServiceProvider)	Restituisce un oggetto che deve essere impostato sulla proprietà in cui vengono applicate l'associazione e l'estensione. (Ereditato da BindingBase)
RemoveSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Rimuove un gestore per l'evento associato SourceUpdated.
RemoveTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Rimuove un gestore per l'evento associato TargetUpdated.
SetXmlNamespaceManager(DependencyObject, XmlNamespaceManager)	Imposta un oggetto gestore dello spazio dei nomi usato dal binding associato all'elemento fornito.
ShouldSerializeFallbackValue()	Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore effettivo della proprietà FallbackValue su istanze di questa classe. (Ereditato da BindingBase)
ShouldSerializePath()	Indica se la proprietà Path deve essere mantenuta.
ShouldSerializeSource()	Indica se la proprietà Source deve essere mantenuta.
ShouldSerializeTargetNullValue()	Restituisce un valore che indica se la proprietà TargetNullValue deve essere serializzata. (Ereditato da BindingBase)
ShouldSerializeValidationRules()	Indica se la proprietà ValidationRules deve essere mantenuta.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Eventi associati

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`.
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`.

Si applica a

Condividi tramite