Estensione di markup {Binding}

L'estensione di markup {Binding} viene usata per associare dati alle proprietà dei controlli ai valori provenienti da un'origine dati, ad esempio il codice. L'estensione di markup {Binding} viene convertita in fase di caricamento XAML in un'istanza della classe Binding. Questo oggetto di associazione ottiene un valore da una proprietà in un'origine dati e lo inserisce nella proprietà nel controllo. L'oggetto di associazione può essere configurato facoltativamente per osservare le modifiche apportate al valore della proprietà dell'origine dati e aggiornarsi in base a tali modifiche. Può anche essere configurato facoltativamente per eseguire il push delle modifiche al valore del controllo nella proprietà di origine. La proprietà di destinazione di un'associazione dati deve essere una proprietà di dipendenza. Per altre informazioni, vedere Panoramica sulle proprietà di dipendenza.

{Binding} ha la stessa precedenza della proprietà di dipendenza di un valore locale e l'impostazione di un valore locale nel codice imperativo rimuove l'effetto di qualsiasi {Binding} impostato nel markup.

Utilizzo attributo XAML

<object property="{Binding}" .../>
-or-
<object property="{Binding propertyPath}" .../>
-or-
<object property="{Binding bindingProperties}" .../>
-or-
<object property="{Binding propertyPath, bindingProperties}" .../>

Percorso proprietà

Path descrive la proprietà a cui si sta eseguendo il binding (proprietà di origine). Path è un parametro posizionale, ovvero è possibile usare il nome del parametro in modo esplicito ({Binding Path=EmployeeID}) oppure specificarlo come primo parametro senza nome ({Binding EmployeeID}).

Il tipo di Path è un percorso di proprietà, ovvero una stringa che restituisce una proprietà o una sottoproprietà del tipo personalizzato o di un tipo di framework. Il tipo può essere, ma non deve essere un DependencyObject. I passaggi in un percorso di proprietà sono delimitati da punti (.) ed è possibile includere più delimitatori per attraversare le sottoproprietà successive. Usare il delimitatore punto indipendentemente dal linguaggio di programmazione usato per implementare l'oggetto a cui è associato.

Ad esempio, per associare l'interfaccia utente alla proprietà nome di un oggetto dipendente, il percorso della proprietà potrebbe essere "Employee.FirstName". Se si associa un controllo elementi a una proprietà che contiene dipendenti di un dipendente, il percorso della proprietà potrebbe essere "Employee.Dependents" e il modello di elemento del controllo elementi si occupa della visualizzazione degli elementi in "Dipendenti".

Se l'origine dati è una raccolta, un percorso di proprietà può specificare gli elementi nella raccolta in base alla posizione o all'indice. Ad esempio, "Teams[0].Players", dove il valore letterale "[]" racchiude "0" che specifica il primo elemento di una raccolta.

Quando si usa un'associazione ElementName a un DependencyObjectesistente, è possibile usare le proprietà associate come parte del percorso della proprietà. Per disambiguare una proprietà associata in modo che il punto intermedio nel nome della proprietà associata non venga considerato un passaggio in un percorso di proprietà, racchiudere tra parentesi il nome della proprietà associata qualificato dal proprietario; ad esempio, (AutomationProperties.Name).

Un oggetto intermedio percorso proprietà viene archiviato come un oggetto PropertyPath in una rappresentazione in fase di esecuzione, ma la maggior parte degli scenari non dovrà interagire con un oggetto PropertyPath nel codice. In genere è possibile specificare le informazioni di associazione necessarie usando XAML.

Per altre info sulla sintassi delle stringhe per un percorso di proprietà, i percorsi delle proprietà nelle aree delle funzionalità di animazione e la costruzione di un oggetto PropertyPath, vedere la sintassi Property-path.

Proprietà della classe Binding che può essere impostata con {Binding}

{Binding} viene illustrato con la sintassi segnaposto bindingProperties perché sono presenti più proprietà di lettura/scrittura di un Binding che è possibile impostare nell'estensione di markup. Le proprietà possono essere impostate in qualsiasi ordine con coppie di valori propName=delimitate da virgole. Alcune delle proprietà richiedono tipi che non dispongono di una conversione dei tipi, quindi richiedono estensioni di markup personalizzate annidate all'interno di {Binding}.

Nota Se si sta convertendo markup da {x:Bind} a {Binding}, tenere presente le differenze nei valori predefiniti per la proprietà Mode.

Converter, ConverterLanguage e ConverterLanguage sono tutti correlati allo scenario di conversione di un valore o di un tipo dall'origine di associazione in un tipo o valore compatibile con la proprietà di destinazione dell'associazione. Per altre info ed esempi, vedere la sezione "Conversioni dei dati" di Data binding in modo approfondito.

Source, RelativeSource e ElementName specificano un'origine di associazione, quindi si escludono a vicenda.

Suggerimento se è necessario specificare una singola parentesi graffa per un valore, ad esempio in Path o ConverterParameter, farlo precedere da una barra rovesciata: \{. In alternativa, racchiudere l'intera stringa contenente le parentesi graffe che richiedono l'escape in un set di virgolette secondarie, ad esempio ConverterParameter='{Mix}'.

Esempi

<!-- binding a UI element to a view model -->    
<Page ... >
    <Page.DataContext>
        <local:BookstoreViewModel/>
    </Page.DataContext>

    <GridView ItemsSource="{Binding BookSkus}" SelectedItem="{Binding SelectedBookSku, Mode=TwoWay}" ... />
</Page>

<!-- binding a UI element to another UI element -->
<Page ... >
    <Page.Resources>
        <local:S2Formatter x:Key="GradeConverter"/>
    </Page.Resources>

    <Slider x:Name="sliderValueConverter" ... />
    <TextBox Text="{Binding Path=Value, ElementName=sliderValueConverter,
        Mode=OneWay,
        Converter={StaticResource GradeConverter}}"/>
</Page>

Il secondo esempio imposta quattro proprietà di Binding diverse: ElementName, Path, Mode e Converter. In questo caso, Path viene visualizzato in modo esplicito denominato come proprietà pinding. The Path viene valutato in un'origine di data binding che è un altro oggetto nello stesso albero di oggetti di runtime, uno Slider denominato sliderValueConverter.

Si noti che il valore della proprietà Converter usa un'altra estensione di markup, estensione di markup {StaticResource}, quindi sono disponibili due utilizzi di estensione di markup annidati qui. Il valore interno viene valutato per primo, in modo che, una volta ottenuta la risorsa, sia presente un IValueConverter pratico (una classe personalizzata di cui è stata creata un'istanza dall'elemento local:S2Formatter nelle risorse) che l'associazione può usare.

Supporto per strumenti

Microsoft IntelliSense in Microsoft Visual Studio visualizza le proprietà del contesto dati durante la creazione di {Binding} nell'editor di markup XAML. Non appena si digita "{Binding", le proprietà del contesto dati appropriate per Path vengono visualizzate nell'elenco a discesa. IntelliSense consente anche di usare le altre proprietà di Binding. Per il corretto funzionamento, è necessario disporre del contesto dati o del contesto dati in fase di progettazione impostato nella pagina di markup. Andare alla definizione (F12) funziona anche con {Binding}. In alternativa, è possibile usare la finestra di dialogo data binding.