XamlResourceReferenceFailedEventArgs.Message Propriété

Définition

Espace de noms:

Microsoft.UI.Xaml

Obtient une description lisible par l’utilisateur (en anglais) de l’échec de référence de ressource XAML.

public:
 property Platform::String ^ Message { Platform::String ^ get(); };

winrt::hstring Message();

public string Message { get; }

var string = xamlResourceReferenceFailedEventArgs.message;

Public ReadOnly Property Message As String

Valeur de propriété

String

Platform::String

winrt::hstring

Description lisible (en anglais) de l’échec de référence de ressource XAML.

Exemples

Voici un exemple de message de l’exemple d’application WinUI Gallery après l’insertion délibérée d’une référence de ressource incorrecte (OutputTextBlockStyl au lieu de OutputTextBlockStyle). Si vous savez que la ressource souhaitée est définie dans App.xaml, l’échec de sa localisation est un indicateur fort d’une référence erronée.

Attention

Cet exemple de sortie est à titre d’illustration uniquement. Le format précis du message est défini par l’implémentation et peut changer à l’avenir. Les applications ne doivent pas tenter d’analyser le message.

Beginning search for resource with key 'OutputTextBlockStyl'.
  Searching dictionary 'ms-appx:///Controls/ControlExample.xaml' for resource with key 'OutputTextBlockStyl'.
  Finished searching dictionary 'ms-appx:///Controls/ControlExample.xaml'.
  Searching dictionary 'Framework-defined colors' for resource with key 'OutputTextBlockStyl'.
  Finished searching dictionary 'Framework-defined colors'.
  Searching dictionary 'Framework ThemeResources.xbf' for resource with key 'OutputTextBlockStyl'.
    Searching theme dictionary (active theme: 'Light') for resource with key 'OutputTextBlockStyl'.
      Searching dictionary '<anonymous dictionary>' for resource with key 'OutputTextBlockStyl'.
      Finished searching dictionary '<anonymous dictionary>'.
    Finished searching theme dictionary (active theme: 'Light').
  Finished searching dictionary 'Framework ThemeResources.xbf'.
  Searching dictionary 'ms-appx:///App.xaml' for resource with key 'OutputTextBlockStyl'.
    Searching merged dictionary with index '1' for resource with key 'OutputTextBlockStyl'.
      Searching dictionary 'ms-appx:///Microsoft.UI.Xaml/Themes/themeresources.xaml' for resource with key 'OutputTextBlockStyl'.
        Searching theme dictionary (active theme: 'Light') for resource with key 'OutputTextBlockStyl'.
          Searching dictionary 'ms-appx:///Microsoft.UI.Xaml/Themes/themeresources.xaml' for resource with key 'OutputTextBlockStyl'.
          Finished searching dictionary 'ms-appx:///Microsoft.UI.Xaml/Themes/themeresources.xaml'.
        Finished searching theme dictionary (active theme: 'Light').
      Finished searching dictionary 'ms-appx:///Microsoft.UI.Xaml/Themes/themeresources.xaml'.
    Finished searching merged dictionary with index '1'.
    Searching merged dictionary with index '0' for resource with key 'OutputTextBlockStyl'.
      Searching dictionary 'ms-appx:///ItemTemplates.xaml' for resource with key 'OutputTextBlockStyl'.
      Finished searching dictionary 'ms-appx:///ItemTemplates.xaml'.
    Finished searching merged dictionary with index '0'.
    Searching theme dictionary (active theme: 'Light') for resource with key 'OutputTextBlockStyl'.
      Searching dictionary 'ms-appx:///App.xaml' for resource with key 'OutputTextBlockStyl'.
      Finished searching dictionary 'ms-appx:///App.xaml'.
    Finished searching theme dictionary (active theme: 'Light').
  Finished searching dictionary 'ms-appx:///App.xaml'.
Finished search for resource with key 'OutputTextBlockStyl'.

Remarques

Le message dans les données d’événement contient les informations suivantes sur la référence de ressource XAML ayant échoué :

• URI de la page XAML qui contient chaque ResourceDictionary qui a fait l’objet d’une recherche.
• Ordre dans lequel les ResourceDictionarys ont été fouillés.

Vous pouvez utiliser ces informations pour déterminer pourquoi la référence de ressource XAML n’a pas pu être résolue. Par exemple, peut-être que le ResourceDictionary qui contient la ressource n’était pas dans la liste des ResourceDictionaryéléments recherchés, ou peut-être que celui-ci ResourceDictionary a fait l’objet d’une recherche, ce qui peut indiquer qu’une clé de ressource incorrecte a été spécifiée.

Voir aussi

• IsXamlResourceReferenceTracingEnabled
• XamlResourceReferenceFailed
• Références aux ressources ResourceDictionary et XAML