CustomXamlResourceLoader Classe

Définition

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CustomXamlResourceLoader

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class CustomXamlResourceLoader

Public Class CustomXamlResourceLoader

Héritage

Object IInspectable CustomXamlResourceLoader

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Remarques

CustomXamlResourceLoader prend en charge une utilisation de l’extension {CustomResource}de balisage. Cette extension de balisage est unique pour l’infrastructure XAML Windows Runtime (elle n’existe pas dans les technologies XAML précurseurs telles que Windows Presentation Foundation (WPF) et Microsoft Silverlight.)

Une {CustomResource} utilisation ne fonctionne pas par défaut (l’implémentation de base de GetResource est incomplète). Pour effectuer une référence valide {CustomResource} , vous devez effectuer chacune des étapes suivantes :

1. Dérivez une classe personnalisée de CustomXamlResourceLoader et remplacez la méthode GetResource . N’appelez pas la base dans l’implémentation.
2. Définissez CustomXamlResourceLoader.Current pour référencer votre classe dans la logique d’initialisation. Cela doit se produire avant que n’importe quel CODE XAML au niveau de la page qui inclut l’utilisation de l’extension {CustomResource} soit chargé. L’un des emplacements où définir CustomXamlResourceLoader.Current se trouve dans le constructeur de sous-classe Application qui est généré pour vous dans les modèles code-behind App.xaml.
3. Vous pouvez maintenant utiliser des {CustomResource} extensions dans le code XAML que votre application charge en tant que pages ou à partir de dictionnaires de ressources XAML.

L’extension de balisage {CustomResource} peut être utilisée à partir de XAML de la même façon que l’extension de balisage {StaticResource}, qui effectue une recherche de ressources intégrée à partir de différents emplacements ResourceDictionary . La différence est que l’application elle-même implémente la logique de recherche de ressources pour une utilisation de l’extension de balisage {CustomResource} en fournissant un chargeur de ressources personnalisé. Pour implémenter le chargeur de ressources personnalisé, l’application doit fournir une classe qui dérive de CustomXamlResourceLoader et remplacer la méthode GetResource . L’application doit inscrire son chargeur de ressources personnalisé en définissant la propriété statique CustomXamlResourceLoader.Current sur une instance de sa classe de chargeur de ressources personnalisée. Cette inscription doit être effectuée sur un thread d’interface utilisateur XAML avant toute analyse du code XAML qui utilise l’extension de balisage {CustomResource}. Si l’application utilise plusieurs threads d’interface utilisateur, une inscription distincte doit être effectuée sur chacune d’elles.

La façon dont CustomXamlResourceLoader stocke ses ressources n’est probablement pas liée à ResourceDictionary du tout. En règle générale, en plus des remplacements requis, votre classe CustomXamlResourceLoader fournit des méthodes internes ou publiques qui permettent de stocker, de clér et d’utiliser les éléments de ressource dans une collection sous-jacente.

Voir aussi

• Extension de balisage {StaticResource}
• Références aux ressources ResourceDictionary et XAML