IXamlNameResolver Interface

Définition

Espace de noms:
System.Xaml
Assembly:
System.Xaml.dll

Décrit un service qui peut retourner des objets spécifiés par le nom XAML, ou autrement, retourne un jeton qui reporte la résolution de noms. Le service peut également retourner un ensemble énumérable de tous les objets nommés qui se trouvent dans le namescope XAML.

public interface class IXamlNameResolver
public interface IXamlNameResolver
type IXamlNameResolver = interface
Public Interface IXamlNameResolver

Remarques

Cette interface n’est pas destinée à une implémentation externe de scénarios XAML classiques, car elle est un service. Ce service permet aux extensions de balisage et aux convertisseurs de types de résoudre les noms XAML vers d’autres objets à partir de la même source XAML alors qu’ils sont toujours dans une représentation de nœud XAML. Le service peut être utilisé pour résoudre les références de transfert pour tout mécanisme qui s’appuie sur des noms XAML pour l’accès non linéaire à la production XAML environnante. Pour plus d’informations, consultez Convertisseurs de types et extensions de balisage pour XAML.

Les convertisseurs de types et les extensions de balisage peuvent interroger IXamlNameResolver en tant que service sur le contexte de service fourni par un enregistreur d’objets XAML, lorsque l’enregistreur d’objets XAML appelle le comportement de conversion de valeur. Pour plus d’informations, consultez Convertisseurs de types et extensions de balisage pour les contextes XAML et de service disponibles pour les convertisseurs de types et les extensions de balisage.

Ce service expose une API qui peut différer la résolution de noms. La métaphore implémentée par le service est que les noms qui ne peuvent pas être résolus dans un premier passage sur un graphique d’objet de nom partiel doivent être stockés et utilisés pour créer le jeton de correction. Dans le comportement par défaut, tous ces noms sont envoyés pour une autre tentative de résolution lors d’une deuxième passe. Sur la deuxième passe, le graphique d’objet nom global est terminé et tous les jetons de correction sont en mesure de résoudre.

Note

Même s’ils sont autorisés par une implémentation particulière, les références vers l’avant dans XAML ont inévitablement des conséquences sur les performances. Comme meilleure pratique pour le xaml de qualité de la production, évitez les références vers l’avant dans la mesure du possible.

Propriétés

Nom Description
IsFixupTokenAvailable

Obtient une valeur qui détermine si l’appel GetFixupToken(IEnumerable<String>, Boolean) est disponible pour résoudre un nom en jeton pour la résolution de transfert.

Méthodes

Nom Description
GetAllNamesAndValuesInScope()

Retourne un jeu énumérable de tous les objets nommés dans le namescope XAML.
GetFixupToken(IEnumerable<String>, Boolean)

Retourne un objet qui peut corriger certains modèles de balisage qui produisent des références vers l’avant.
GetFixupToken(IEnumerable<String>)

Retourne un objet qui peut corriger certains modèles de balisage qui produisent des références vers l’avant.
Resolve(String, Boolean)

Résout un objet à partir d’une référence de nom et fournit une valeur de suivi qui indique si l’objet est entièrement initialisé à des fins de graphe d’objet.
Resolve(String)

Résout un objet à partir d’une référence de nom.

Événements

Nom Description
OnNameScopeInitializationComplete

Se produit lorsqu’un processeur XAML a inscrit tous les noms pertinents dans le namescope XAML de stockage.

S’applique à

Voir aussi