XSLT-Erweiterungsobjekte
Mit Erweiterungsobjekten kann der Funktionsumfang von Stylesheets erweitert werden. Erweiterungsobjekte werden von der XsltArgumentList-Klasse beibehalten.
Die Verwendung eines Erweiterungsobjekts bietet gegenüber der Verwendung eines eingebetteten Skripts folgende Vorteile:
Sie ermöglicht eine bessere Kapselung und Wiederverwendung von Klassen.
Stylesheets werden kleiner und sind besser verwaltbar.
XSLT-Erweiterungsobjekte werden dem XsltArgumentList-Objekt mithilfe der AddExtensionObject-Methode hinzugefügt. Dabei wird ein qualifizierter Name und ein Namespace-URI (Uniform Resource Identifier) mit dem Parameterobjekt verknüpft.
Hinweis
Um die AddExtensionObject-Methode aufzurufen, muss die FullTrust-Berechtigung festgelegt sein. Weitere Informationen finden Sie unter Codezugriffssicherheit und Benannte Berechtigungssätze.
Von Erweiterungsobjekten kann einer der vier XPath-Grunddatentypen (number
, string
, Boolean
und node set
) zurückgegeben werden.
Alle Methoden, die mit dem params
-Schlüsselwort definiert sind, mit dem eine nicht definierte Anzahl von Parametern übergeben werden kann, werden derzeit nicht von der XslCompiledTransform-Klasse unterstützt. XSLT-Stylesheets, die Methoden mit dem params
-Schlüsselwort verwenden, funktionieren nicht ordnungsgemäß. Einzelheiten finden Sie unter params.
So verwenden Sie ein XSLT-Erweiterungsobjekt
Erstellen Sie ein XsltArgumentList-Objekt, und fügen Sie das Erweiterungsobjekt mit der AddExtensionObject-Methode hinzu.
Rufen Sie das Erweiterungsobjekt aus dem Stylesheet auf.
Übergeben Sie das XsltArgumentList-Objekt an die Transform-Methode.