Condividi tramite


Binding Classe

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.

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

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 DiagrammaDiagramma 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

Vedi anche