XslCompiledTransform.Transform Metódus

Definíció

Névtér:: System.Xml.Xsl

Szerelvény:: System.Xml.dll

Szerelvény:: netstandard.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Végrehajtja az XSLT-átalakítást.

Túlterhelések

Name	Description
Transform(XmlReader, XsltArgumentList, TextWriter)	Végrehajtja az átalakítást az objektum által XmlReader megadott bemeneti dokumentum használatával, és az eredményeket egy TextWriter. Ez XsltArgumentList további futásidejű argumentumokat biztosít.
Transform(IXPathNavigable, XsltArgumentList, XmlWriter)	Végrehajtja az átalakítást az objektum által IXPathNavigable megadott bemeneti dokumentum használatával, és az eredményeket egy XmlWriter. Ez XsltArgumentList további futásidejű argumentumokat biztosít.
Transform(IXPathNavigable, XsltArgumentList, TextWriter)	Végrehajtja az átalakítást az objektum által IXPathNavigable megadott bemeneti dokumentum használatával, és az eredményeket egy TextWriter. Ez XsltArgumentList további futásidejű argumentumokat biztosít.
Transform(IXPathNavigable, XsltArgumentList, Stream)	Végrehajtja az átalakítást az objektum által IXPathNavigable megadott bemeneti dokumentum használatával, és az eredményeket streambe adja ki. Ez XsltArgumentList további futtatókörnyezeti argumentumokat biztosít.
Transform(XmlReader, XsltArgumentList, XmlWriter)	Végrehajtja az átalakítást az objektum által XmlReader megadott bemeneti dokumentum használatával, és az eredményeket egy XmlWriter. Ez XsltArgumentList további futásidejű argumentumokat biztosít.
Transform(XmlReader, XsltArgumentList, Stream)	Végrehajtja az átalakítást az objektum által XmlReader megadott bemeneti dokumentum használatával, és az eredményeket streambe adja ki. Ez XsltArgumentList további futásidejű argumentumokat biztosít.
Transform(String, String)	Végrehajtja az átalakítást az URI által megadott bemeneti dokumentum használatával, és az eredményeket egy fájlba adja ki.
Transform(String, XsltArgumentList, TextWriter)	Végrehajtja az átalakítást az URI által megadott bemeneti dokumentum használatával, és az eredményeket egy TextWriter.
Transform(String, XsltArgumentList, Stream)	Végrehajtja az átalakítást az URI által megadott bemeneti dokumentum használatával, és az eredményeket streameli. Ez XsltArgumentList további futásidejű argumentumokat biztosít.
Transform(IXPathNavigable, XmlWriter)	Végrehajtja az átalakítást az objektum által IXPathNavigable megadott bemeneti dokumentum használatával, és az eredményeket egy XmlWriter.
Transform(XmlReader, XmlWriter)	Végrehajtja az átalakítást az objektum által XmlReader megadott bemeneti dokumentum használatával, és az eredményeket egy XmlWriter.
Transform(String, XmlWriter)	Végrehajtja az átalakítást az URI által megadott bemeneti dokumentum használatával, és az eredményeket egy XmlWriter.
Transform(XmlReader, XsltArgumentList, XmlWriter, XmlResolver)	Végrehajtja az átalakítást az objektum által XmlReader megadott bemeneti dokumentum használatával, és az eredményeket egy XmlWriter. Ez XsltArgumentList további futásidejű argumentumokat biztosít, és az XmlResolver feloldja az XSLT `document()` függvényt.
Transform(String, XsltArgumentList, XmlWriter)	Végrehajtja az átalakítást az URI által megadott bemeneti dokumentum használatával, és az eredményeket egy XmlWriter. Ez XsltArgumentList további futásidejű argumentumokat biztosít.
Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver)	Az átalakítást az objektum által IXPathNavigable megadott bemeneti dokumentum használatával hajtja végre, és az eredményeket egy XmlWriter. Ez XsltArgumentList további futásidejű argumentumokat biztosít, és feloldja az XmlResolver XSLT `document()` függvényt.

Megjegyzések

Note

A hibakeresési módban lefordított XSLT és a kiadási módban lefordított XSLT között különbségek vannak. Bizonyos esetekben a hibakeresési módban összeállított stíluslapok nem okoznak hibákatLoad, de később sikertelenek lesznek.Transform A kiadási módban lefordított stíluslap nem fog működni.Load Ilyen viselkedésre példa, ha egy nem csomópontkészlet típusú változót egy olyan kifejezéshez rendelnek, amelyben csomópontkészletre van szükség.

Transform(XmlReader, XsltArgumentList, TextWriter)

Végrehajtja az átalakítást az objektum által XmlReader megadott bemeneti dokumentum használatával, és az eredményeket egy TextWriter. Ez XsltArgumentList további futásidejű argumentumokat biztosít.

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)

Paraméterek

input: XmlReader

A XmlReader bemeneti dokumentumot tartalmazó dokumentum.

arguments: XsltArgumentList

Az XsltArgumentList átalakítás bemeneteként használt névtér-minősített argumentumokat tartalmazó argumentum. Ez az érték lehet null.

results: TextWriter

Az TextWriter a fájl, amelynek a kimenetét ki szeretné adni.

Kivételek

ArgumentNullException

Az input vagy results az érték.null

XsltException

Hiba történt az XSLT-átalakítás végrehajtása közben.

Megjegyzések

Ha a stíluslap tartalmaz egy XSLT-függvényt document() , a feloldás XmlUrlResolver felhasználói hitelesítő adatok nélkül történik. Ha a külső erőforrás olyan hálózati erőforráson található, amely hitelesítést igényel, használja a túlterhelést XmlResolver , amely az egyik argumentumát veszi igénybe, és adjon meg egy XmlResolver szükséges hitelesítő adatokat.

Lásd még

Az XslCompiledTransform osztály használata

A következőre érvényes:

Transform(IXPathNavigable, XsltArgumentList, XmlWriter)

Végrehajtja az átalakítást az objektum által IXPathNavigable megadott bemeneti dokumentum használatával, és az eredményeket egy XmlWriter. Ez XsltArgumentList további futásidejű argumentumokat biztosít.

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)

Paraméterek

input: IXPathNavigable

Az interfészt implementáló IXPathNavigable objektum. A Microsoft .NET-keretrendszerben ez lehet egy XmlNode (általában egy XmlDocument), vagy az átalakítandó adatokat tartalmazó XPathDocument.

arguments: XsltArgumentList

Az XsltArgumentList átalakítás bemeneteként használt névtér-minősített argumentumokat tartalmazó argumentum. Ez az érték lehet null.

results: XmlWriter

Az XmlWriter a fájl, amelynek a kimenetét ki szeretné adni.

Ha a stíluslap tartalmaz egy xsl:output elemet, akkor a XmlWriter tulajdonságból OutputSettings visszaadott objektumot XmlWriterSettings kell létrehoznia. Ez biztosítja, hogy a XmlWriter megfelelő kimeneti beállításokkal rendelkezik.

Kivételek

ArgumentNullException

Az input vagy results az érték.null

XsltException

Hiba történt az XSLT-átalakítás végrehajtása közben.

Megjegyzések

Ha az XSLT document() függvény engedélyezve van, a feloldás XmlUrlResolver felhasználói hitelesítő adatok nélkül történik. Ha a külső erőforrás olyan hálózati erőforráson található, amely hitelesítést igényel, használja a túlterhelést XmlResolver , amely az egyik argumentumát veszi igénybe, és adjon meg egy XmlResolver szükséges hitelesítő adatokat.

Ez a metódus nem támogatja az xsl:strip-space elemet. Ha a lefordított stíluslap tartalmazza az xsl:strip-space elemet, a Transform bemeneti argumentumként használt túlterhelést XmlReader kell használnia.

A IXPathNavigable felület a XmlNode és XPathDocument osztályokban van implementálva. Ezek az osztályok XML-adatok memórián belüli gyorsítótárát jelölik.

Az XmlNode osztály a W3C-dokumentumobjektum-modellen (DOM) alapul, és szerkesztési képességeket is tartalmaz.
Az XPathDocument osztály egy írásvédett adattár az XPath-adatmodell alapján. XPathDocument az XSLT-feldolgozás ajánlott osztálya. XmlNode osztályhoz képest gyorsabb teljesítményt nyújt.

Az átalakítások a dokumentum egészére vonatkoznak. Más szóval, ha a dokumentum gyökércsomópontjától eltérő csomópontot ad át, az nem akadályozza meg, hogy az átalakítási folyamat hozzáférjen a betöltött dokumentum összes csomópontjának eléréséhez. Csomóponttöredék átalakításához létre kell hoznia egy olyan objektumot, amely csak a csomóponttöredéket tartalmazza, és át kell adnia az objektumot a Transform metódusnak. További információkért lásd Hogyan: Csomóponttöredék átalakítása.

Lásd még

Az XslCompiledTransform osztály használata

A következőre érvényes:

Transform(IXPathNavigable, XsltArgumentList, TextWriter)

Végrehajtja az átalakítást az objektum által IXPathNavigable megadott bemeneti dokumentum használatával, és az eredményeket egy TextWriter. Ez XsltArgumentList további futásidejű argumentumokat biztosít.

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)

Paraméterek

input: IXPathNavigable

arguments: XsltArgumentList

Az XsltArgumentList átalakítás bemeneteként használt névtér-minősített argumentumokat tartalmazó argumentum. Ez az érték lehet null.

results: TextWriter

Az TextWriter a fájl, amelynek a kimenetét ki szeretné adni.

Kivételek

ArgumentNullException

Az input vagy results az érték.null

XsltException

Hiba történt az XSLT-átalakítás végrehajtása közben.

Megjegyzések

A IXPathNavigable felület a XmlNode és XPathDocument osztályokban van implementálva. Ezek az osztályok XML-adatok memórián belüli gyorsítótárát jelölik.

Az XmlNode osztály a W3C-dokumentumobjektum-modellen (DOM) alapul, és szerkesztési képességeket is tartalmaz.
Az XPathDocument osztály egy írásvédett adattár az XPath-adatmodell alapján. XPathDocument az XSLT-feldolgozás ajánlott osztálya. XmlNode osztályhoz képest gyorsabb teljesítményt nyújt.

Lásd még

Az XslCompiledTransform osztály használata

A következőre érvényes:

Transform(IXPathNavigable, XsltArgumentList, Stream)

Végrehajtja az átalakítást az objektum által IXPathNavigable megadott bemeneti dokumentum használatával, és az eredményeket streambe adja ki. Ez XsltArgumentList további futtatókörnyezeti argumentumokat biztosít.

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)

Paraméterek

input: IXPathNavigable

arguments: XsltArgumentList

Az XsltArgumentList átalakítás bemeneteként használt névtér-minősített argumentumokat tartalmazó argumentum. Ez az érték lehet null.

results: Stream

Az a stream, amelynek a kimenetét ki szeretné adni.

Kivételek

ArgumentNullException

Az input vagy results az érték.null

XsltException

Hiba történt az XSLT-átalakítás végrehajtása közben.

Példák

Az alábbi példa egy XSLT-átalakítást hajt végre, és kimeneteket ad egy 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

Megjegyzések

A IXPathNavigable felület a XmlNode és XPathDocument osztályokban van implementálva. Ezek az osztályok XML-adatok memórián belüli gyorsítótárát jelölik.

Az XmlNode osztály a W3C-dokumentumobjektum-modellen (DOM) alapul, és szerkesztési képességeket is tartalmaz.
Az XPathDocument osztály egy írásvédett adattár az XPath-adatmodell alapján. XPathDocument az XSLT-feldolgozás ajánlott osztálya. XmlNode osztályhoz képest gyorsabb teljesítményt nyújt.

Lásd még

Az XslCompiledTransform osztály használata

A következőre érvényes:

Transform(XmlReader, XsltArgumentList, XmlWriter)

Végrehajtja az átalakítást az objektum által XmlReader megadott bemeneti dokumentum használatával, és az eredményeket egy XmlWriter. Ez XsltArgumentList további futásidejű argumentumokat biztosít.

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)

Paraméterek

input: XmlReader

A XmlReader bemeneti dokumentumot tartalmazó dokumentum.

arguments: XsltArgumentList

Az XsltArgumentList átalakítás bemeneteként használt névtér-minősített argumentumokat tartalmazó argumentum. Ez az érték lehet null.

results: XmlWriter

Az XmlWriter a fájl, amelynek a kimenetét ki szeretné adni.

Kivételek

ArgumentNullException

Az input vagy results az érték.null

XsltException

Hiba történt az XSLT-átalakítás végrehajtása közben.

Megjegyzések

Lásd még

Az XslCompiledTransform osztály használata

A következőre érvényes:

Transform(XmlReader, XsltArgumentList, Stream)

Végrehajtja az átalakítást az objektum által XmlReader megadott bemeneti dokumentum használatával, és az eredményeket streambe adja ki. Ez XsltArgumentList további futásidejű argumentumokat biztosít.

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)

Paraméterek

input: XmlReader

A XmlReader bemeneti dokumentumot tartalmazó dokumentum.

arguments: XsltArgumentList

Az XsltArgumentList átalakítás bemeneteként használt névtér-minősített argumentumokat tartalmazó argumentum. Ez az érték lehet null.

results: Stream

Az a stream, amelynek a kimenetét ki szeretné adni.

Kivételek

ArgumentNullException

Az input vagy results az érték.null

XsltException

Hiba történt az XSLT-átalakítás végrehajtása közben.

Megjegyzések

Lásd még

Az XslCompiledTransform osztály használata

A következőre érvényes:

Transform(String, String)

Végrehajtja az átalakítást az URI által megadott bemeneti dokumentum használatával, és az eredményeket egy fájlba adja ki.

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)

Paraméterek

inputUri: String

A bemeneti dokumentum URI-ja.

resultsFile: String

A kimeneti fájl URI-ja.

Kivételek

ArgumentNullException

Az inputUri vagy resultsFile az érték.null

XsltException

Hiba történt az XSLT-átalakítás végrehajtása közben.

FileNotFoundException

A bemeneti dokumentum nem található.

DirectoryNotFoundException

Az inputUri vagy resultsFile az érték fájlnevet vagy könyvtárat tartalmaz, nem található.

WebException

A inputUri vagy resultsFile az érték nem oldható fel.

-vagy-

Hiba történt a kérés feldolgozása során.

UriFormatException

inputUri vagy resultsFile nem érvényes URI.

XmlException

Elemzési hiba történt a bemeneti dokumentum betöltésekor.

Példák

Az alábbi példa egy fájl átalakítását és kimenetét hajtja végre.

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

A minta a következő két bemeneti fájlt használja:

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>

Megjegyzések

Ez a metódus a bemeneti és kimeneti dokumentumok feloldásához egy alapértelmezett, felhasználói hitelesítő adatok nélküli beállítást XmlUrlResolver használ. Ha ezen erőforrások bármelyike olyan hálózati erőforráson található, amely hitelesítést igényel, használja a túlterhelést XmlResolver , amely az egyik argumentumát veszi igénybe, és adjon meg egy, a szükséges hitelesítő adatokat tartalmazó erőforrást XmlResolver .

A XmlReader bemeneti dokumentum betöltése alapértelmezett beállításokkal történik. A DTD-feldolgozás le van tiltva a XmlReader. Ha DTD-feldolgozásra van szüksége, hozzon létre egy XmlReader olyan szolgáltatást, amely engedélyezve van ezzel a funkcióval, és adja át a Transform metódusnak.

Lásd még

Az XslCompiledTransform osztály használata

A következőre érvényes:

Transform(String, XsltArgumentList, TextWriter)

Végrehajtja az átalakítást az URI által megadott bemeneti dokumentum használatával, és az eredményeket egy 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)

Paraméterek

inputUri: String

A bemeneti dokumentum URI-ja.

arguments: XsltArgumentList

Az XsltArgumentList átalakítás bemeneteként használt névtér-minősített argumentumokat tartalmazó argumentum. Ez az érték lehet null.

results: TextWriter

Az TextWriter a fájl, amelynek a kimenetét ki szeretné adni.

Kivételek

ArgumentNullException

Az inputUri vagy results az érték.null

XsltException

Hiba történt az XSLT-átalakítás végrehajtása közben.

DirectoryNotFoundException

Az inputUri érték fájlnevet vagy könyvtárat tartalmaz.

WebException

Az inputUri érték nem oldható fel.

-vagy-

Hiba történt a kérés feldolgozása során.

UriFormatException

inputUri nem érvényes URI.

XmlException

Elemzési hiba történt a bemeneti dokumentum betöltésekor.

Példák

Az alábbi példa egy XSLT-átalakítást hajt végre, és egy sztringet ad ki.

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

Megjegyzések

Ez a metódus a bemeneti dokumentum és a stíluslapon található XSLT document() függvény példányainak feloldásához alapértelmezett XmlUrlResolver felhasználói hitelesítő adatokkal rendelkezik. Ha ezen erőforrások bármelyike olyan hálózati erőforráson található, amely hitelesítést igényel, használja a túlterhelést XmlResolver , amely az egyik argumentumát veszi igénybe, és adjon meg egy, a szükséges hitelesítő adatokat tartalmazó erőforrást XmlResolver .

Lásd még

Az XslCompiledTransform osztály használata

A következőre érvényes:

Transform(String, XsltArgumentList, Stream)

Végrehajtja az átalakítást az URI által megadott bemeneti dokumentum használatával, és az eredményeket streameli. Ez XsltArgumentList további futásidejű argumentumokat biztosít.

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)

Paraméterek

inputUri: String

A bemeneti dokumentum URI-ja.

arguments: XsltArgumentList

Az XsltArgumentList átalakítás bemeneteként használt névtér-minősített argumentumokat tartalmazó argumentum. Ez az érték lehet null.

results: Stream

Az a stream, amelynek a kimenetét ki szeretné adni.

Kivételek

ArgumentNullException

Az inputUri vagy results az érték.null

XsltException

Hiba történt az XSLT-átalakítás végrehajtása közben.

DirectoryNotFoundException

Az inputUri érték fájlnevet vagy könyvtárat tartalmaz.

WebException

Az inputUri érték nem oldható fel.

-vagy-

Hiba történt a kérés feldolgozása során.

UriFormatException

inputUri nem érvényes URI.

XmlException

Elemzési hiba történt a bemeneti dokumentum betöltésekor.

Megjegyzések

Lásd még

Az XslCompiledTransform osztály használata

A következőre érvényes:

Transform(IXPathNavigable, XmlWriter)

Végrehajtja az átalakítást az objektum által IXPathNavigable megadott bemeneti dokumentum használatával, és az eredményeket egy 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)

Paraméterek

input: IXPathNavigable

results: XmlWriter

Az XmlWriter a fájl, amelynek a kimenetét ki szeretné adni.

Kivételek

ArgumentNullException

Az input vagy results az érték.null

XsltException

Hiba történt az XSLT-átalakítás végrehajtása közben.

Példák

Az alábbi példa egy XSLT-átalakítást hajt végre, és kimeneteket ad ki egy XmlWriter objektumnak.

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

Megjegyzések

A IXPathNavigable felület a XmlNode és XPathDocument osztályokban van implementálva. Ezek az osztályok XML-adatok memórián belüli gyorsítótárát jelölik.

Az XmlNode osztály a W3C-dokumentumobjektum-modellen (DOM) alapul, és szerkesztési képességeket is tartalmaz.
Az XPathDocument osztály egy írásvédett adattár az XPath-adatmodell alapján. XPathDocument az XSLT-feldolgozás ajánlott osztálya. XmlNode osztályhoz képest gyorsabb teljesítményt nyújt.

Lásd még

Az XslCompiledTransform osztály használata

A következőre érvényes:

Transform(XmlReader, XmlWriter)

Végrehajtja az átalakítást az objektum által XmlReader megadott bemeneti dokumentum használatával, és az eredményeket egy 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)

Paraméterek

input: XmlReader

A XmlReader bemeneti dokumentumot tartalmazó dokumentum.

results: XmlWriter

Az XmlWriter a fájl, amelynek a kimenetét ki szeretné adni.

Kivételek

ArgumentNullException

Az input vagy results az érték.null

XsltException

Hiba történt az XSLT-átalakítás végrehajtása közben.

Példák

Az alábbi példa a books.xml fájl első könyvét alakítja át.

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

Megjegyzések

Lásd még

Az XslCompiledTransform osztály használata

A következőre érvényes:

Transform(String, XmlWriter)

Végrehajtja az átalakítást az URI által megadott bemeneti dokumentum használatával, és az eredményeket egy 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)

Paraméterek

inputUri: String

A bemeneti dokumentum URI-ja.

results: XmlWriter

Az XmlWriter a fájl, amelynek a kimenetét ki szeretné adni.

Kivételek

ArgumentNullException

Az inputUri vagy results az érték.null

XsltException

Hiba történt az XSLT-átalakítás végrehajtása közben.

DirectoryNotFoundException

Az inputUri érték fájlnevet vagy könyvtárat tartalmaz.

WebException

Az inputUri érték nem oldható fel.

-vagy-

Hiba történt a kérés feldolgozása során.

UriFormatException

inputUri nem érvényes URI.

XmlException

Elemzési hiba történt a bemeneti dokumentum betöltésekor.

Példák

Az alábbi példa egy XSLT-átalakítást hajt végre, és kimeneteket ad ki egy XmlWriter objektumnak.

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

Megjegyzések

Lásd még

Az XslCompiledTransform osztály használata

A következőre érvényes:

Transform(XmlReader, XsltArgumentList, XmlWriter, XmlResolver)

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)

Paraméterek

input: XmlReader

A XmlReader bemeneti dokumentumot tartalmazó dokumentum.

arguments: XsltArgumentList

Az XsltArgumentList átalakítás bemeneteként használt névtér-minősített argumentumokat tartalmazó argumentum. Ez az érték lehet null.

results: XmlWriter

Az XmlWriter a fájl, amelynek a kimenetét ki szeretné adni.

documentResolver: XmlResolver

Az XmlResolver XSLT document() függvény feloldásához használt. Ha ez az null, a document() függvény nem lesz feloldva.

Kivételek

ArgumentNullException

Az input vagy results az érték.null

XsltException

Hiba történt az XSLT-átalakítás végrehajtása közben.

Példák

Az alábbi példa egy XmlSecureResolver XSLT-függvényt document() használ.

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

Lásd még

Az XslCompiledTransform osztály használata

A következőre érvényes:

Transform(String, XsltArgumentList, XmlWriter)

Végrehajtja az átalakítást az URI által megadott bemeneti dokumentum használatával, és az eredményeket egy XmlWriter. Ez XsltArgumentList további futásidejű argumentumokat biztosít.

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)

Paraméterek

inputUri: String

A bemeneti dokumentum URI-ja.

arguments: XsltArgumentList

Az XsltArgumentList átalakítás bemeneteként használt névtér-minősített argumentumokat tartalmazó argumentum. Ez az érték lehet null.

results: XmlWriter

Az XmlWriter a fájl, amelynek a kimenetét ki szeretné adni.

Kivételek

ArgumentNullException

Az inputUri vagy results az érték.null

XsltException

Hiba történt az XSLT-átalakítás végrehajtása közben.

DirectoryNotFoundException

Az inputUri érték fájlnevet vagy könyvtárat tartalmaz.

WebException

Az inputUri érték nem oldható fel.

-vagy-

Hiba történt a kérés feldolgozása során.

UriFormatException

inputUri nem érvényes URI.

XmlException

Elemzési hiba történt a bemeneti dokumentum betöltésekor.

Példák

Az alábbi példa egy XsltArgumentList objektumot használ az aktuális dátumot és időt képviselő paraméter létrehozásához.

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

A példa a következő két adatfájlt használja bemenetként.

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>

Megjegyzések

Lásd még

Az XslCompiledTransform osztály használata

A következőre érvényes:

Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver)

Az átalakítást az objektum által IXPathNavigable megadott bemeneti dokumentum használatával hajtja végre, és az eredményeket egy XmlWriter. Ez XsltArgumentList további futásidejű argumentumokat biztosít, és feloldja az XmlResolver XSLT document() függvényt.

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)

Paraméterek

input: IXPathNavigable

Az objektum által IXPathNavigable megadott átalakítandó dokumentum.

arguments: XsltArgumentList

Argumentumlista a következőként XsltArgumentList: .

results: XmlWriter

Az XmlWriter a fájl, amelynek a kimenetét ki szeretné adni.

Ha a stíluslap tartalmaz egy xsl:output elemet, a XmlWriter tulajdonságból visszaadott objektummal XmlWriterSettings kell létrehoznia azt OutputSettings . Ez biztosítja, hogy a XmlWriter megfelelő kimeneti beállításokkal rendelkezik.

documentResolver: XmlResolver

Az XmlResolver XSLT document() függvény feloldásához használt. Ha ez az null, a document() függvény nem lesz feloldva.

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?