Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

XslCompiledTransform.Transform-Methode: (IXPathNavigable, XsltArgumentList, XmlWriter)

 

Veröffentlicht: Oktober 2016

Führt die Transformation anhand des vom angegebenen Eingabedokuments die IXPathNavigable -Objekt und gibt die Ergebnisse in eine XmlWriter. Die XsltArgumentList stellt zusätzliche Laufzeitargumente bereit.

Namespace:   System.Xml.Xsl
Assembly:  System.Xml (in System.Xml.dll)

public void Transform(
	IXPathNavigable input,
	XsltArgumentList arguments,
	XmlWriter results
)

Parameter

input
Type: System.Xml.XPath.IXPathNavigable

Ein Objekt, das die IXPathNavigable Schnittstelle. In Microsoft .NET Framework kann dies, entweder eine XmlNode (in der Regel ein XmlDocument), oder eine XPathDocument die zu transformierenden Daten enthält.

arguments
Type: System.Xml.Xsl.XsltArgumentList

Ein XsltArgumentList enthält die Namespaces gekennzeichneten Argumenten, die als Eingabe für die Transformation verwendet. Dieser Wert kann null sein.

results
Type: System.Xml.XmlWriter

Der XmlWriter, an den die Ausgabe erfolgen soll.

Wenn das Stylesheet enthält ein xsl:output -Element, erstellen Sie die XmlWriter mithilfe der XmlWriterSettings von zurückgegebene Objekt der OutputSettings Eigenschaft. Dadurch wird sichergestellt, dass die XmlWriter die korrekten ausgabeeinstellungen verfügt.

Exception Condition
ArgumentNullException

Die input oder results Wert ist null.

XsltException

Fehler bei der Ausführung der XSLT-Transformation.

Wenn die XSLT-Transformation document() Funktion aktiviert ist, erfolgt die Auflösung anhand einer XmlUrlResolver ohne Benutzeranmeldeinformationen. Wenn die externe Ressource auf einer Netzwerkressource, die eine Authentifizierung erforderlich ist gespeichert ist, verwenden Sie die Überladung mit einem XmlResolver als eines ihrer Argumente und geben Sie eine XmlResolver mit den notwendigen Anmeldeinformationen.

Diese Methode unterstützt nicht die xsl:strip-space Element. Wenn sich das kompilierte Stylesheet enthalten die xsl:strip-space -Element, verwenden Sie die Transform Überladung nimmt eine XmlReader als Eingabeargument.

Die IXPathNavigable-Schnittstelle ist in der XmlNode-Klasse und der XPathDocument-Klasse implementiert. Diese Klassen stellen einen speicherinternen Cache der XML-Daten dar.

  • Die XmlNode-Klasse basiert auf dem W3C-DOM (Document Object Model) und umfasst Bearbeitungsfunktionen.

  • Die XPathDocument-Klasse ist ein schreibgeschützter Datenspeicher, der auf dem XPath-Datenmodell basiert. XPathDocument ist die empfohlene Klasse zu XSLT-Verarbeitung. Im Vergleich zur XmlNode-Klasse bietet sie eine schnellere Leistung.

Transformationen werden auf das gesamte Dokument angewendet. Wenn Sie einen anderen Knoten als den Stammknoten des Dokuments übergeben, wird dadurch nicht verhindert, dass im Transformationsprozess auf alle Knoten im geladenen Dokument zugegriffen wird. Zum Transformieren eines Knotenfragments müssen Sie ein Objekt erstellen, das nur das Knotenfragment enthält, und dieses Objekt an die Transform-Methode übergeben. Weitere Informationen finden Sie unter Vorgehensweise: Transformieren eines Knotenfragments.

.NET Framework
Verfügbar seit 2.0
Zurück zum Anfang
Anzeigen: