Export (0) Print
Expand All

XslTransform.Transform Method (XPathNavigator, XsltArgumentList)

Transforms the XML data in the XPathNavigator using the specified args and outputs the result to an XmlReader.

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

public XmlReader Transform(
	XPathNavigator input,
	XsltArgumentList args
)

Parameters

input
Type: System.Xml.XPath.XPathNavigator

An XPathNavigator containing the data to be transformed.

args
Type: System.Xml.Xsl.XsltArgumentList

An XsltArgumentList containing the namespace-qualified arguments used as input to the transformation.

Return Value

Type: System.Xml.XmlReader
An XmlReader containing the results of the transformation.

ExceptionCondition
InvalidOperationException

There was an error processing the XSLT transformation.

Note: This is a change in behavior from earlier versions. An XsltException is thrown if you are using Microsoft .NET Framework version 1.1 or earlier.

NoteNote

The XslTransform class is obsolete in the .NET Framework version 2.0. The XslCompiledTransform class is the new XSLT processor. For more information, see Using the XslCompiledTransform Class and Migrating From the XslTransform Class.

XslTransform supports the XSLT 1.0 syntax. The XSLT style sheet must include the namespace declaration xmlns:xsl= http://www.w3.org/1999/XSL/Transform.

The args are matched with the xsl:param elements defined in the style sheet. The transformation selections apply to the document as a whole. In other words, if the current node is set on a node tree other than the document root node, this does not prevent the transformation process from accessing all nodes in the loaded document. After the transformation has been performed, the XPathNavigator remains in its original state. This means that the node, which is current before the transformation process, remains the current node after the Transform method has been called.

Because XmlReader provides read-only output, the xsl:output element is ignored. See Outputs from an XslTransform for more information.

This method enables you to do an asynchronous transformation of the source document.

NoteNote

This method is obsolete. The setting of the XmlResolver property determines how the XSLT document() function is resolved. The recommended practice is to use the Transform method which takes an XmlResolver object as one of its arguments.

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.0
Obsolete (compiler warning) in 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft