Transform Method (XmlReader, XmlWriter)

XslCompiledTransform.Transform Method (XmlReader, XmlWriter)


Executes the transform using the input document specified by the XmlReader object and outputs the results to an XmlWriter.

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

public void Transform(
	XmlReader input,
	XmlWriter results


Type: System.Xml.XmlReader

The XmlReader containing the input document.

Type: System.Xml.XmlWriter

The XmlWriter to which you want to output.

If the style sheet contains an xsl:output element, you should create the XmlWriter using the XmlWriterSettings object returned from the OutputSettings property. This ensures that the XmlWriter has the correct output settings.

Exception Condition

The input or results value is null.


There was an error executing the XSLT transform.

If the XSLT document() function is enabled, it is resolved using an XmlUrlResolver with no user credentials. If the external resource is located on a network resource that requires authentication, use the overload that takes an XmlResolver as one of its arguments and specify an XmlResolver with the necessary credentials.

The following example transforms the first book in the books.xml file.

// Load the style sheet.
XslCompiledTransform xslt = new XslCompiledTransform();

// Create the writer.
XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.IndentChars = "\t";
XmlWriter writer = XmlWriter.Create("output.xml", settings);

XmlReader reader = XmlReader.Create("books.xml");

// Execute the transformation.
xslt.Transform(reader, writer);

.NET Framework
Available since 2.0
Return to top
© 2015 Microsoft