Export (0) Print
Expand All

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
public void Transform (
	XmlReader input, 
	XmlWriter results
public function Transform (
	input : XmlReader, 
	results : XmlWriter
Not applicable.



The XmlReader containing the input document.


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 typeCondition


The input or results value is a null reference (Nothing in Visual Basic).


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);

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

© 2014 Microsoft