Estensione del markup ComponentResourceKey
Definisce e fa riferimento alle chiavi per le risorse caricate da assembly esterni. Ciò consente a una ricerca di risorse di specificare un tipo di destinazione in un assembly, anziché un dizionario risorse esplicito in un assembly o in una classe.
<object x:Key="{ComponentResourceKey {x:Type targetTypeName}, targetID}" ... />
<object x:Key="{ComponentResourceKey TypeInTargetAssembly={x:Type targetTypeName}, ResourceID=targetID}" ... />
<object property="{DynamicResource {ComponentResourceKey {x:Type targetTypeName}, targetID}}" ... />
<object property="{DynamicResource {ComponentResourceKey TypeInTargetAssembly={x:Type targetTypeName}, ResourceID=targetID}}" ... />
Valore | Descrizione |
---|---|
targetTypeName |
Nome del tipo CLR (Public Common Language Runtime) definito nell'assembly di risorse. |
targetID |
Chiave per la risorsa. Quando vengono cercate le risorse, targetID sarà analogo alla direttiva x:Key della risorsa. |
Come illustrato negli utilizzi precedenti, l'utilizzo di un'estensione di markup {ComponentResourceKey
} si trova in due posizioni:
Definizione di una chiave all'interno di un dizionario risorse del tema, come fornito da un autore del controllo.
Accesso a una risorsa del tema dall'assembly, quando si esegue la ri-mplazione del controllo, ma si vogliono usare i valori delle proprietà provenienti dalle risorse fornite dai temi del controllo.
Per fare riferimento alle risorse dei componenti provenienti dai temi, è in genere consigliabile usare {DynamicResource}
anziché {StaticResource}
. Questo è illustrato negli utilizzi. {DynamicResource}
è consigliato perché il tema stesso può essere modificato dall'utente. Se si vuole che la risorsa componente che corrisponda maggiormente alla finalità dell'autore del controllo per supportare un tema, è necessario abilitare anche il riferimento alla risorsa componente come dinamico.
TypeInTargetAssembly Identifica un tipo presente nell'assembly di destinazione in cui viene effettivamente definita la risorsa. Un ComponentResourceKey
oggetto può essere definito e usato indipendentemente dal sapere esattamente dove TypeInTargetAssembly è definito , ma alla fine deve risolvere il tipo tramite assembly a cui si fa riferimento.
Un utilizzo comune per ComponentResourceKey è definire le chiavi che vengono quindi esposte come membri di una classe. Per questo utilizzo, si usa il costruttore della ComponentResourceKey classe, non l'estensione di markup. Per altre informazioni, vedere ComponentResourceKeyo la sezione "Definizione e riferimento delle chiavi per le risorse del tema" dell'argomento Cenni preliminari sulla creazione di controlli.
Sia per stabilire chiavi che per fare riferimento a risorse con chiave, la sintassi degli attributi viene comunemente usata per l'estensione di ComponentResourceKey
markup.
La sintassi compatta illustrata si basa sull'utilizzo della ComponentResourceKey firma del costruttore e del parametro posizionale di un'estensione di markup. L'ordine targetTypeName
in cui vengono specificati e targetID
è importante. La sintassi dettagliata si basa sul ComponentResourceKey costruttore senza parametri e quindi imposta TypeInTargetAssembly e ResourceId in modo analogo a una sintassi di attributo reale su un elemento oggetto. Nella sintassi dettagliata l'ordine in cui vengono impostate le proprietà non è importante. La relazione e i meccanismi di queste due alternative (compatta e dettagliata) sono descritti in modo più dettagliato nell'argomento Estensioni di markup e XAML WPF.
Tecnicamente, il valore per targetID
può essere qualsiasi oggetto, non deve essere una stringa. Tuttavia, l'utilizzo più comune in WPF consiste nell'allineare il targetID
valore ai moduli che sono stringhe e in cui tali stringhe sono valide nella grammatica XamlName.
ComponentResourceKey
può essere usato nella sintassi degli elementi oggetto. In questo caso, è necessario specificare il valore delle TypeInTargetAssembly proprietà e ResourceId per inizializzare correttamente l'estensione.
Nell'implementazione del lettore XAML WPF la gestione per questa estensione di markup è definita dalla ComponentResourceKey classe .
ComponentResourceKey
è un'estensione di markup. Le estensioni di markup in genere vengono implementate quando per i valori dell'attributo devono essere utilizzati caratteri escape in modo che non vengano considerati come valori letterali o nomi di gestori e il requisito è più globale del semplice utilizzo di convertitori dei tipi su alcuni tipi o proprietà. Tutte le estensioni di markup in XAML usano i caratteri { e } nella sintassi degli attributi, ovvero la convenzione in base alla quale un processore XAML riconosce che un'estensione di markup deve elaborare l'attributo. Per altre informazioni, vedere Estensioni di markup e XAML WPF.
Feedback su .NET Desktop feedback
.NET Desktop feedback è un progetto di open source. Selezionare un collegamento per fornire feedback: