IXamlNameResolver Interface

Definitie

Naamruimte:
System.Xaml
Assembly:
System.Xaml.dll

Beschrijft een service die objecten kan retourneren die zijn opgegeven door de XAML-naam of die een token retourneert waarmee naamomzetting wordt uitgesteld. De service kan ook een opsommingsset retourneren van alle benoemde objecten die zich in de XAML-naamscoop bevinden.

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

Opmerkingen

Deze interface is niet bedoeld voor externe implementatie van typische XAML-scenario's omdat deze een service is. Met deze service kunnen markeringsextensies en typeconversieprogramma's XAML-namen omzetten in andere objecten uit dezelfde XAML-bron terwijl ze zich nog in een XAML-knooppuntweergave bevinden. De service kan worden gebruikt om doorstuurverwijzingen op te lossen voor elk mechanisme dat afhankelijk is van XAML-namen voor niet-lineaire toegang tot de omringende XAML-productie. Zie Type Conversieprogramma's en Markeringsextensies voor XAML voor meer informatie.

Typeconversieprogramma's en markeringsextensies kunnen een query uitvoeren IXamlNameResolver voor als een service in de servicecontext die wordt geleverd door een XAML-objectschrijver wanneer de XAML-objectschrijver waardeconversiegedrag aanroept. Zie typeconversieprogramma's en markeringsextensies voor XAML - en servicecontexten die beschikbaar zijn voor typeconversieprogramma's en markeringsextensies voor meer informatie.

Deze service maakt een API beschikbaar die naamomzetting kan uitstellen. De metafoor die door de service wordt geïmplementeerd, is dat namen die niet kunnen worden omgezet in een eerste wachtwoord voor een gedeeltelijke naamobjectgrafiek, moeten worden opgeslagen en gebruikt om het fixup-token te maken. In het standaardgedrag worden al deze namen verzonden voor een andere oplossingspoging op een tweede pas. Op de tweede pas is de algemene naamobjectgrafiek voltooid en kunnen alle fixuptokens worden omgezet.

Note

Zelfs als ze zijn toegestaan door een bepaalde implementatie, hebben doorverwijzingen in XAML onvermijdelijk prestatiegevolgen. Als best practice voor XAML van productiekwaliteit vermijdt u waar mogelijk forward-verwijzingen.

Eigenschappen

Name Description
IsFixupTokenAvailable

Hiermee wordt een waarde opgehaald die bepaalt of aanroepen GetFixupToken(IEnumerable<String>, Boolean) beschikbaar is om een naam om te zetten in een token voor forward resolution.

Methoden

Name Description
GetAllNamesAndValuesInScope()

Retourneert een opsommingsbare set van alle benoemde objecten in de XAML-naamscoop.
GetFixupToken(IEnumerable<String>, Boolean)

Retourneert een object dat kan worden gecorrigeerd voor bepaalde markeringspatronen die forward-verwijzingen produceren.
GetFixupToken(IEnumerable<String>)

Retourneert een object dat kan worden gecorrigeerd voor bepaalde markeringspatronen die forward-verwijzingen produceren.
Resolve(String, Boolean)

Hiermee wordt een object omgezet vanuit een naamverwijzing en wordt een traceringswaarde weergegeven die rapporteert of het object volledig is geïnitialiseerd voor objectgrafiekdoeleinden.
Resolve(String)

Hiermee wordt een object omgezet vanuit een naamverwijzing.

gebeurtenis

Name Description
OnNameScopeInitializationComplete

Treedt op wanneer een XAML-processor alle relevante namen heeft geregistreerd bij de backing XAML-naamscoop.

Van toepassing op

Zie ook