IXamlNameResolver Rozhraní
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Popisuje službu, která může vracet objekty určené názvem XAML nebo případně vrací token, který vrací překlad názvů. Služba může také vrátit výčet všech pojmenovaných objektů, které jsou v názvovém oboru XAML.
public interface class IXamlNameResolver
public interface IXamlNameResolver
type IXamlNameResolver = interface
Public Interface IXamlNameResolver
Poznámky
Toto rozhraní není určeno pro externí implementaci typických scénářů XAML, protože se jedná o službu. Tato služba umožňuje rozšíření značek a převaděče typů přeložit názvy XAML na jiné objekty ze stejného zdroje XAML, zatímco jsou stále v reprezentaci uzlu XAML. Službu lze použít k překladu odkazů na předávání pro jakýkoli mechanismus, který spoléhá na názvy XAML pro nelineární přístup k okolnímu produkčnímu prostředí XAML. Další informace naleznete v tématu Převaděče typů a rozšíření značek pro XAML.
Převaděče typů a rozšíření značek se můžou dotazovat IXamlNameResolver jako službu v kontextu služby, který poskytuje zapisovač objektů XAML, když zapisovač objektu XAML vyvolá chování převodu hodnoty. Další informace najdete v tématu Převaděče typů a rozšíření značek pro kontexty XAML a služby dostupné pro převaděče typů a rozšíření značek.
Tato služba zveřejňuje rozhraní API, které může odložit překlad ip adres. Metafora implementovaná službou spočívá v tom, že názvy, které nelze přeložit při prvním předání proti částečnému grafu name-object, by měly být uloženy a použity k vytvoření oprav tokenu. Ve výchozím chování se všechny tyto názvy odesílají pro další pokus o řešení při druhém průchodu. Na druhém průchodu je celkový graf objektu názvu dokončený a všechny tokeny oprav se dají přeložit.
Poznámka
I když jsou povoleny konkrétní implementací, předávané odkazy v XAML mají nutně důsledky výkonu. Osvědčeným postupem pro xaml v produkční kvalitě je vždy, když je to možné, vyhněte se předávání odkazů.
Vlastnosti
IsFixupTokenAvailable |
Získá hodnotu, která určuje, zda je volání GetFixupToken(IEnumerable<String>, Boolean) k dispozici pro překlad názvu do tokenu pro přesměrování překladu. |
Metody
GetAllNamesAndValuesInScope() |
Vrátí výčet všech pojmenovaných objektů v názvovém oboru XAML. |
GetFixupToken(IEnumerable<String>) |
Vrátí objekt, který je možné opravit pro určité vzory revizí, které vytvářejí přeposlání odkazů. |
GetFixupToken(IEnumerable<String>, Boolean) |
Vrátí objekt, který je možné opravit pro určité vzory revizí, které vytvářejí přeposlání odkazů. |
Resolve(String) |
Přeloží objekt z odkazu na název. |
Resolve(String, Boolean) |
Řeší objekt z odkazu na název a poskytuje sledovací hodnotu, která hlásí, zda je objekt plně inicializován pro účely grafu objektů. |
událost
OnNameScopeInitializationComplete |
Nastane, když procesor XAML zaregistroval všechny relevantní názvy backing XAML namescope. |