Condividi tramite

Binding Classe

Definizione

Spazio dei nomi:
System.Windows.Data
Assembly:
PresentationFramework.dll

Fornisce accesso di alto livello alla definizione di un'associazione, che connette le proprietà degli oggetti di destinazione dell'associazione (in genere elementi WPF) e 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

Il data binding di Windows Presentation Foundation (WPF) consente alle applicazioni di presentare e interagire con i dati in modo semplice e coerente. 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 l'associazione e dalla natura dell'origine dati, ogni associazione segue il modello illustrato nella figura seguente.

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

  • Ogni associazione include in genere questi quattro componenti: un oggetto di destinazione di 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 DependencyObject i tipi possono definire le 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 all'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 di associazione può essere un UIElementoggetto , qualsiasi oggetto elenco, un oggetto CLR associato a ADO.NET dati o servizi Web o un xmlNode che contiene 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.

Utilizzo degli attributi XAML

<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

Nome Descrizione
Binding()

Inizializza una nuova istanza della classe Binding.
Binding(String)

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

Campi

Nome Descrizione
DoNothing

Utilizzato 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à dell'indicizzatore è stata modificata.
SourceUpdatedEvent

Identifica l'evento SourceUpdated associato.
TargetUpdatedEvent

Identifica l'evento TargetUpdated associato.
XmlNamespaceManagerProperty

Identifica la XmlNamespaceManager proprietà associata.

Proprietà

Nome Descrizione
AsyncState

Ottiene o imposta i dati opachi passati al dispatcher 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 l'oggetto Path relativo all'elemento di dati o all'oggetto DataSourceProvider .
Converter

Ottiene o imposta il convertitore da utilizzare.
ConverterCulture

Ottiene o imposta le impostazioni 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, espresso in millisecondi, di attesa prima di aggiornare l'origine dell'associazione dopo la modifica del valore nella destinazione.

(Ereditato da BindingBase)
ElementName

Ottiene o imposta il nome dell'elemento da utilizzare come oggetto di origine dell'associazione.
FallbackValue

Ottiene o imposta il valore da utilizzare quando l'associazione non è in grado di restituire un valore.

(Ereditato da BindingBase)
IsAsync

Ottiene o imposta un valore che indica se deve Binding ottenere e impostare i valori in modo asincrono.
Mode

Ottiene o imposta un valore che indica la direzione del flusso di dati nell'associazione.
NotifyOnSourceUpdated

Ottiene o imposta un valore che indica se generare l'evento SourceUpdated quando un valore viene trasferito dalla destinazione di associazione all'origine dell'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 dell'associazione.
NotifyOnValidationError

Ottiene o imposta un valore che indica se generare l'evento Error associato sull'oggetto associato.
Path

Ottiene o imposta il percorso della proprietà di origine dell'associazione.
RelativeSource

Ottiene o imposta l'origine dell'associazione specificandone la posizione rispetto alla posizione della destinazione dell'associazione.
Source

Ottiene o imposta l'oggetto da utilizzare come origine di associazione.
StringFormat

Ottiene o imposta una stringa che specifica come formattare l'associazione se visualizza il valore associato 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 fornire logica personalizzata per la gestione delle eccezioni rilevate dal motore di associazione durante l'aggiornamento del valore di origine dell'associazione. Questo è applicabile solo se è stato associato un oggetto all'associazione ExceptionValidationRule .
UpdateSourceTrigger

Ottiene o imposta un valore che determina la tempistica degli aggiornamenti dell'origine dell'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 dell'associazione XML da utilizzare.

Proprietà associate

Nome Descrizione
XmlNamespaceManager

Ottiene o imposta l'oggetto XmlNamespaceManager utilizzato per eseguire query che supportano XPath lo spazio dei nomi nelle associazioni XML.

Metodi

Nome Descrizione
AddSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)

Aggiunge un gestore per l'evento SourceUpdated associato.
AddTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)

Aggiunge un gestore per l'evento TargetUpdated associato.
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 il 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 del Objectcorrente.

(Ereditato da Object)
ProvideValue(IServiceProvider)

Restituisce un oggetto che deve essere impostato sulla proprietà in cui viene applicata l'associazione e l'estensione.

(Ereditato da BindingBase)
RemoveSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)

Rimuove un gestore per l'evento SourceUpdated associato.
RemoveTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)

Rimuove un gestore per l'evento TargetUpdated associato.
SetXmlNamespaceManager(DependencyObject, XmlNamespaceManager)

Imposta un oggetto gestore dello spazio dei nomi utilizzato dall'associazione associata all'elemento specificato.
ShouldSerializeFallbackValue()

Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore effettivo della FallbackValue proprietà nelle istanze di questa classe.

(Ereditato da BindingBase)
ShouldSerializePath()

Indica se la Path proprietà deve essere salvata in modo permanente.
ShouldSerializeSource()

Indica se la Source proprietà deve essere salvata in modo permanente.
ShouldSerializeTargetNullValue()

Restituisce un valore che indica se la TargetNullValue proprietà deve essere serializzata.

(Ereditato da BindingBase)
ShouldSerializeValidationRules()

Indica se la ValidationRules proprietà deve essere salvata in modo permanente.
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Eventi associati

Nome Descrizione
SourceUpdated

Si verifica quando un valore viene trasferito dalla destinazione di associazione all'origine dell'associazione, ma solo per le associazioni con il NotifyOnSourceUpdated valore impostato su true.
TargetUpdated

Si verifica quando un valore viene trasferito dall'origine di associazione alla destinazione di associazione, ma solo per le associazioni con il NotifyOnTargetUpdated valore impostato su true.

Si applica a

Vedi anche