XslCompiledTransform.Transform XslCompiledTransform.Transform XslCompiledTransform.Transform XslCompiledTransform.Transform Method

定義

XSLT 変換を実行します。Executes the XSLT transformation.

オーバーロード

Transform(XmlReader, XsltArgumentList, TextWriter) Transform(XmlReader, XsltArgumentList, TextWriter) Transform(XmlReader, XsltArgumentList, TextWriter) Transform(XmlReader, XsltArgumentList, TextWriter)

XmlReader オブジェクトで指定された入力ドキュメントを使用して変換を実行し、結果を TextWriter に出力します。Executes the transform using the input document specified by the XmlReader object and outputs the results to a TextWriter. XsltArgumentList には、追加の実行時引数を指定します。The XsltArgumentList provides additional run-time arguments.

Transform(IXPathNavigable, XsltArgumentList, XmlWriter) Transform(IXPathNavigable, XsltArgumentList, XmlWriter) Transform(IXPathNavigable, XsltArgumentList, XmlWriter) Transform(IXPathNavigable, XsltArgumentList, XmlWriter)

IXPathNavigable オブジェクトで指定された入力ドキュメントを使用して変換を実行し、結果を XmlWriter に出力します。Executes the transform using the input document specified by the IXPathNavigable object and outputs the results to an XmlWriter. XsltArgumentList には、追加の実行時引数を指定します。The XsltArgumentList provides additional run-time arguments.

Transform(IXPathNavigable, XsltArgumentList, TextWriter) Transform(IXPathNavigable, XsltArgumentList, TextWriter) Transform(IXPathNavigable, XsltArgumentList, TextWriter) Transform(IXPathNavigable, XsltArgumentList, TextWriter)

IXPathNavigable オブジェクトで指定された入力ドキュメントを使用して変換を実行し、結果を TextWriter に出力します。Executes the transform using the input document specified by the IXPathNavigable object and outputs the results to an TextWriter. XsltArgumentList には、追加の実行時引数を指定します。The XsltArgumentList provides additional run-time arguments.

Transform(IXPathNavigable, XsltArgumentList, Stream) Transform(IXPathNavigable, XsltArgumentList, Stream) Transform(IXPathNavigable, XsltArgumentList, Stream) Transform(IXPathNavigable, XsltArgumentList, Stream)

IXPathNavigable オブジェクトで指定された入力ドキュメントを使用して変換を実行し、結果をストリームに出力します。Executes the transform using the input document specified by the IXPathNavigable object and outputs the results to a stream. XsltArgumentList には、追加の実行時引数を指定します。The XsltArgumentList provides additional runtime arguments.

Transform(XmlReader, XsltArgumentList, XmlWriter) Transform(XmlReader, XsltArgumentList, XmlWriter) Transform(XmlReader, XsltArgumentList, XmlWriter) Transform(XmlReader, XsltArgumentList, XmlWriter)

XmlReader オブジェクトで指定された入力ドキュメントを使用して変換を実行し、結果を XmlWriter に出力します。Executes the transform using the input document specified by the XmlReader object and outputs the results to an XmlWriter. XsltArgumentList には、追加の実行時引数を指定します。The XsltArgumentList provides additional run-time arguments.

Transform(XmlReader, XsltArgumentList, Stream) Transform(XmlReader, XsltArgumentList, Stream) Transform(XmlReader, XsltArgumentList, Stream) Transform(XmlReader, XsltArgumentList, Stream)

XmlReader オブジェクトで指定された入力ドキュメントを使用して変換を実行し、結果をストリームに出力します。Executes the transform using the input document specified by the XmlReader object and outputs the results to a stream. XsltArgumentList には、追加の実行時引数を指定します。The XsltArgumentList provides additional run-time arguments.

Transform(String, String) Transform(String, String) Transform(String, String) Transform(String, String)

URI で指定された入力ドキュメントを使用して変換を実行し、結果をファイルに出力します。Executes the transform using the input document specified by the URI and outputs the results to a file.

Transform(String, XsltArgumentList, TextWriter) Transform(String, XsltArgumentList, TextWriter) Transform(String, XsltArgumentList, TextWriter) Transform(String, XsltArgumentList, TextWriter)

URI で指定された入力ドキュメントを使用して変換を実行し、結果を TextWriter に出力します。Executes the transform using the input document specified by the URI and outputs the results to a TextWriter.

Transform(String, XsltArgumentList, Stream) Transform(String, XsltArgumentList, Stream) Transform(String, XsltArgumentList, Stream) Transform(String, XsltArgumentList, Stream)

URI で指定された入力ドキュメントを使用して変換を実行し、結果をストリームに出力します。Executes the transform using the input document specified by the URI and outputs the results to stream. XsltArgumentList には、追加の実行時引数を指定します。The XsltArgumentList provides additional run-time arguments.

Transform(IXPathNavigable, XmlWriter) Transform(IXPathNavigable, XmlWriter) Transform(IXPathNavigable, XmlWriter) Transform(IXPathNavigable, XmlWriter)

IXPathNavigable オブジェクトで指定された入力ドキュメントを使用して変換を実行し、結果を XmlWriter に出力します。Executes the transform using the input document specified by the IXPathNavigable object and outputs the results to an XmlWriter.

Transform(XmlReader, XmlWriter) Transform(XmlReader, XmlWriter) Transform(XmlReader, XmlWriter) Transform(XmlReader, XmlWriter)

XmlReader オブジェクトで指定された入力ドキュメントを使用して変換を実行し、結果を XmlWriter に出力します。Executes the transform using the input document specified by the XmlReader object and outputs the results to an XmlWriter.

Transform(String, XmlWriter) Transform(String, XmlWriter) Transform(String, XmlWriter) Transform(String, XmlWriter)

URI で指定された入力ドキュメントを使用して変換を実行し、結果を XmlWriter に出力します。Executes the transform using the input document specified by the URI and outputs the results to an XmlWriter.

Transform(XmlReader, XsltArgumentList, XmlWriter, XmlResolver) Transform(XmlReader, XsltArgumentList, XmlWriter, XmlResolver) Transform(XmlReader, XsltArgumentList, XmlWriter, XmlResolver) Transform(XmlReader, XsltArgumentList, XmlWriter, XmlResolver)

XmlReader オブジェクトで指定された入力ドキュメントを使用して変換を実行し、結果を XmlWriter に出力します。Executes the transform using the input document specified by the XmlReader object and outputs the results to an XmlWriter. XsltArgumentList には追加の実行時引数を指定し、XmlResolver で XSLT の document() 関数を解決します。The XsltArgumentList provides additional run-time arguments and the XmlResolver resolves the XSLT document() function.

Transform(String, XsltArgumentList, XmlWriter) Transform(String, XsltArgumentList, XmlWriter) Transform(String, XsltArgumentList, XmlWriter) Transform(String, XsltArgumentList, XmlWriter)

URI で指定された入力ドキュメントを使用して変換を実行し、結果を XmlWriter に出力します。Executes the transform using the input document specified by the URI and outputs the results to an XmlWriter. XsltArgumentList には、追加の実行時引数を指定します。The XsltArgumentList provides additional run-time arguments.

Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver) Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver) Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver) Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver)

IXPathNavigable オブジェクトで指定された入力ドキュメントを使用して変換を実行し、結果を XmlWriter に出力します。Executes the transform by using the input document that is specified by the IXPathNavigable object and outputs the results to an XmlWriter. XsltArgumentList には追加の実行時引数を指定し、XmlResolver で XSLT の document() 関数を解決します。The XsltArgumentList provides additional run-time arguments and the XmlResolver resolves the XSLT document() function.

注釈

注意

デバッグ モードでコンパイルされた XSLT と、リリース モードでコンパイルされた XSLT には違いがあります。There are differences between XSLT compiled in Debug mode and XSLT compiled in Release mode. 状況によっては、デバッグ モードでコンパイルされたスタイル シートが、Load の間にはエラーをスローしないが、その後の Transform の間にエラーとなります。In some situations, style sheets compiled in Debug mode will not throw errors during Load, but will later fail during Transform. 同じスタイル シートをリリース モードでコンパイルすると、Load の間にエラーが発生します。The same style sheet compiled in Release mode will fail during Load. このような動作の 1 つの例は、ノード セット型ではない変数を、ノード セット型が必要な式に代入する場合です。An example of such behavior is when a variable that is not of a node-set type is assigned to an expression where a node-set is required.

Transform(XmlReader, XsltArgumentList, TextWriter) Transform(XmlReader, XsltArgumentList, TextWriter) Transform(XmlReader, XsltArgumentList, TextWriter) Transform(XmlReader, XsltArgumentList, TextWriter)

XmlReader オブジェクトで指定された入力ドキュメントを使用して変換を実行し、結果を TextWriter に出力します。Executes the transform using the input document specified by the XmlReader object and outputs the results to a TextWriter. XsltArgumentList には、追加の実行時引数を指定します。The XsltArgumentList provides additional run-time arguments.

public:
 void Transform(System::Xml::XmlReader ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::IO::TextWriter ^ results);
public void Transform (System.Xml.XmlReader input, System.Xml.Xsl.XsltArgumentList arguments, System.IO.TextWriter results);
member this.Transform : System.Xml.XmlReader * System.Xml.Xsl.XsltArgumentList * System.IO.TextWriter -> unit
Public Sub Transform (input As XmlReader, arguments As XsltArgumentList, results As TextWriter)

パラメーター

input
XmlReader XmlReader XmlReader XmlReader

入力ドキュメントが格納されている XmlReaderAn XmlReader containing the input document.

arguments
XsltArgumentList XsltArgumentList XsltArgumentList XsltArgumentList

変換に対する入力として使用された名前空間限定引数を含む XsltArgumentListAn XsltArgumentList containing the namespace-qualified arguments used as input to the transform. この値は、null の場合もあります。This value can be null.

results
TextWriter TextWriter TextWriter TextWriter

出力先の TextWriterThe TextWriter to which you want to output.

例外

input または results の値が null です。The input or results value is null.

XSLT 変換の実行中にエラーが発生しました。There was an error executing the XSLT transform.

注釈

スタイル シートには、XSLT が含まれている場合document()関数が解決を使用して、XmlUrlResolverをユーザーの資格情報なし。If the style sheet includes an XSLT document() function, it is resolved using an XmlUrlResolver with no user credentials. 受け取るオーバー ロードを使用して、認証が必要なネットワーク リソースには、外部のリソースが存在する場合、XmlResolver引数の 1 つとして指定し、XmlResolverのために必要な資格情報を使用します。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.

こちらもご覧ください

Transform(IXPathNavigable, XsltArgumentList, XmlWriter) Transform(IXPathNavigable, XsltArgumentList, XmlWriter) Transform(IXPathNavigable, XsltArgumentList, XmlWriter) Transform(IXPathNavigable, XsltArgumentList, XmlWriter)

IXPathNavigable オブジェクトで指定された入力ドキュメントを使用して変換を実行し、結果を XmlWriter に出力します。Executes the transform using the input document specified by the IXPathNavigable object and outputs the results to an XmlWriter. XsltArgumentList には、追加の実行時引数を指定します。The XsltArgumentList provides additional run-time arguments.

public:
 void Transform(System::Xml::XPath::IXPathNavigable ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::Xml::XmlWriter ^ results);
public void Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList arguments, System.Xml.XmlWriter results);
member this.Transform : System.Xml.XPath.IXPathNavigable * System.Xml.Xsl.XsltArgumentList * System.Xml.XmlWriter -> unit
Public Sub Transform (input As IXPathNavigable, arguments As XsltArgumentList, results As XmlWriter)

パラメーター

input
IXPathNavigable IXPathNavigable IXPathNavigable IXPathNavigable

IXPathNavigable インターフェイスを実装するオブジェクト。An object implementing the IXPathNavigable interface. Microsoft .NET Framework では、これは XmlNode (通常は XmlDocument)、または変換されるデータを含む XPathDocument になります。In the Microsoft .NET Framework, this can be either an XmlNode (typically an XmlDocument), or an XPathDocument containing the data to be transformed.

arguments
XsltArgumentList XsltArgumentList XsltArgumentList XsltArgumentList

変換に対する入力として使用された名前空間限定引数を含む XsltArgumentListAn XsltArgumentList containing the namespace-qualified arguments used as input to the transform. この値は、null の場合もあります。This value can be null.

results
XmlWriter XmlWriter XmlWriter XmlWriter

出力先の XmlWriterThe XmlWriter to which you want to output.

スタイル シートに xsl:output 要素が含まれている場合は、OutputSettings プロパティから返される XmlWriterSettings オブジェクトを使用して XmlWriter を作成する必要があります。If the style sheet contains an xsl:output element, you should create the XmlWriter using the XmlWriterSettings object returned from the OutputSettings property. これにより、XmlWriter に正しい出力設定が設定されます。This ensures that the XmlWriter has the correct output settings.

例外

input または results の値が null です。The input or results value is null.

XSLT 変換の実行中にエラーが発生しました。There was an error executing the XSLT transform.

注釈

場合、XSLTdocument()機能が有効では解決を使用して、XmlUrlResolverをユーザーの資格情報なし。If the XSLT document() function is enabled, it is resolved using an XmlUrlResolver with no user credentials. 受け取るオーバー ロードを使用して、認証が必要なネットワーク リソースには、外部のリソースが存在する場合、XmlResolver引数の 1 つとして指定し、XmlResolverのために必要な資格情報を使用します。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.

このメソッドがサポートしていません、xsl:strip-space要素。This method does not support the xsl:strip-space element. コンパイル済みスタイル シートが含まれている場合、xsl:strip-space要素が使用する必要があります、Transformオーバー ロードの受け取り、XmlReader入力引数として。If your compiled style sheet included the xsl:strip-space element, you must use the Transform overload which takes an XmlReader as the input argument.

IXPathNavigable インターフェイスは、XmlNode および XPathDocument クラスに実装されています。The IXPathNavigable interface is implemented in the XmlNode and XPathDocument classes. これらのクラスは XML データのメモリ内のキャッシュを表します。These classes represent an in-memory cache of XML data.

  • XmlNode クラスは W3C ドキュメント オブジェクト モデル (DOM) を基礎とし、編集機能も含んでいます。The XmlNode class is based on the W3C Document Object Model (DOM) and includes editing capabilities.

  • XPathDocument クラスは、XPath データ モデルに基づいた読み取り専用のデータ ストアです。The XPathDocument class is a read-only data store based on the XPath data model. XPathDocument は、XSLT 処理に推奨されるクラスです。XPathDocument is the recommended class for XSLT processing. これは、XmlNode クラスと比較して、より高速なパフォーマンスを提供します。It provides faster performance when compared to the XmlNode class.

変換はドキュメント全体に対して行われます。Transformations apply to the document as a whole. つまり、ドキュメント ルート ノード以外のノードを指定しても、変換処理では、読み込んだドキュメントのすべてのノードがアクセスされます。In other words, if you pass in a node other than the document root node, this does not prevent the transformation process from accessing all nodes in the loaded document. ノード フラグメントを変換するには、ノード フラグメントだけを含むオブジェクトを作成し、そのオブジェクトを Transform メソッドに渡します。To transform a node fragment, you must create an object containing just the node fragment, and pass that object to the Transform method. 詳細については、「方法 : ノード フラグメントを変換する」を参照してください。For more information, see How to: Transform a Node Fragment.

こちらもご覧ください

Transform(IXPathNavigable, XsltArgumentList, TextWriter) Transform(IXPathNavigable, XsltArgumentList, TextWriter) Transform(IXPathNavigable, XsltArgumentList, TextWriter) Transform(IXPathNavigable, XsltArgumentList, TextWriter)

IXPathNavigable オブジェクトで指定された入力ドキュメントを使用して変換を実行し、結果を TextWriter に出力します。Executes the transform using the input document specified by the IXPathNavigable object and outputs the results to an TextWriter. XsltArgumentList には、追加の実行時引数を指定します。The XsltArgumentList provides additional run-time arguments.

public:
 void Transform(System::Xml::XPath::IXPathNavigable ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::IO::TextWriter ^ results);
public void Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList arguments, System.IO.TextWriter results);
member this.Transform : System.Xml.XPath.IXPathNavigable * System.Xml.Xsl.XsltArgumentList * System.IO.TextWriter -> unit
Public Sub Transform (input As IXPathNavigable, arguments As XsltArgumentList, results As TextWriter)

パラメーター

input
IXPathNavigable IXPathNavigable IXPathNavigable IXPathNavigable

IXPathNavigable インターフェイスを実装するオブジェクト。An object implementing the IXPathNavigable interface. Microsoft .NET Framework では、これは XmlNode (通常は XmlDocument)、または変換されるデータを含む XPathDocument になります。In the Microsoft .NET Framework, this can be either an XmlNode (typically an XmlDocument), or an XPathDocument containing the data to be transformed.

arguments
XsltArgumentList XsltArgumentList XsltArgumentList XsltArgumentList

変換に対する入力として使用された名前空間限定引数を含む XsltArgumentListAn XsltArgumentList containing the namespace-qualified arguments used as input to the transform. この値は、null の場合もあります。This value can be null.

results
TextWriter TextWriter TextWriter TextWriter

出力先の TextWriterThe TextWriter to which you want to output.

例外

input または results の値が null です。The input or results value is null.

XSLT 変換の実行中にエラーが発生しました。There was an error executing the XSLT transform.

注釈

場合、XSLTdocument()機能が有効では解決を使用して、XmlUrlResolverをユーザーの資格情報なし。If the XSLT document() function is enabled, it is resolved using an XmlUrlResolver with no user credentials. 受け取るオーバー ロードを使用して、認証が必要なネットワーク リソースには、外部のリソースが存在する場合、XmlResolver引数の 1 つとして指定し、XmlResolverのために必要な資格情報を使用します。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.

このメソッドがサポートしていません、xsl:strip-space要素。This method does not support the xsl:strip-space element. コンパイル済みスタイル シートが含まれている場合、xsl:strip-space要素が使用する必要があります、Transformオーバー ロードの受け取り、XmlReader入力引数として。If your compiled style sheet included the xsl:strip-space element, you must use the Transform overload which takes an XmlReader as the input argument.

IXPathNavigable インターフェイスは、XmlNode および XPathDocument クラスに実装されています。The IXPathNavigable interface is implemented in the XmlNode and XPathDocument classes. これらのクラスは XML データのメモリ内のキャッシュを表します。These classes represent an in-memory cache of XML data.

  • XmlNode クラスは W3C ドキュメント オブジェクト モデル (DOM) を基礎とし、編集機能も含んでいます。The XmlNode class is based on the W3C Document Object Model (DOM) and includes editing capabilities.

  • XPathDocument クラスは、XPath データ モデルに基づいた読み取り専用のデータ ストアです。The XPathDocument class is a read-only data store based on the XPath data model. XPathDocument は、XSLT 処理に推奨されるクラスです。XPathDocument is the recommended class for XSLT processing. これは、XmlNode クラスと比較して、より高速なパフォーマンスを提供します。It provides faster performance when compared to the XmlNode class.

変換はドキュメント全体に対して行われます。Transformations apply to the document as a whole. つまり、ドキュメント ルート ノード以外のノードを指定しても、変換処理では、読み込んだドキュメントのすべてのノードがアクセスされます。In other words, if you pass in a node other than the document root node, this does not prevent the transformation process from accessing all nodes in the loaded document. ノード フラグメントを変換するには、ノード フラグメントだけを含むオブジェクトを作成し、そのオブジェクトを Transform メソッドに渡します。To transform a node fragment, you must create an object containing just the node fragment, and pass that object to the Transform method. 詳細については、「方法 : ノード フラグメントを変換する」を参照してください。For more information, see How to: Transform a Node Fragment.

こちらもご覧ください

Transform(IXPathNavigable, XsltArgumentList, Stream) Transform(IXPathNavigable, XsltArgumentList, Stream) Transform(IXPathNavigable, XsltArgumentList, Stream) Transform(IXPathNavigable, XsltArgumentList, Stream)

IXPathNavigable オブジェクトで指定された入力ドキュメントを使用して変換を実行し、結果をストリームに出力します。Executes the transform using the input document specified by the IXPathNavigable object and outputs the results to a stream. XsltArgumentList には、追加の実行時引数を指定します。The XsltArgumentList provides additional runtime arguments.

public:
 void Transform(System::Xml::XPath::IXPathNavigable ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::IO::Stream ^ results);
public void Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList arguments, System.IO.Stream results);
member this.Transform : System.Xml.XPath.IXPathNavigable * System.Xml.Xsl.XsltArgumentList * System.IO.Stream -> unit
Public Sub Transform (input As IXPathNavigable, arguments As XsltArgumentList, results As Stream)

パラメーター

input
IXPathNavigable IXPathNavigable IXPathNavigable IXPathNavigable

IXPathNavigable インターフェイスを実装するオブジェクト。An object implementing the IXPathNavigable interface. Microsoft .NET Framework では、これは XmlNode (通常は XmlDocument)、または変換されるデータを含む XPathDocument になります。In the Microsoft .NET Framework, this can be either an XmlNode (typically an XmlDocument), or an XPathDocument containing the data to be transformed.

arguments
XsltArgumentList XsltArgumentList XsltArgumentList XsltArgumentList

変換に対する入力として使用された名前空間限定引数を含む XsltArgumentListAn XsltArgumentList containing the namespace-qualified arguments used as input to the transform. この値は、null の場合もあります。This value can be null.

results
Stream Stream Stream Stream

出力先のストリーム。The stream to which you want to output.

例外

input または results の値が null です。The input or results value is null.

XSLT 変換の実行中にエラーが発生しました。There was an error executing the XSLT transform.

次の例は、XSLT 変換を実行し、出力する、FileStreamします。The following example executes an XSLT transformation and outputs to a FileStream.

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

// Create the FileStream.
using (FileStream fs = new FileStream(@"c:\data\output.xml", FileMode.Create))
{
   // Execute the transformation.
   xslt.Transform(new XPathDocument("books.xml"), null, fs);
}
' Load the style sheet.
Dim xslt As New XslCompiledTransform()
xslt.Load("output.xsl")
        
' Create the FileStream.
Using fs As New FileStream("c:\data\output.xml", FileMode.Create)
   ' Execute the transformation.
    xslt.Transform(New XPathDocument("books.xml"), Nothing, fs)
End Using

注釈

場合、XSLTdocument()機能が有効では解決を使用して、XmlUrlResolverをユーザーの資格情報なし。If the XSLT document() function is enabled, it is resolved using an XmlUrlResolver with no user credentials. 受け取るオーバー ロードを使用して、認証が必要なネットワーク リソースには、外部のリソースが存在する場合、XmlResolver引数の 1 つとして指定し、XmlResolverのために必要な資格情報を使用します。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.

このメソッドがサポートしていません、xsl:strip-space要素。This method does not support the xsl:strip-space element. コンパイル済みスタイル シートが含まれている場合、xsl:strip-space要素が使用する必要があります、Transformオーバー ロードの受け取り、XmlReader入力引数として。If your compiled style sheet included the xsl:strip-space element, you must use the Transform overload which takes an XmlReader as the input argument.

IXPathNavigable インターフェイスは、XmlNode および XPathDocument クラスに実装されています。The IXPathNavigable interface is implemented in the XmlNode and XPathDocument classes. これらのクラスは XML データのメモリ内のキャッシュを表します。These classes represent an in-memory cache of XML data.

  • XmlNode クラスは W3C ドキュメント オブジェクト モデル (DOM) を基礎とし、編集機能も含んでいます。The XmlNode class is based on the W3C Document Object Model (DOM) and includes editing capabilities.

  • XPathDocument クラスは、XPath データ モデルに基づいた読み取り専用のデータ ストアです。The XPathDocument class is a read-only data store based on the XPath data model. XPathDocument は、XSLT 処理に推奨されるクラスです。XPathDocument is the recommended class for XSLT processing. これは、XmlNode クラスと比較して、より高速なパフォーマンスを提供します。It provides faster performance when compared to the XmlNode class.

変換はドキュメント全体に対して行われます。Transformations apply to the document as a whole. つまり、ドキュメント ルート ノード以外のノードを指定しても、変換処理では、読み込んだドキュメントのすべてのノードがアクセスされます。In other words, if you pass in a node other than the document root node, this does not prevent the transformation process from accessing all nodes in the loaded document. ノード フラグメントを変換するには、ノード フラグメントだけを含むオブジェクトを作成し、そのオブジェクトを Transform メソッドに渡します。To transform a node fragment, you must create an object containing just the node fragment, and pass that object to the Transform method. 詳細については、「方法 : ノード フラグメントを変換する」を参照してください。For more information, see How to: Transform a Node Fragment.

こちらもご覧ください

Transform(XmlReader, XsltArgumentList, XmlWriter) Transform(XmlReader, XsltArgumentList, XmlWriter) Transform(XmlReader, XsltArgumentList, XmlWriter) Transform(XmlReader, XsltArgumentList, XmlWriter)

XmlReader オブジェクトで指定された入力ドキュメントを使用して変換を実行し、結果を XmlWriter に出力します。Executes the transform using the input document specified by the XmlReader object and outputs the results to an XmlWriter. XsltArgumentList には、追加の実行時引数を指定します。The XsltArgumentList provides additional run-time arguments.

public:
 void Transform(System::Xml::XmlReader ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::Xml::XmlWriter ^ results);
public void Transform (System.Xml.XmlReader input, System.Xml.Xsl.XsltArgumentList arguments, System.Xml.XmlWriter results);
member this.Transform : System.Xml.XmlReader * System.Xml.Xsl.XsltArgumentList * System.Xml.XmlWriter -> unit
Public Sub Transform (input As XmlReader, arguments As XsltArgumentList, results As XmlWriter)

パラメーター

input
XmlReader XmlReader XmlReader XmlReader

入力ドキュメントが格納されている XmlReaderAn XmlReader containing the input document.

arguments
XsltArgumentList XsltArgumentList XsltArgumentList XsltArgumentList

変換に対する入力として使用された名前空間限定引数を含む XsltArgumentListAn XsltArgumentList containing the namespace-qualified arguments used as input to the transform. この値は、null の場合もあります。This value can be null.

results
XmlWriter XmlWriter XmlWriter XmlWriter

出力先の XmlWriterThe XmlWriter to which you want to output.

スタイル シートに xsl:output 要素が含まれている場合は、OutputSettings プロパティから返される XmlWriterSettings オブジェクトを使用して XmlWriter を作成する必要があります。If the style sheet contains an xsl:output element, you should create the XmlWriter using the XmlWriterSettings object returned from the OutputSettings property. これにより、XmlWriter に正しい出力設定が設定されます。This ensures that the XmlWriter has the correct output settings.

例外

input または results の値が null です。The input or results value is null.

XSLT 変換の実行中にエラーが発生しました。There was an error executing the XSLT transform.

注釈

スタイル シートには、XSLT が含まれている場合document()関数が解決を使用して、XmlUrlResolverをユーザーの資格情報なし。If the style sheet includes an XSLT document() function, it is resolved using an XmlUrlResolver with no user credentials. 受け取るオーバー ロードを使用して、認証が必要なネットワーク リソースには、外部のリソースが存在する場合、XmlResolver引数の 1 つとして指定し、XmlResolverのために必要な資格情報を使用します。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.

こちらもご覧ください

Transform(XmlReader, XsltArgumentList, Stream) Transform(XmlReader, XsltArgumentList, Stream) Transform(XmlReader, XsltArgumentList, Stream) Transform(XmlReader, XsltArgumentList, Stream)

XmlReader オブジェクトで指定された入力ドキュメントを使用して変換を実行し、結果をストリームに出力します。Executes the transform using the input document specified by the XmlReader object and outputs the results to a stream. XsltArgumentList には、追加の実行時引数を指定します。The XsltArgumentList provides additional run-time arguments.

public:
 void Transform(System::Xml::XmlReader ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::IO::Stream ^ results);
public void Transform (System.Xml.XmlReader input, System.Xml.Xsl.XsltArgumentList arguments, System.IO.Stream results);
member this.Transform : System.Xml.XmlReader * System.Xml.Xsl.XsltArgumentList * System.IO.Stream -> unit
Public Sub Transform (input As XmlReader, arguments As XsltArgumentList, results As Stream)

パラメーター

input
XmlReader XmlReader XmlReader XmlReader

入力ドキュメントが格納されている XmlReaderAn XmlReader containing the input document.

arguments
XsltArgumentList XsltArgumentList XsltArgumentList XsltArgumentList

変換に対する入力として使用された名前空間限定引数を含む XsltArgumentListAn XsltArgumentList containing the namespace-qualified arguments used as input to the transform. この値は、null の場合もあります。This value can be null.

results
Stream Stream Stream Stream

出力先のストリーム。The stream to which you want to output.

例外

input または results の値が null です。The input or results value is null.

XSLT 変換の実行中にエラーが発生しました。There was an error executing the XSLT transform.

注釈

スタイル シートには、XSLT が含まれている場合document()関数が解決を使用して、XmlUrlResolverをユーザーの資格情報なし。If the style sheet includes an XSLT document() function, it is resolved using an XmlUrlResolver with no user credentials. 受け取るオーバー ロードを使用して、認証が必要なネットワーク リソースには、外部のリソースが存在する場合、XmlResolver引数の 1 つとして指定し、XmlResolverのために必要な資格情報を使用します。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.

こちらもご覧ください

Transform(String, String) Transform(String, String) Transform(String, String) Transform(String, String)

URI で指定された入力ドキュメントを使用して変換を実行し、結果をファイルに出力します。Executes the transform using the input document specified by the URI and outputs the results to a file.

public:
 void Transform(System::String ^ inputUri, System::String ^ resultsFile);
public void Transform (string inputUri, string resultsFile);
member this.Transform : string * string -> unit
Public Sub Transform (inputUri As String, resultsFile As String)

パラメーター

inputUri
String String String String

入力ドキュメントの URI。The URI of the input document.

resultsFile
String String String String

出力ファイルの URI。The URI of the output file.

例外

inputUri または resultsFile の値が null です。The inputUri or resultsFile value is null.

XSLT 変換の実行中にエラーが発生しました。There was an error executing the XSLT transform.

入力ドキュメントが見つかりません。The input document cannot be found.

inputUri 値または resultsFile 値に、存在しないファイル名またはディレクトリが含まれています。The inputUri or resultsFile value includes a filename or directory cannot be found.

inputUri 値または resultsFile 値を解決できません。The inputUri or resultsFile value cannot be resolved.

または-or- 要求の処理中にエラーが発生しました。An error occurred while processing the request

inputUri または resultsFile が有効な URI ではありません。inputUri or resultsFile is not a valid URI.

入力ドキュメントの読み込み中に解析エラーが発生しました。There was a parsing error loading the input document.

次の例では、変換を実行して、ファイルに出力します。The following example executes a transform and outputs to a file.

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

// Execute the transform and output the results to a file.
xslt.Transform("books.xml", "books.html");
' Load the style sheet.
Dim xslt As New XslCompiledTransform()
xslt.Load("output.xsl")
        
' Execute the transform and output the results to a file.
xslt.Transform("books.xml", "books.html")

このサンプルでは、次の 2 つの入力ファイルを使用します。The sample uses the following two input files:

books.xml

<?xml version='1.0'?>
<!-- This file represents a fragment of a book store inventory database -->
<bookstore>
  <book genre="autobiography" publicationdate="1981" ISBN="1-861003-11-0">
    <title>The Autobiography of Benjamin Franklin</title>
    <author>
      <first-name>Benjamin</first-name>
      <last-name>Franklin</last-name>
    </author>
    <price>8.99</price>
  </book>
  <book genre="novel" publicationdate="1967" ISBN="0-201-63361-2">
    <title>The Confidence Man</title>
    <author>
      <first-name>Herman</first-name>
      <last-name>Melville</last-name>
    </author>
    <price>11.99</price>
  </book>
  <book genre="philosophy" publicationdate="1991" ISBN="1-861001-57-6">
    <title>The Gorgias</title>
    <author>
      <name>Plato</name>
    </author>
    <price>9.99</price>
  </book>
</bookstore>

output.xsl

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
<xsl:template match="bookstore">
  <HTML>
    <BODY>
      <TABLE BORDER="2">
        <TR>
          <TD>ISBN</TD>
          <TD>Title</TD>
          <TD>Price</TD>
        </TR>
        <xsl:apply-templates select="book"/>
      </TABLE>
    </BODY>
  </HTML>
</xsl:template>
<xsl:template match="book">
  <TR>
    <TD><xsl:value-of select="@ISBN"/></TD>
    <TD><xsl:value-of select="title"/></TD>
    <TD><xsl:value-of select="price"/></TD>
  </TR>
</xsl:template>
</xsl:stylesheet>

注釈

このメソッドは、既定XmlUrlResolverを解決するには、入力と出力ドキュメントにユーザー資格情報なし。This method uses a default XmlUrlResolver with no user credentials to resolve the input and output documents. 受け取るオーバー ロードを使用して、これらのリソースは、認証が必要なネットワーク リソースに存在する場合、XmlResolver引数の 1 つとしてを指定し、XmlResolverのために必要な資格情報を使用します。If any of these resources are 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.

XmlReader既定値の設定は入力ドキュメントの読み込みに使用します。An XmlReader with default settings is used to load the input document. DTD の処理が無効になって、XmlReaderします。DTD processing is disabled on the XmlReader. DTD の処理が必要な場合は、作成、XmlReaderに渡すし、この機能を有効にする、Transformメソッド。If you require DTD processing, create an XmlReader with this feature enabled, and pass it to the Transform method.

こちらもご覧ください

Transform(String, XsltArgumentList, TextWriter) Transform(String, XsltArgumentList, TextWriter) Transform(String, XsltArgumentList, TextWriter) Transform(String, XsltArgumentList, TextWriter)

URI で指定された入力ドキュメントを使用して変換を実行し、結果を TextWriter に出力します。Executes the transform using the input document specified by the URI and outputs the results to a TextWriter.

public:
 void Transform(System::String ^ inputUri, System::Xml::Xsl::XsltArgumentList ^ arguments, System::IO::TextWriter ^ results);
public void Transform (string inputUri, System.Xml.Xsl.XsltArgumentList arguments, System.IO.TextWriter results);
member this.Transform : string * System.Xml.Xsl.XsltArgumentList * System.IO.TextWriter -> unit
Public Sub Transform (inputUri As String, arguments As XsltArgumentList, results As TextWriter)

パラメーター

inputUri
String String String String

入力ドキュメントの URI。The URI of the input document.

arguments
XsltArgumentList XsltArgumentList XsltArgumentList XsltArgumentList

変換に対する入力として使用された名前空間限定引数を含む XsltArgumentListAn XsltArgumentList containing the namespace-qualified arguments used as input to the transform. この値は、null の場合もあります。This value can be null.

results
TextWriter TextWriter TextWriter TextWriter

出力先の TextWriterThe TextWriter to which you want to output.

例外

inputUri または results の値が null です。The inputUri or results value is null.

XSLT 変換の実行中にエラーが発生しました。There was an error executing the XSLT transform.

inputUri の値に、存在しないファイル名またはディレクトリが含まれています。The inputUri value includes a filename or directory cannot be found.

inputUri 値を解決できません。The inputUri value cannot be resolved.

または-or- 要求の処理中にエラーが発生しました。An error occurred while processing the request

inputUri は有効な URI ではありません。inputUri is not a valid URI.

入力ドキュメントの読み込み中に解析エラーが発生しました。There was a parsing error loading the input document.

次の例では、XSLT 変換を実行し、文字列を出力します。The following example executes an XSLT transformation and outputs a string.

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

// Transform the file and output an HTML string.
string HTMLoutput;
StringWriter writer = new StringWriter();
xslt.Transform("books.xml", null, writer);
HTMLoutput = writer.ToString();
writer.Close();
' Load the style sheet.
Dim xslt As New XslCompiledTransform()
xslt.Load("HTML_out.xsl")
        
' Transform the file and output an HTML string.
Dim HTMLoutput As String
Dim writer As New StringWriter()
xslt.Transform("books.xml", Nothing, writer)
HTMLoutput = writer.ToString()
writer.Close()

注釈

このメソッドは、既定XmlUrlResolver入力ドキュメントと XSLT のすべてのインスタンスを解決するのにはユーザー資格情報のないdocument()関数は、スタイル シートであります。This method uses a default XmlUrlResolver with no user credentials to resolve the input document and any instances of the XSLT document() function found in the style sheet. 受け取るオーバー ロードを使用して、これらのリソースは、認証が必要なネットワーク リソースに存在する場合、XmlResolver引数の 1 つとしてを指定し、XmlResolverのために必要な資格情報を使用します。If any of these resources are 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.

XmlReader既定値の設定は入力ドキュメントの読み込みに使用します。An XmlReader with default settings is used to load the input document. DTD の処理が無効になって、XmlReaderします。DTD processing is disabled on the XmlReader. DTD の処理が必要な場合は、作成、XmlReaderに渡すし、この機能を有効にする、Transformメソッド。If you require DTD processing, create an XmlReader with this feature enabled, and pass it to the Transform method.

こちらもご覧ください

Transform(String, XsltArgumentList, Stream) Transform(String, XsltArgumentList, Stream) Transform(String, XsltArgumentList, Stream) Transform(String, XsltArgumentList, Stream)

URI で指定された入力ドキュメントを使用して変換を実行し、結果をストリームに出力します。Executes the transform using the input document specified by the URI and outputs the results to stream. XsltArgumentList には、追加の実行時引数を指定します。The XsltArgumentList provides additional run-time arguments.

public:
 void Transform(System::String ^ inputUri, System::Xml::Xsl::XsltArgumentList ^ arguments, System::IO::Stream ^ results);
public void Transform (string inputUri, System.Xml.Xsl.XsltArgumentList arguments, System.IO.Stream results);
member this.Transform : string * System.Xml.Xsl.XsltArgumentList * System.IO.Stream -> unit
Public Sub Transform (inputUri As String, arguments As XsltArgumentList, results As Stream)

パラメーター

inputUri
String String String String

入力ドキュメントの URI。The URI of the input document.

arguments
XsltArgumentList XsltArgumentList XsltArgumentList XsltArgumentList

変換に対する入力として使用された名前空間限定引数を含む XsltArgumentListAn XsltArgumentList containing the namespace-qualified arguments used as input to the transform. この値は、null の場合もあります。This value can be null.

results
Stream Stream Stream Stream

出力先のストリーム。The stream to which you want to output.

例外

inputUri または results の値が null です。The inputUri or results value is null.

XSLT 変換の実行中にエラーが発生しました。There was an error executing the XSLT transform.

inputUri の値に、存在しないファイル名またはディレクトリが含まれています。The inputUri value includes a filename or directory cannot be found.

inputUri 値を解決できません。The inputUri value cannot be resolved.

または-or- 要求の処理中にエラーが発生しました。An error occurred while processing the request

inputUri は有効な URI ではありません。inputUri is not a valid URI.

入力ドキュメントの読み込み中に解析エラーが発生しました。There was a parsing error loading the input document.

注釈

このメソッドは、既定XmlUrlResolver入力ドキュメントと XSLT のすべてのインスタンスを解決するのにはユーザー資格情報のないdocument()関数は、スタイル シートであります。This method uses a default XmlUrlResolver with no user credentials to resolve the input document and any instances of the XSLT document() function found in the style sheet. 受け取るオーバー ロードを使用して、これらのリソースは、認証が必要なネットワーク リソースに存在する場合、XmlResolver引数の 1 つとしてを指定し、XmlResolverのために必要な資格情報を使用します。If any of these resources are 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.

XmlReader既定値の設定は入力ドキュメントの読み込みに使用します。An XmlReader with default settings is used to load the input document. DTD の処理が無効になって、XmlReaderします。DTD processing is disabled on the XmlReader. DTD の処理が必要な場合は、作成、XmlReaderに渡すし、この機能を有効にする、Transformメソッド。If you require DTD processing, create an XmlReader with this feature enabled, and pass it to the Transform method.

こちらもご覧ください

Transform(IXPathNavigable, XmlWriter) Transform(IXPathNavigable, XmlWriter) Transform(IXPathNavigable, XmlWriter) Transform(IXPathNavigable, XmlWriter)

IXPathNavigable オブジェクトで指定された入力ドキュメントを使用して変換を実行し、結果を XmlWriter に出力します。Executes the transform using the input document specified by the IXPathNavigable object and outputs the results to an XmlWriter.

public:
 void Transform(System::Xml::XPath::IXPathNavigable ^ input, System::Xml::XmlWriter ^ results);
public void Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.XmlWriter results);
member this.Transform : System.Xml.XPath.IXPathNavigable * System.Xml.XmlWriter -> unit
Public Sub Transform (input As IXPathNavigable, results As XmlWriter)

パラメーター

input
IXPathNavigable IXPathNavigable IXPathNavigable IXPathNavigable

IXPathNavigable インターフェイスを実装するオブジェクト。An object implementing the IXPathNavigable interface. Microsoft .NET Framework では、これは XmlNode (通常は XmlDocument)、または変換されるデータを含む XPathDocument になります。In the Microsoft .NET Framework, this can be either an XmlNode (typically an XmlDocument), or an XPathDocument containing the data to be transformed.

results
XmlWriter XmlWriter XmlWriter XmlWriter

出力先の XmlWriterThe XmlWriter to which you want to output.

スタイル シートに xsl:output 要素が含まれている場合は、OutputSettings プロパティから返される XmlWriterSettings オブジェクトを使用して XmlWriter を作成する必要があります。If the style sheet contains an xsl:output element, you should create the XmlWriter using the XmlWriterSettings object returned from the OutputSettings property. これにより、XmlWriter に正しい出力設定が設定されます。This ensures that the XmlWriter has the correct output settings.

例外

input または results の値が null です。The input or results value is null.

XSLT 変換の実行中にエラーが発生しました。There was an error executing the XSLT transform.

次の例は、XSLT 変換を実行し、出力する、XmlWriterオブジェクト。The following example executes an XSLT transformation and outputs to an XmlWriter object.

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

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

// Execute the transformation.
xslt.Transform(new XPathDocument("books.xml"), writer);
writer.Close();
' Load the style sheet.
Dim xslt As New XslCompiledTransform()
xslt.Load("output.xsl")
        
' Create the writer.
Dim settings As New XmlWriterSettings()
settings.Indent = True
settings.IndentChars = vbTab
Dim writer As XmlWriter = XmlWriter.Create("output.xml", settings)
        
' Execute the transformation.
xslt.Transform(New XPathDocument("books.xml"), writer)
writer.Close()

注釈

場合、XSLTdocument()機能が有効では解決を使用して、XmlUrlResolverをユーザーの資格情報なし。If the XSLT document() function is enabled, it is resolved using an XmlUrlResolver with no user credentials. 受け取るオーバー ロードを使用して、認証が必要なネットワーク リソースには、外部のリソースが存在する場合、XmlResolver引数の 1 つとして指定し、XmlResolverのために必要な資格情報を使用します。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.

このメソッドがサポートしていません、xsl:strip-space要素。This method does not support the xsl:strip-space element. コンパイル済みスタイル シートが含まれている場合、xsl:strip-space要素が使用する必要があります、Transformオーバー ロードの受け取り、XmlReader入力引数として。If your compiled style sheet included the xsl:strip-space element, you must use the Transform overload which takes an XmlReader as the input argument.

IXPathNavigable インターフェイスは、XmlNode および XPathDocument クラスに実装されています。The IXPathNavigable interface is implemented in the XmlNode and XPathDocument classes. これらのクラスは XML データのメモリ内のキャッシュを表します。These classes represent an in-memory cache of XML data.

  • XmlNode クラスは W3C ドキュメント オブジェクト モデル (DOM) を基礎とし、編集機能も含んでいます。The XmlNode class is based on the W3C Document Object Model (DOM) and includes editing capabilities.

  • XPathDocument クラスは、XPath データ モデルに基づいた読み取り専用のデータ ストアです。The XPathDocument class is a read-only data store based on the XPath data model. XPathDocument は、XSLT 処理に推奨されるクラスです。XPathDocument is the recommended class for XSLT processing. これは、XmlNode クラスと比較して、より高速なパフォーマンスを提供します。It provides faster performance when compared to the XmlNode class.

変換はドキュメント全体に対して行われます。Transformations apply to the document as a whole. つまり、ドキュメント ルート ノード以外のノードを指定しても、変換処理では、読み込んだドキュメントのすべてのノードがアクセスされます。In other words, if you pass in a node other than the document root node, this does not prevent the transformation process from accessing all nodes in the loaded document. ノード フラグメントを変換するには、ノード フラグメントだけを含むオブジェクトを作成し、そのオブジェクトを Transform メソッドに渡します。To transform a node fragment, you must create an object containing just the node fragment, and pass that object to the Transform method. 詳細については、「方法 : ノード フラグメントを変換する」を参照してください。For more information, see How to: Transform a Node Fragment.

こちらもご覧ください

Transform(XmlReader, XmlWriter) Transform(XmlReader, XmlWriter) Transform(XmlReader, XmlWriter) Transform(XmlReader, XmlWriter)

XmlReader オブジェクトで指定された入力ドキュメントを使用して変換を実行し、結果を XmlWriter に出力します。Executes the transform using the input document specified by the XmlReader object and outputs the results to an XmlWriter.

public:
 void Transform(System::Xml::XmlReader ^ input, System::Xml::XmlWriter ^ results);
public void Transform (System.Xml.XmlReader input, System.Xml.XmlWriter results);
member this.Transform : System.Xml.XmlReader * System.Xml.XmlWriter -> unit
Public Sub Transform (input As XmlReader, results As XmlWriter)

パラメーター

input
XmlReader XmlReader XmlReader XmlReader

入力ドキュメントが格納されている XmlReaderThe XmlReader containing the input document.

results
XmlWriter XmlWriter XmlWriter XmlWriter

出力先の XmlWriterThe XmlWriter to which you want to output.

スタイル シートに xsl:output 要素が含まれている場合は、OutputSettings プロパティから返される XmlWriterSettings オブジェクトを使用して XmlWriter を作成する必要があります。If the style sheet contains an xsl:output element, you should create the XmlWriter using the XmlWriterSettings object returned from the OutputSettings property. これにより、XmlWriter に正しい出力設定が設定されます。This ensures that the XmlWriter has the correct output settings.

例外

input または results の値が null です。The input or results value is null.

XSLT 変換の実行中にエラーが発生しました。There was an error executing the XSLT transform.

次の例では、books.xml ファイルの最初の書籍を変換します。The following example transforms the first book in the books.xml file.

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

// 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");
reader.MoveToContent();

// Execute the transformation.
xslt.Transform(reader, writer);
writer.Close();
reader.Close();
' Load the style sheet.
Dim xslt As New XslCompiledTransform()
xslt.Load("output.xsl")
        
' Create the writer.
Dim settings As New XmlWriterSettings()
settings.Indent = True
settings.IndentChars = vbTab
Dim writer As XmlWriter = XmlWriter.Create("output.xml", settings)
        
Dim reader As XmlReader = XmlReader.Create("books.xml")
reader.MoveToContent()
        
' Execute the transformation.
xslt.Transform(reader, writer)
writer.Close()
reader.Close()

注釈

場合、XSLTdocument()機能が有効では解決を使用して、XmlUrlResolverをユーザーの資格情報なし。If the XSLT document() function is enabled, it is resolved using an XmlUrlResolver with no user credentials. 受け取るオーバー ロードを使用して、認証が必要なネットワーク リソースには、外部のリソースが存在する場合、XmlResolver引数の 1 つとして指定し、XmlResolverのために必要な資格情報を使用します。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.

こちらもご覧ください

Transform(String, XmlWriter) Transform(String, XmlWriter) Transform(String, XmlWriter) Transform(String, XmlWriter)

URI で指定された入力ドキュメントを使用して変換を実行し、結果を XmlWriter に出力します。Executes the transform using the input document specified by the URI and outputs the results to an XmlWriter.

public:
 void Transform(System::String ^ inputUri, System::Xml::XmlWriter ^ results);
public void Transform (string inputUri, System.Xml.XmlWriter results);
member this.Transform : string * System.Xml.XmlWriter -> unit
Public Sub Transform (inputUri As String, results As XmlWriter)

パラメーター

inputUri
String String String String

入力ドキュメントの URI。The URI of the input document.

results
XmlWriter XmlWriter XmlWriter XmlWriter

出力先の XmlWriterThe XmlWriter to which you want to output.

スタイル シートに xsl:output 要素が含まれている場合は、OutputSettings プロパティから返される XmlWriterSettings オブジェクトを使用して XmlWriter を作成する必要があります。If the style sheet contains an xsl:output element, you should create the XmlWriter using the XmlWriterSettings object returned from the OutputSettings property. これにより、XmlWriter に正しい出力設定が設定されます。This ensures that the XmlWriter has the correct output settings.

例外

inputUri または results の値が null です。The inputUri or results value is null.

XSLT 変換の実行中にエラーが発生しました。There was an error executing the XSLT transform.

inputUri の値に、存在しないファイル名またはディレクトリが含まれています。The inputUri value includes a filename or directory cannot be found.

inputUri 値を解決できません。The inputUri value cannot be resolved.

または-or- この要求の処理中にエラーが発生しました。An error occurred while processing the request.

inputUri は有効な URI ではありません。inputUri is not a valid URI.

入力ドキュメントの読み込み中に解析エラーが発生しました。There was a parsing error loading the input document.

次の例は、XSLT 変換を実行し、出力する、XmlWriterオブジェクト。The following example executes an XSLT transformation and outputs to an XmlWriter object.

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

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

// Execute the transformation.
xslt.Transform("books.xml", writer);
writer.Close();
' Load the style sheet.
Dim xslt As New XslCompiledTransform()
xslt.Load("output.xsl")
        
' Create the writer.
Dim settings As New XmlWriterSettings()
settings.Indent = True
settings.IndentChars = vbTab
Dim writer As XmlWriter = XmlWriter.Create("output.xml", settings)
        
' Execute the transformation.
xslt.Transform("books.xml", writer)
writer.Close()

注釈

このメソッドは、既定XmlUrlResolver入力ドキュメントと XSLT のすべてのインスタンスを解決するのにはユーザー資格情報のないdocument()関数は、スタイル シートであります。This method uses a default XmlUrlResolver with no user credentials to resolve the input document and any instances of the XSLT document() function found in the style sheet. 受け取るオーバー ロードを使用して、これらのリソースは、認証が必要なネットワーク リソースに存在する場合、XmlResolver引数の 1 つとしてを指定し、XmlResolverのために必要な資格情報を使用します。If any of these resources are 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.

XmlReader既定値の設定は入力ドキュメントの読み込みに使用します。An XmlReader with default settings is used to load the input document. DTD の処理が無効になって、XmlReaderします。DTD processing is disabled on the XmlReader. DTD の処理が必要な場合は、作成、XmlReaderに渡すし、この機能を有効にする、Transformメソッド。If you require DTD processing, create an XmlReader with this feature enabled, and pass it to the Transform method.

このメソッドがサポートしていません、xsl:strip-space要素。This method does not support the xsl:strip-space element. コンパイル済みスタイル シートが含まれている場合、xsl:strip-space要素が使用する必要があります、Transformオーバー ロードの受け取り、XmlReader入力引数として。If your compiled style sheet included the xsl:strip-space element, you must use the Transform overload which takes an XmlReader as the input argument.

こちらもご覧ください

Transform(XmlReader, XsltArgumentList, XmlWriter, XmlResolver) Transform(XmlReader, XsltArgumentList, XmlWriter, XmlResolver) Transform(XmlReader, XsltArgumentList, XmlWriter, XmlResolver) Transform(XmlReader, XsltArgumentList, XmlWriter, XmlResolver)

XmlReader オブジェクトで指定された入力ドキュメントを使用して変換を実行し、結果を XmlWriter に出力します。Executes the transform using the input document specified by the XmlReader object and outputs the results to an XmlWriter. XsltArgumentList には追加の実行時引数を指定し、XmlResolver で XSLT の document() 関数を解決します。The XsltArgumentList provides additional run-time arguments and the XmlResolver resolves the XSLT document() function.

public:
 void Transform(System::Xml::XmlReader ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::Xml::XmlWriter ^ results, System::Xml::XmlResolver ^ documentResolver);
public void Transform (System.Xml.XmlReader input, System.Xml.Xsl.XsltArgumentList arguments, System.Xml.XmlWriter results, System.Xml.XmlResolver documentResolver);
member this.Transform : System.Xml.XmlReader * System.Xml.Xsl.XsltArgumentList * System.Xml.XmlWriter * System.Xml.XmlResolver -> unit
Public Sub Transform (input As XmlReader, arguments As XsltArgumentList, results As XmlWriter, documentResolver As XmlResolver)

パラメーター

input
XmlReader XmlReader XmlReader XmlReader

入力ドキュメントが格納されている XmlReaderAn XmlReader containing the input document.

arguments
XsltArgumentList XsltArgumentList XsltArgumentList XsltArgumentList

変換に対する入力として使用された名前空間限定引数を含む XsltArgumentListAn XsltArgumentList containing the namespace-qualified arguments used as input to the transform. この値は、null の場合もあります。This value can be null.

results
XmlWriter XmlWriter XmlWriter XmlWriter

出力先の XmlWriterThe XmlWriter to which you want to output.

スタイル シートに xsl:output 要素が含まれている場合は、OutputSettings プロパティから返される XmlWriterSettings オブジェクトを使用して XmlWriter を作成する必要があります。If the style sheet contains an xsl:output element, you should create the XmlWriter using the XmlWriterSettings object returned from the OutputSettings property. これにより、XmlWriter に正しい出力設定が設定されます。This ensures that the XmlWriter has the correct output settings.

documentResolver
XmlResolver XmlResolver XmlResolver XmlResolver

XSLT の document() 関数を解決するために使用する XmlResolverThe XmlResolver used to resolve the XSLT document() function. これが null の場合、document() 関数は解決されません。If this is null, the document() function is not resolved.

例外

input または results の値が null です。The input or results value is null.

XSLT 変換の実行中にエラーが発生しました。There was an error executing the XSLT transform.

次の例では、 XmlSecureResolver XSLT を解決するのにはdocument()関数。The following example uses an XmlSecureResolver to resolve the XSLT document() function.

// Create a resolver and specify the necessary credentials.
XmlSecureResolver resolver = new XmlSecureResolver(new XmlUrlResolver(), "http://serverName/data/");
System.Net.NetworkCredential myCred;
myCred  = new System.Net.NetworkCredential(UserName,SecurelyStoredPassword,Domain);  
resolver.Credentials = myCred;

XsltSettings settings = new XsltSettings();
settings.EnableDocumentFunction = true;
  
// Load the style sheet.
XslCompiledTransform xslt = new XslCompiledTransform();
xslt.Load("http://serverName/data/xsl/sort.xsl", settings, resolver);

// Transform the file.
using (XmlReader reader = XmlReader.Create("books.xml"))
{
   using (XmlWriter writer = XmlWriter.Create("output.xml")) 
   {
      xslt.Transform(reader, null, writer, resolver);
   }
}
' Create a resolver and specify the necessary credentials.
Dim resolver As New XmlSecureResolver(New XmlUrlResolver(), "http://serverName/data/")
Dim myCred As System.Net.NetworkCredential
myCred = New System.Net.NetworkCredential(UserName, SecurelyStoredPassword, Domain)
resolver.Credentials = myCred
        
Dim settings As New XsltSettings()
settings.EnableDocumentFunction = True
        
' Load the style sheet.
Dim xslt As New XslCompiledTransform()
xslt.Load("http://serverName/data/xsl/sort.xsl", settings, resolver)
        
' Transform the file.
        Using reader As XmlReader = XmlReader.Create("books.xml")

            Using writer As XmlWriter = XmlWriter.Create("output.xml")
                xslt.Transform(reader, Nothing, writer, resolver)
            End Using

        End Using
こちらもご覧ください

Transform(String, XsltArgumentList, XmlWriter) Transform(String, XsltArgumentList, XmlWriter) Transform(String, XsltArgumentList, XmlWriter) Transform(String, XsltArgumentList, XmlWriter)

URI で指定された入力ドキュメントを使用して変換を実行し、結果を XmlWriter に出力します。Executes the transform using the input document specified by the URI and outputs the results to an XmlWriter. XsltArgumentList には、追加の実行時引数を指定します。The XsltArgumentList provides additional run-time arguments.

public:
 void Transform(System::String ^ inputUri, System::Xml::Xsl::XsltArgumentList ^ arguments, System::Xml::XmlWriter ^ results);
public void Transform (string inputUri, System.Xml.Xsl.XsltArgumentList arguments, System.Xml.XmlWriter results);
member this.Transform : string * System.Xml.Xsl.XsltArgumentList * System.Xml.XmlWriter -> unit
Public Sub Transform (inputUri As String, arguments As XsltArgumentList, results As XmlWriter)

パラメーター

inputUri
String String String String

入力ドキュメントの URI。The URI of the input document.

arguments
XsltArgumentList XsltArgumentList XsltArgumentList XsltArgumentList

変換に対する入力として使用された名前空間限定引数を含む XsltArgumentListAn XsltArgumentList containing the namespace-qualified arguments used as input to the transform. この値は、null の場合もあります。This value can be null.

results
XmlWriter XmlWriter XmlWriter XmlWriter

出力先の XmlWriterThe XmlWriter to which you want to output.

スタイル シートに xsl:output 要素が含まれている場合は、OutputSettings プロパティから返される XmlWriterSettings オブジェクトを使用して XmlWriter を作成する必要があります。If the style sheet contains an xsl:output element, you should create the XmlWriter using the XmlWriterSettings object returned from the OutputSettings property. これにより、XmlWriter に正しい出力設定が設定されます。This ensures that the XmlWriter has the correct output settings.

例外

inputUri または results の値が null です。The inputUri or results value is null.

XSLT 変換の実行中にエラーが発生しました。There was an error executing the XSLT transform.

inputtUri の値に、存在しないファイル名またはディレクトリが含まれています。The inputtUri value includes a filename or directory cannot be found.

inputUri 値を解決できません。The inputUri value cannot be resolved.

または-or- この要求の処理中にエラーが発生しました。An error occurred while processing the request.

inputUri は有効な URI ではありません。inputUri is not a valid URI.

入力ドキュメントの読み込み中に解析エラーが発生しました。There was a parsing error loading the input document.

次の例では、XsltArgumentListを現在の日付と時刻を表すパラメーターを作成するオブジェクト。The following example uses an XsltArgumentList object to create a parameter representing the current date and time.

using System;
using System.IO;
using System.Xml;
using System.Xml.Xsl;

public class Sample
{

    public static void Main()
    {

        // Create the XslCompiledTransform and load the stylesheet.
        XslCompiledTransform xslt = new XslCompiledTransform();
        xslt.Load("order.xsl");

        // Create the XsltArgumentList.
        XsltArgumentList xslArg = new XsltArgumentList();

        // Create a parameter which represents the current date and time.
        DateTime d = DateTime.Now;
        xslArg.AddParam("date", "", d.ToString());

        // Transform the file.
        using (XmlWriter w = XmlWriter.Create("output.xml"))
        {
            xslt.Transform("order.xml", xslArg, w);
        }
    }
}
Imports System
Imports System.IO
Imports System.Xml
Imports System.Xml.Xsl

Public Class Sample

    Public Shared Sub Main()

        ' Create the XslCompiledTransform and load the stylesheet.
        Dim xslt As New XslCompiledTransform()
        xslt.Load("order.xsl")

        ' Create the XsltArgumentList.
        Dim xslArg As New XsltArgumentList()

        ' Create a parameter which represents the current date and time.
        Dim d As DateTime = DateTime.Now
        xslArg.AddParam("date", "", d.ToString())

        Using w As XmlWriter = XmlWriter.Create("output.xml")
            ' Transform the file.
            xslt.Transform("order.xml", xslArg, w)
        End Using

    End Sub 'Main 
End Class 'Sample

例では、入力として、次の 2 つのデータ ファイルを使用します。The example uses the following two data files as input.

order.xmlorder.xml

<!--Represents a customer order-->
<order>
  <book ISBN='10-861003-324'>
    <title>The Handmaid's Tale</title>
    <price>19.95</price>
  </book>
  <cd ISBN='2-3631-4'>
    <title>Americana</title>
    <price>16.95</price>
  </cd>
</order>

order.xslorder.xsl

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
  <xsl:param name="date"/>
  <xsl:template match="/">
    <order>
      <date><xsl:value-of select="$date"/></date>
      <total><xsl:value-of select="sum(//price)"/></total>
    </order>
  </xsl:template>
</xsl:stylesheet>

注釈

このメソッドは、既定XmlUrlResolver入力ドキュメントと XSLT のすべてのインスタンスを解決するのにはユーザー資格情報のないdocument()関数は、スタイル シートであります。This method uses a default XmlUrlResolver with no user credentials to resolve the input document and any instances of the XSLT document() function found in the style sheet. 受け取るオーバー ロードを使用して、これらのリソースは、認証が必要なネットワーク リソースに存在する場合、XmlResolver引数の 1 つとしてを指定し、XmlResolverのために必要な資格情報を使用します。If any of these resources are 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.

XmlReader既定値の設定は入力ドキュメントの読み込みに使用します。An XmlReader with default settings is used to load the input document. DTD の処理が無効になって、XmlReaderします。DTD processing is disabled on the XmlReader. DTD の処理が必要な場合は、作成、XmlReaderに渡すし、この機能を有効にする、Transformメソッド。If you require DTD processing, create an XmlReader with this feature enabled, and pass it to the Transform method.

こちらもご覧ください

Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver) Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver) Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver) Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver)

IXPathNavigable オブジェクトで指定された入力ドキュメントを使用して変換を実行し、結果を XmlWriter に出力します。Executes the transform by using the input document that is specified by the IXPathNavigable object and outputs the results to an XmlWriter. XsltArgumentList には追加の実行時引数を指定し、XmlResolver で XSLT の document() 関数を解決します。The XsltArgumentList provides additional run-time arguments and the XmlResolver resolves the XSLT document() function.

public:
 void Transform(System::Xml::XPath::IXPathNavigable ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::Xml::XmlWriter ^ results, System::Xml::XmlResolver ^ documentResolver);
public void Transform (System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList arguments, System.Xml.XmlWriter results, System.Xml.XmlResolver documentResolver);
member this.Transform : System.Xml.XPath.IXPathNavigable * System.Xml.Xsl.XsltArgumentList * System.Xml.XmlWriter * System.Xml.XmlResolver -> unit
Public Sub Transform (input As IXPathNavigable, arguments As XsltArgumentList, results As XmlWriter, documentResolver As XmlResolver)

パラメーター

input
IXPathNavigable IXPathNavigable IXPathNavigable IXPathNavigable

IXPathNavigable オブジェクトで指定された変換対象のドキュメント。The document to transform that is specified by the IXPathNavigable object.

results
XmlWriter XmlWriter XmlWriter XmlWriter

出力先の XmlWriterThe XmlWriter to which you want to output.

スタイル シートに xsl:output 要素が含まれている場合は、XmlWriter プロパティから返される XmlWriterSettings オブジェクトを使用して OutputSettings を作成する必要があります。If the style sheet contains an xsl:output element, you should create the XmlWriter by using the XmlWriterSettings object that is returned from the OutputSettings property. これにより、XmlWriter に正しい出力設定が設定されます。This ensures that the XmlWriter has the correct output settings.

documentResolver
XmlResolver XmlResolver XmlResolver XmlResolver

XSLT の document() 関数を解決するために使用する XmlResolverThe XmlResolver used to resolve the XSLT document() function. これが null の場合、document() 関数は解決されません。If this is null, the document() function is not resolved.

適用対象