XslCompiledTransform.Transform Metode

Definisi

Ruang nama:: System.Xml.Xsl

Rakitan:: netstandard.dll, System.Xml.ReaderWriter.dll

Rakitan:: System.Xml.ReaderWriter.dll

Rakitan:: System.Xml.dll

Rakitan:: netstandard.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menjalankan transformasi XSLT.

Overload

Nama	Deskripsi
Transform(XmlReader, XsltArgumentList, TextWriter)	Menjalankan transformasi menggunakan dokumen input yang ditentukan oleh XmlReader objek dan menghasilkan hasilnya ke TextWriter. menyediakan XsltArgumentList argumen run-time tambahan.
Transform(IXPathNavigable, XsltArgumentList, XmlWriter)	Menjalankan transformasi menggunakan dokumen input yang ditentukan oleh IXPathNavigable objek dan menghasilkan hasilnya ke XmlWriter. menyediakan XsltArgumentList argumen run-time tambahan.
Transform(IXPathNavigable, XsltArgumentList, TextWriter)	Menjalankan transformasi menggunakan dokumen input yang ditentukan oleh IXPathNavigable objek dan menghasilkan hasilnya ke TextWriter. menyediakan XsltArgumentList argumen run-time tambahan.
Transform(IXPathNavigable, XsltArgumentList, Stream)	Menjalankan transformasi menggunakan dokumen input yang ditentukan oleh IXPathNavigable objek dan menghasilkan hasil ke aliran. menyediakan XsltArgumentList argumen runtime tambahan.
Transform(XmlReader, XsltArgumentList, XmlWriter)	Menjalankan transformasi menggunakan dokumen input yang ditentukan oleh XmlReader objek dan menghasilkan hasilnya ke XmlWriter. menyediakan XsltArgumentList argumen run-time tambahan.
Transform(XmlReader, XsltArgumentList, Stream)	Menjalankan transformasi menggunakan dokumen input yang ditentukan oleh XmlReader objek dan menghasilkan hasil ke aliran. menyediakan XsltArgumentList argumen run-time tambahan.
Transform(String, String)	Menjalankan transformasi menggunakan dokumen input yang ditentukan oleh URI dan menghasilkan hasil ke file.
Transform(String, XsltArgumentList, TextWriter)	Menjalankan transformasi menggunakan dokumen input yang ditentukan oleh URI dan menghasilkan hasilnya ke TextWriter.
Transform(String, XsltArgumentList, Stream)	Menjalankan transformasi menggunakan dokumen input yang ditentukan oleh URI dan menghasilkan hasil untuk streaming. menyediakan XsltArgumentList argumen run-time tambahan.
Transform(IXPathNavigable, XmlWriter)	Menjalankan transformasi menggunakan dokumen input yang ditentukan oleh IXPathNavigable objek dan menghasilkan hasilnya ke XmlWriter.
Transform(XmlReader, XmlWriter)	Menjalankan transformasi menggunakan dokumen input yang ditentukan oleh XmlReader objek dan menghasilkan hasilnya ke XmlWriter.
Transform(String, XmlWriter)	Menjalankan transformasi menggunakan dokumen input yang ditentukan oleh URI dan menghasilkan hasilnya ke XmlWriter.
Transform(XmlReader, XsltArgumentList, XmlWriter, XmlResolver)	Menjalankan transformasi menggunakan dokumen input yang ditentukan oleh XmlReader objek dan menghasilkan hasilnya ke XmlWriter. XsltArgumentList menyediakan argumen run-time tambahan dan XmlResolver menyelesaikan fungsi XSLT`document()`.
Transform(String, XsltArgumentList, XmlWriter)	Menjalankan transformasi menggunakan dokumen input yang ditentukan oleh URI dan menghasilkan hasilnya ke XmlWriter. menyediakan XsltArgumentList argumen run-time tambahan.
Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver)	Menjalankan transformasi dengan menggunakan dokumen input yang ditentukan oleh IXPathNavigable objek dan menghasilkan hasil ke XmlWriter. XsltArgumentList menyediakan argumen run-time tambahan dan XmlResolver menyelesaikan fungsi XSLT`document()`.

Keterangan

Note

Ada perbedaan antara XSLT yang dikompilasi dalam mode Debug dan XSLT yang dikompilasi dalam mode Rilis. Dalam beberapa situasi, lembar gaya yang dikompilasi dalam mode Debug tidak akan melemparkan kesalahan selama Load, tetapi nantinya akan gagal selama Transform. Lembar gaya yang sama yang dikompilasi dalam mode Rilis akan gagal selama Load. Contoh perilaku tersebut adalah ketika variabel yang bukan dari jenis set simpul ditetapkan ke ekspresi di mana kumpulan simpul diperlukan.

Transform(XmlReader, XsltArgumentList, TextWriter)

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Menjalankan transformasi menggunakan dokumen input yang ditentukan oleh XmlReader objek dan menghasilkan hasilnya ke TextWriter. menyediakan XsltArgumentList argumen run-time tambahan.

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

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)

Parameter

input: XmlReader

Yang XmlReader berisi dokumen input.

arguments: XsltArgumentList

Berisi XsltArgumentList argumen yang memenuhi syarat namespace yang digunakan sebagai input ke transformasi. Nilai ini bisa berupa null.

results: TextWriter

yang TextWriter ingin Anda keluarkan.

Pengecualian

ArgumentNullException

Nilai input atau results adalah null.

XsltException

Terjadi kesalahan saat menjalankan transformasi XSLT.

Keterangan

Jika lembar gaya menyertakan fungsi XSLT document() , lembar gaya diselesaikan menggunakan XmlUrlResolver tanpa kredensial pengguna. Jika sumber daya eksternal terletak di sumber daya jaringan yang memerlukan autentikasi, gunakan kelebihan beban yang mengambil XmlResolver sebagai salah satu argumennya dan tentukan dengan kredensial yang XmlResolver diperlukan.

Lihat juga

Menggunakan Kelas XslCompiledTransform

Berlaku untuk

Transform(IXPathNavigable, XsltArgumentList, XmlWriter)

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Menjalankan transformasi menggunakan dokumen input yang ditentukan oleh IXPathNavigable objek dan menghasilkan hasilnya ke XmlWriter. menyediakan XsltArgumentList argumen run-time tambahan.

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

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)

Parameter

input: IXPathNavigable

Objek yang IXPathNavigable mengimplementasikan antarmuka. Dalam Microsoft .NET Framework, ini dapat berupa XmlNode (biasanya XmlDocument), atau XPathDocument yang berisi data yang akan diubah.

arguments: XsltArgumentList

Berisi XsltArgumentList argumen yang memenuhi syarat namespace yang digunakan sebagai input ke transformasi. Nilai ini bisa berupa null.

results: XmlWriter

yang XmlWriter ingin Anda keluarkan.

Jika lembar gaya berisi xsl:output elemen, Anda harus membuat menggunakan objek yang XmlWriter XmlWriterSettings dikembalikan dari OutputSettings properti . Ini memastikan bahwa memiliki pengaturan output yang XmlWriter benar.

Pengecualian

ArgumentNullException

Nilai input atau results adalah null.

XsltException

Terjadi kesalahan saat menjalankan transformasi XSLT.

Keterangan

Jika fungsi XSLT document() diaktifkan, fungsi tersebut diselesaikan menggunakan XmlUrlResolver tanpa kredensial pengguna. Jika sumber daya eksternal terletak di sumber daya jaringan yang memerlukan autentikasi, gunakan kelebihan beban yang mengambil XmlResolver sebagai salah satu argumennya dan tentukan dengan kredensial yang XmlResolver diperlukan.

Metode ini tidak mendukung xsl:strip-space elemen . Jika lembar gaya yang dikompilasi menyertakan xsl:strip-space elemen , Anda harus menggunakan Transform kelebihan beban yang mengambil XmlReader sebagai argumen input.

Antarmuka IXPathNavigable diimplementasikan di XmlNode kelas dan XPathDocument . Kelas-kelas ini mewakili cache data XML dalam memori.

Kelas XmlNode ini didasarkan pada Model Objek Dokumen (DOM) W3C dan mencakup kemampuan pengeditan.
Kelas XPathDocument ini adalah penyimpanan data baca-saja berdasarkan model data XPath. XPathDocument adalah kelas yang direkomendasikan untuk pemrosesan XSLT. Ini memberikan performa yang lebih cepat dibandingkan dengan kelas XmlNode.

Transformasi berlaku untuk dokumen secara keseluruhan. Dengan kata lain, jika Anda memberikan simpul selain simpul akar dokumen, hal ini tidak akan mencegah proses transformasi mengakses semua simpul dalam dokumen yang telah dimuat. Untuk mengubah fragmen simpul, Anda harus membuat objek yang hanya berisi fragmen simpul, dan meneruskan objek tersebut ke Transform metode . Untuk informasi selengkapnya, silakan lihat Cara: Mengubah Fragmen Simpul.

Lihat juga

Menggunakan Kelas XslCompiledTransform

Berlaku untuk

Transform(IXPathNavigable, XsltArgumentList, TextWriter)

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Menjalankan transformasi menggunakan dokumen input yang ditentukan oleh IXPathNavigable objek dan menghasilkan hasilnya ke TextWriter. menyediakan XsltArgumentList argumen run-time tambahan.

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

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)

Parameter

input: IXPathNavigable

Objek yang IXPathNavigable mengimplementasikan antarmuka. Dalam Microsoft .NET Framework, ini dapat berupa XmlNode (biasanya XmlDocument), atau XPathDocument yang berisi data yang akan diubah.

arguments: XsltArgumentList

Berisi XsltArgumentList argumen yang memenuhi syarat namespace yang digunakan sebagai input ke transformasi. Nilai ini bisa berupa null.

results: TextWriter

yang TextWriter ingin Anda keluarkan.

Pengecualian

ArgumentNullException

Nilai input atau results adalah null.

XsltException

Terjadi kesalahan saat menjalankan transformasi XSLT.

Keterangan

Antarmuka IXPathNavigable diimplementasikan di XmlNode kelas dan XPathDocument . Kelas-kelas ini mewakili cache data XML dalam memori.

Kelas XmlNode ini didasarkan pada Model Objek Dokumen (DOM) W3C dan mencakup kemampuan pengeditan.
Kelas XPathDocument ini adalah penyimpanan data baca-saja berdasarkan model data XPath. XPathDocument adalah kelas yang direkomendasikan untuk pemrosesan XSLT. Ini memberikan performa yang lebih cepat dibandingkan dengan kelas XmlNode.

Lihat juga

Menggunakan Kelas XslCompiledTransform

Berlaku untuk

Transform(IXPathNavigable, XsltArgumentList, Stream)

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Menjalankan transformasi menggunakan dokumen input yang ditentukan oleh IXPathNavigable objek dan menghasilkan hasil ke aliran. menyediakan XsltArgumentList argumen runtime tambahan.

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

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)

Parameter

input: IXPathNavigable

Objek yang IXPathNavigable mengimplementasikan antarmuka. Dalam Microsoft .NET Framework, ini dapat berupa XmlNode (biasanya XmlDocument), atau XPathDocument yang berisi data yang akan diubah.

arguments: XsltArgumentList

Berisi XsltArgumentList argumen yang memenuhi syarat namespace yang digunakan sebagai input ke transformasi. Nilai ini bisa berupa null.

results: Stream

Aliran yang ingin Anda keluarkan.

Pengecualian

ArgumentNullException

Nilai input atau results adalah null.

XsltException

Terjadi kesalahan saat menjalankan transformasi XSLT.

Contoh

Contoh berikut menjalankan transformasi dan output XSLT ke 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

Keterangan

Antarmuka IXPathNavigable diimplementasikan di XmlNode kelas dan XPathDocument . Kelas-kelas ini mewakili cache data XML dalam memori.

Kelas XmlNode ini didasarkan pada Model Objek Dokumen (DOM) W3C dan mencakup kemampuan pengeditan.
Kelas XPathDocument ini adalah penyimpanan data baca-saja berdasarkan model data XPath. XPathDocument adalah kelas yang direkomendasikan untuk pemrosesan XSLT. Ini memberikan performa yang lebih cepat dibandingkan dengan kelas XmlNode.

Lihat juga

Menggunakan Kelas XslCompiledTransform

Berlaku untuk

Transform(XmlReader, XsltArgumentList, XmlWriter)

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Menjalankan transformasi menggunakan dokumen input yang ditentukan oleh XmlReader objek dan menghasilkan hasilnya ke XmlWriter. menyediakan XsltArgumentList argumen run-time tambahan.

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

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)

Parameter

input: XmlReader

Yang XmlReader berisi dokumen input.

arguments: XsltArgumentList

Berisi XsltArgumentList argumen yang memenuhi syarat namespace yang digunakan sebagai input ke transformasi. Nilai ini bisa berupa null.

results: XmlWriter

yang XmlWriter ingin Anda keluarkan.

Pengecualian

ArgumentNullException

Nilai input atau results adalah null.

XsltException

Terjadi kesalahan saat menjalankan transformasi XSLT.

Keterangan

Lihat juga

Menggunakan Kelas XslCompiledTransform

Berlaku untuk

Transform(XmlReader, XsltArgumentList, Stream)

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Menjalankan transformasi menggunakan dokumen input yang ditentukan oleh XmlReader objek dan menghasilkan hasil ke aliran. menyediakan XsltArgumentList argumen run-time tambahan.

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

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)

Parameter

input: XmlReader

Yang XmlReader berisi dokumen input.

arguments: XsltArgumentList

Berisi XsltArgumentList argumen yang memenuhi syarat namespace yang digunakan sebagai input ke transformasi. Nilai ini bisa berupa null.

results: Stream

Aliran yang ingin Anda keluarkan.

Pengecualian

ArgumentNullException

Nilai input atau results adalah null.

XsltException

Terjadi kesalahan saat menjalankan transformasi XSLT.

Keterangan

Lihat juga

Menggunakan Kelas XslCompiledTransform

Berlaku untuk

Transform(String, String)

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Menjalankan transformasi menggunakan dokumen input yang ditentukan oleh URI dan menghasilkan hasil ke 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)

Parameter

inputUri: String

URI dokumen input.

resultsFile: String

URI file output.

Pengecualian

ArgumentNullException

Nilai inputUri atau resultsFile adalah null.

XsltException

Terjadi kesalahan saat menjalankan transformasi XSLT.

FileNotFoundException

Dokumen input tidak dapat ditemukan.

DirectoryNotFoundException

Nilai inputUri atau resultsFile menyertakan nama file atau direktori tidak dapat ditemukan.

WebException

Nilai inputUri atau resultsFile tidak dapat diselesaikan.

-atau-

Terjadi kesalahan saat memproses permintaan.

UriFormatException

inputUri atau resultsFile bukan URI yang valid.

XmlException

Terjadi kesalahan penguraian saat memuat dokumen input.

Contoh

Contoh berikut menjalankan transformasi dan output ke 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")

Sampel menggunakan dua file input berikut:

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>

Keterangan

Metode ini menggunakan default XmlUrlResolver tanpa kredensial pengguna untuk menyelesaikan dokumen input dan output. Jika salah satu sumber daya ini terletak di sumber daya jaringan yang memerlukan autentikasi, gunakan kelebihan beban yang mengambil XmlResolver sebagai salah satu argumennya dan tentukan dengan kredensial yang XmlResolver diperlukan.

Dengan XmlReader pengaturan default digunakan untuk memuat dokumen input. Pemrosesan DTD dinonaktifkan pada XmlReader. Jika Anda memerlukan pemrosesan DTD, buat XmlReader dengan fitur ini diaktifkan, dan teruskan ke Transform metode .

Lihat juga

Menggunakan Kelas XslCompiledTransform

Berlaku untuk

Transform(String, XsltArgumentList, TextWriter)

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Menjalankan transformasi menggunakan dokumen input yang ditentukan oleh URI dan menghasilkan hasilnya ke 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);

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)

Parameter

inputUri: String

URI dokumen input.

arguments: XsltArgumentList

Berisi XsltArgumentList argumen yang memenuhi syarat namespace yang digunakan sebagai input ke transformasi. Nilai ini bisa berupa null.

results: TextWriter

yang TextWriter ingin Anda keluarkan.

Pengecualian

ArgumentNullException

Nilai inputUri atau results adalah null.

XsltException

Terjadi kesalahan saat menjalankan transformasi XSLT.

DirectoryNotFoundException

Nilai inputUri menyertakan nama file atau direktori tidak dapat ditemukan.

WebException

Nilai inputUri tidak dapat diselesaikan.

-atau-

Terjadi kesalahan saat memproses permintaan.

UriFormatException

inputUri bukan URI yang valid.

XmlException

Terjadi kesalahan penguraian saat memuat dokumen input.

Contoh

Contoh berikut menjalankan transformasi XSLT dan menghasilkan 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()

Keterangan

Metode ini menggunakan default XmlUrlResolver tanpa kredensial pengguna untuk menyelesaikan dokumen input dan instans fungsi XSLT document() apa pun yang ditemukan di lembar gaya. Jika salah satu sumber daya ini terletak di sumber daya jaringan yang memerlukan autentikasi, gunakan kelebihan beban yang mengambil XmlResolver sebagai salah satu argumennya dan tentukan dengan kredensial yang XmlResolver diperlukan.

Lihat juga

Menggunakan Kelas XslCompiledTransform

Berlaku untuk

Transform(String, XsltArgumentList, Stream)

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Menjalankan transformasi menggunakan dokumen input yang ditentukan oleh URI dan menghasilkan hasil untuk streaming. menyediakan XsltArgumentList argumen run-time tambahan.

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

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)

Parameter

inputUri: String

URI dokumen input.

arguments: XsltArgumentList

Berisi XsltArgumentList argumen yang memenuhi syarat namespace yang digunakan sebagai input ke transformasi. Nilai ini bisa berupa null.

results: Stream

Aliran yang ingin Anda keluarkan.

Pengecualian

ArgumentNullException

Nilai inputUri atau results adalah null.

XsltException

Terjadi kesalahan saat menjalankan transformasi XSLT.

DirectoryNotFoundException

Nilai inputUri menyertakan nama file atau direktori tidak dapat ditemukan.

WebException

Nilai inputUri tidak dapat diselesaikan.

-atau-

Terjadi kesalahan saat memproses permintaan.

UriFormatException

inputUri bukan URI yang valid.

XmlException

Terjadi kesalahan penguraian saat memuat dokumen input.

Keterangan

Lihat juga

Menggunakan Kelas XslCompiledTransform

Berlaku untuk

Transform(IXPathNavigable, XmlWriter)

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Menjalankan transformasi menggunakan dokumen input yang ditentukan oleh IXPathNavigable objek dan menghasilkan hasilnya ke 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)

Parameter

input: IXPathNavigable

Objek yang IXPathNavigable mengimplementasikan antarmuka. Dalam Microsoft .NET Framework, ini dapat berupa XmlNode (biasanya XmlDocument), atau XPathDocument yang berisi data yang akan diubah.

results: XmlWriter

yang XmlWriter ingin Anda keluarkan.

Pengecualian

ArgumentNullException

Nilai input atau results adalah null.

XsltException

Terjadi kesalahan saat menjalankan transformasi XSLT.

Contoh

Contoh berikut menjalankan transformasi dan output XSLT ke XmlWriter objek.

// 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()

Keterangan

Antarmuka IXPathNavigable diimplementasikan di XmlNode kelas dan XPathDocument . Kelas-kelas ini mewakili cache data XML dalam memori.

Kelas XmlNode ini didasarkan pada Model Objek Dokumen (DOM) W3C dan mencakup kemampuan pengeditan.
Kelas XPathDocument ini adalah penyimpanan data baca-saja berdasarkan model data XPath. XPathDocument adalah kelas yang direkomendasikan untuk pemrosesan XSLT. Ini memberikan performa yang lebih cepat dibandingkan dengan kelas XmlNode.

Lihat juga

Menggunakan Kelas XslCompiledTransform

Berlaku untuk

Transform(XmlReader, XmlWriter)

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Menjalankan transformasi menggunakan dokumen input yang ditentukan oleh XmlReader objek dan menghasilkan hasilnya ke 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)

Parameter

input: XmlReader

yang XmlReader berisi dokumen input.

results: XmlWriter

yang XmlWriter ingin Anda keluarkan.

Pengecualian

ArgumentNullException

Nilai input atau results adalah null.

XsltException

Terjadi kesalahan saat menjalankan transformasi XSLT.

Contoh

Contoh berikut mengubah buku pertama dalam file books.xml.

// 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()

Keterangan

Lihat juga

Menggunakan Kelas XslCompiledTransform

Berlaku untuk

Transform(String, XmlWriter)

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Menjalankan transformasi menggunakan dokumen input yang ditentukan oleh URI dan menghasilkan hasilnya ke 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)

Parameter

inputUri: String

URI dokumen input.

results: XmlWriter

yang XmlWriter ingin Anda keluarkan.

Pengecualian

ArgumentNullException

Nilai inputUri atau results adalah null.

XsltException

Terjadi kesalahan saat menjalankan transformasi XSLT.

DirectoryNotFoundException

Nilai inputUri menyertakan nama file atau direktori tidak dapat ditemukan.

WebException

Nilai inputUri tidak dapat diselesaikan.

-atau-

Terjadi kesalahan saat memproses permintaan.

UriFormatException

inputUri bukan URI yang valid.

XmlException

Terjadi kesalahan penguraian saat memuat dokumen input.

Contoh

Contoh berikut menjalankan transformasi dan output XSLT ke XmlWriter objek.

// 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()

Keterangan

Lihat juga

Menggunakan Kelas XslCompiledTransform

Berlaku untuk

Transform(XmlReader, XsltArgumentList, XmlWriter, XmlResolver)

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Menjalankan transformasi menggunakan dokumen input yang ditentukan oleh XmlReader objek dan menghasilkan hasilnya ke XmlWriter. XsltArgumentList menyediakan argumen run-time tambahan dan XmlResolver menyelesaikan fungsi XSLTdocument().

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

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)

Parameter

input: XmlReader

Yang XmlReader berisi dokumen input.

arguments: XsltArgumentList

Berisi XsltArgumentList argumen yang memenuhi syarat namespace yang digunakan sebagai input ke transformasi. Nilai ini bisa berupa null.

results: XmlWriter

yang XmlWriter ingin Anda keluarkan.

documentResolver: XmlResolver

yang XmlResolver digunakan untuk mengatasi fungsi XSLT document() . Jika ini adalah null, document() fungsi tidak diselesaikan.

Pengecualian

ArgumentNullException

Nilai input atau results adalah null.

XsltException

Terjadi kesalahan saat menjalankan transformasi XSLT.

Lihat juga

Menggunakan Kelas XslCompiledTransform

Berlaku untuk

Transform(String, XsltArgumentList, XmlWriter)

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Menjalankan transformasi menggunakan dokumen input yang ditentukan oleh URI dan menghasilkan hasilnya ke XmlWriter. menyediakan XsltArgumentList argumen run-time tambahan.

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

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)

Parameter

inputUri: String

URI dokumen input.

arguments: XsltArgumentList

Berisi XsltArgumentList argumen yang memenuhi syarat namespace yang digunakan sebagai input ke transformasi. Nilai ini bisa berupa null.

results: XmlWriter

yang XmlWriter ingin Anda keluarkan.

Pengecualian

ArgumentNullException

Nilai inputUri atau results adalah null.

XsltException

Terjadi kesalahan saat menjalankan transformasi XSLT.

DirectoryNotFoundException

Nilai inputUri menyertakan nama file atau direktori tidak dapat ditemukan.

WebException

Nilai inputUri tidak dapat diselesaikan.

-atau-

Terjadi kesalahan saat memproses permintaan.

UriFormatException

inputUri bukan URI yang valid.

XmlException

Terjadi kesalahan penguraian saat memuat dokumen input.

Contoh

Contoh berikut menggunakan XsltArgumentList objek untuk membuat parameter yang mewakili tanggal dan waktu saat ini.

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.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
End Class

Contohnya menggunakan dua file data berikut sebagai input.

order.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.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>

Keterangan

Lihat juga

Menggunakan Kelas XslCompiledTransform

Berlaku untuk

Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver)

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Sumber:: XslCompiledTransform.cs

Menjalankan transformasi dengan menggunakan dokumen input yang ditentukan oleh IXPathNavigable objek dan menghasilkan hasil ke XmlWriter. XsltArgumentList menyediakan argumen run-time tambahan dan XmlResolver menyelesaikan fungsi XSLTdocument().

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

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)

Parameter

input: IXPathNavigable

Dokumen untuk mengubah yang ditentukan oleh IXPathNavigable objek.

arguments: XsltArgumentList

Daftar argumen sebagai XsltArgumentList.

results: XmlWriter

yang XmlWriter ingin Anda keluarkan.

Jika lembar gaya berisi xsl:output elemen, Anda harus membuat XmlWriter dengan menggunakan XmlWriterSettings objek yang dikembalikan dari OutputSettings properti . Ini memastikan bahwa memiliki pengaturan output yang XmlWriter benar.

documentResolver: XmlResolver

yang XmlResolver digunakan untuk mengatasi fungsi XSLT document() . Jika ini adalah null, document() fungsi tidak diselesaikan.

Berlaku untuk

Saran dan Komentar

Apakah halaman ini membantu?