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 werden 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 Code Access Security 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äß. Weitere Informationen hierzu finden Sie unter params (C#-Referenz).
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.