Convertitori di tipi ed estensioni di markup per XAML

Articolo
10/18/2023

I convertitori di tipi e le estensioni di markup sono due tecniche usate dai sistemi di tipi XAML e writer XAML per generare componenti dell'oggetto grafico. Anche se condividono alcune caratteristiche, i convertitori di tipi e le estensioni di markup sono rappresentati in modo diverso in un flusso del nodo XAML. In questo set di documentazione, i convertitori di tipi, le estensioni di markup e costrutti simili talvolta vengono detti collettivamente convertitori di valori.

Convertitori di valori

In XAML i convertitori di valori vengono usati per vari scenari. Nell'elenco seguente vengono indicati diversi tipi di convertitori di valori in XAML:

Convertitore di tipi
Estensione di markup
Serializzatore di valori
Classe correlata o classe di supporto che fornisce la logica per una sintassi del testo XAML

Convertitori di tipi

Nella definizione dei servizi XAML .NET i convertitori di tipi sono classi che derivano dalla classe CLR TypeConverter . TypeConverter è una classe presente in .NET prima dell'esistenza di XAML. Lo scopo originale era quello di supportare finestre delle proprietà e metafore di modifica simili basate su testo per le proprietà dell'IDE. L'introduzione di XAML a .NET usa TypeConverter per convertire una sintassi di testo (come disponibile in un valore di attributo o un nodo valore XAML) in un oggetto . TypeConverter può anche essere usato per serializzare un valore oggetto alla sintassi del testo. TypeConverter è stato usato anche nelle implementazioni XAML specifiche del framework precedenti in Windows Presentation Foundation (WPF) e Windows Communication Foundation (WCF). Per altre informazioni su TypeConverter in XAML, vedere Type Converters for XAML Overview.

Estensioni di markup

Nell'implementazione dei servizi XAML .NET le estensioni di markup sono classi che derivano dalla MarkupExtension classe . Le estensioni di markup sono un concetto che in questo formato è originato dal linguaggio XAML. È possibile considerare un'estensione di markup come una sequenza di escape estensibile che chiama una classe di servizio per fornirne la logica corrispondente. In termini di markup, i processori XAML riconoscono universalmente un'estensione di markup mediante una sequenza di testo che inizia con una parentesi graffa aperta ({) in una stringa di testo.

Le estensioni di markup sono diverse dai convertitori di tipi. I convertitori di tipi sono in genere associati a tipi o membri. Vengono richiamati quando una creazione dell'oggetto grafico o una serializzazione rileva una sintassi del testo associato a tali entità.

Le estensioni di markup sono associate a una singola classe di servizio di supporto, ma possono essere applicate per qualsiasi valore del membro. È tuttavia possibile implementare l'estensione di markup per limitare deliberatamente l'uso a determinati membri o tipi di destinazione, usando il contesto del servizio. Le estensioni di markup possono eseguire l'override di un'associazione del convertitore di tipi. oppure è possibile specificare un valore di attributo per i membri che altrimenti non supporterebbero una sintassi del testo.

Per altre informazioni sul modello di implementazione dell'estensione di markup per XAML, vedere Markup Extensions for XAML Overview.

Serializzatori di valori

Un oggetto ValueSerializer è un convertitore di tipi specializzato ottimizzato per la conversione di un oggetto in una stringa. È possibile che un oggetto ValueSerializer per XAML non implementi affatto il metodo ConvertFrom . Con un'implementazione di ValueSerializer si ottengono servizi in un modo simile a quello di un'implementazione di TypeConverter . I metodi virtuali forniscono un parametro di input context . Il parametro context è di tipo IValueSerializerContext, che eredita dall'interfaccia di IServiceProvider e dispone di un metodo GetService .

Nel sistema di tipi XAML e per le implementazioni del writer XAML che usano l'elaborazione del ciclo del nodo XAML per la serializzazione, un convertitore di valori associato a un tipo o a un membro viene segnalato dalla relativa proprietà XamlType.ValueSerializer . Il significato per i writer XAML che eseguono la serializzazione è che, in presenza di XamlType.TypeConverter e XamlType.ValueSerializer , il convertitore di tipi deve essere usato per il percorso di caricamento e il serializzatore di valori deve essere usato per il percorso di salvataggio. Se XamlType.TypeConverter esiste ma XamlType.ValueSerializer è null, il convertitore di tipi viene usato anche per il percorso di salvataggio.

Altri convertitori di valori

Un convertitore di valori è estensibile oltre i modelli specifici di un convertitore di tipi o un'estensione di markup. Tuttavia, questa personalizzazione richiederebbe anche la ridefinizione del sistema di tipi XAML, come fornito dai servizi XAML .NET. Il sistema di tipi XAML esistente dispone di rappresentazioni e sistemi di report per convertitori di tipi, estensioni di markup e serializzatori di valori, ma non per moduli personalizzati di conversione dei valori. Se si intendono creare convertitori di valori personalizzati, usare il tipo XamlValueConverter<TConverterBase> .

Convertitori di tipi ed estensioni di markup in combinazione

I convertitori di tipi e le estensioni di markup vengono usati per situazioni diverse in XAML. Anche se il contesto è disponibile per gli utilizzi di estensione di markup, il comportamento della conversione di tipi di proprietà in cui un'estensione di markup fornisce un valore in genere non è selezionato nelle implementazioni dell'estensione di markup. In altre parole, anche se un'estensione di markup restituisce una stringa di testo come output di ProvideValue , non viene richiamato il comportamento di conversione di tipi su quella stringa così come applicato a una proprietà specifica o a un tipo di valore della proprietà. Lo scopo di un'estensione di markup in genere è quello di elaborare una stringa e restituire un oggetto senza coinvolgere alcun convertitore di tipi.

Contesto del servizio per un convertitore di valori

Quando si implementa un convertitore di valori, è spesso necessario accedere a un contesto in cui viene applicato il convertitore di valori. Questo contesto è noto come contesto del servizio. Il contesto del servizio può includere informazioni come il contesto dello schema XAML attivo, l'accesso al sistema di mapping dei tipi fornito dal contesto dello schema XAML e dal writer di oggetti XAML e così via. Per altre informazioni sui contesti del servizio disponibili per un convertitore di valori e sulle modalità di accesso ai servizi eventualmente forniti da un contesto del servizio, vedere Service Contexts Available to Type Converters and Markup Extensions.