XslCompiledTransform.Load Metódus

Definíció

Névtér:

System.Xml.Xsl

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Lefordítja a stíluslapot.

Túlterhelések

Név	Description
Load(IXPathNavigable, XsltSettings, XmlResolver)	A az XSLT stíluslapját fordítja le.IXPathNavigable A XmlResolver megoldás feloldja az XSLT-t import vagy include -elemeket, és az XSLT-beállítások határozzák meg a stíluslap engedélyeit.
Load(String, XsltSettings, XmlResolver)	Betölti és lefordítja az URI által megadott XSLT stíluslapot. A XmlResolver megoldás feloldja az XSLT-t import vagy include -elemeket, és az XSLT-beállítások határozzák meg a stíluslap engedélyeit.
Load(MethodInfo, Byte[], Type[])	Betölt egy metódust a segédprogrammal XSLTC.exe lefordított stíluslapról.
Load(XmlReader, XsltSettings, XmlResolver)	A az XSLT stíluslapját fordítja le.XmlReader A XmlResolver megoldás feloldja az XSLT-t import vagy include -elemeket, és az XSLT-beállítások határozzák meg a stíluslap engedélyeit.
Load(XmlReader)	A stíluslap fordítása a XmlReader.
Load(Type)	Betölti az XSLT Fordítóval (xsltc.exe) létrehozott lefordított stíluslapot.
Load(String)	Betölti és lefordítja a megadott URI-n található stíluslapot.
Load(IXPathNavigable)	Lefordítja az objektumban IXPathNavigable található stíluslapot.

Megjegyzések

Bár az XslCompiledTransform osztály általános teljesítménye jobb, mint az XslTransform osztály, az LoadXslCompiledTransform osztály metódusa lassabban teljesíthet, mint az LoadXslTransform osztály metódusa, amikor először meghívják egy átalakításra. Ennek az az oka, hogy az XSLT-fájlt a betöltés előtt le kell fordítani. További információt a következő blogbejegyzésben talál: XslCompiledTransform Slower than XslTransform?

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.

Load(IXPathNavigable, XsltSettings, XmlResolver)

Forrás:

XslCompiledTransform.cs

A az XSLT stíluslapját fordítja le.IXPathNavigable A XmlResolver megoldás feloldja az XSLT-t import vagy include -elemeket, és az XSLT-beállítások határozzák meg a stíluslap engedélyeit.

public:
 void Load(System::Xml::XPath::IXPathNavigable ^ stylesheet, System::Xml::Xsl::XsltSettings ^ settings, System::Xml::XmlResolver ^ stylesheetResolver);

public void Load(System.Xml.XPath.IXPathNavigable stylesheet, System.Xml.Xsl.XsltSettings? settings, System.Xml.XmlResolver? stylesheetResolver);

member this.Load : System.Xml.XPath.IXPathNavigable * System.Xml.Xsl.XsltSettings * System.Xml.XmlResolver -> unit

Public Sub Load (stylesheet As IXPathNavigable, settings As XsltSettings, stylesheetResolver As XmlResolver)

Paraméterek

stylesheet

IXPathNavigable

Az interfészt implementáló IXPathNavigable objektum. A Microsoft .NET keretrendszerben ez lehet egy XmlNode (általában egy XmlDocument), vagy egy XPathDocument, amely tartalmazza a stíluslapot.

settings

XsltSettings

A XsltSettings stíluslapra alkalmazni kívánt érték. Ha ez a nullbeállítás, a rendszer alkalmazza a Default beállítást.

stylesheetResolver

XmlResolver

Az XmlResolver XSLT-ben import és include az elemekben hivatkozott stíluslapok feloldására szolgál. Ebben az esetben a nullkülső erőforrások nem lesznek feloldva.

Kivételek

ArgumentNullException

Az stylesheet érték a következő null: .

XsltException

A stíluslap hibát tartalmaz.

Megjegyzések

Az XslCompiledTransform osztály támogatja az XSLT 1.0 szintaxist. Az XSLT stíluslapnak a névteret http://www.w3.org/1999/XSL/Transform kell használnia.

Lásd még

• Az XslCompiledTransform osztály használata

Load(String, XsltSettings, XmlResolver)

Forrás:

XslCompiledTransform.cs

Betölti és lefordítja az URI által megadott XSLT stíluslapot. A XmlResolver megoldás feloldja az XSLT-t import vagy include -elemeket, és az XSLT-beállítások határozzák meg a stíluslap engedélyeit.

public:
 void Load(System::String ^ stylesheetUri, System::Xml::Xsl::XsltSettings ^ settings, System::Xml::XmlResolver ^ stylesheetResolver);

public void Load(string stylesheetUri, System.Xml.Xsl.XsltSettings? settings, System.Xml.XmlResolver? stylesheetResolver);

member this.Load : string * System.Xml.Xsl.XsltSettings * System.Xml.XmlResolver -> unit

Public Sub Load (stylesheetUri As String, settings As XsltSettings, stylesheetResolver As XmlResolver)

Paraméterek

stylesheetUri

String

A stíluslap URI-ja.

settings

XsltSettings

A XsltSettings stíluslapra alkalmazni kívánt érték. Ha ez a nullbeállítás, a rendszer alkalmazza a Default beállítást.

stylesheetResolver

XmlResolver

A XmlResolver stíluslap URI-jának és az XSLT-ben import és include az elemekben hivatkozott stíluslapok feloldására szolgál.

Kivételek

ArgumentNullException

Az stylesheetUri vagy stylesheetResolver az érték.null

XsltException

A stíluslap hibát tartalmaz.

FileNotFoundException

A stíluslap nem található.

DirectoryNotFoundException

Az stylesheetUri érték olyan fájlnevet vagy könyvtárat tartalmaz, amely nem található.

WebException

Az stylesheetUri érték nem oldható fel.

-vagy-

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

UriFormatException

stylesheetUri nem érvényes URI.

XmlException

Elemzési hiba történt a stíluslap betöltésekor.

Megjegyzések

Az XslCompiledTransform osztály támogatja az XSLT 1.0 szintaxist. Az XSLT stíluslapnak a névteret http://www.w3.org/1999/XSL/Transform kell használnia.

A XmlReader stíluslap 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 Load metódusnak.

Lásd még

• Az XslCompiledTransform osztály használata

Load(MethodInfo, Byte[], Type[])

Forrás:

XslCompiledTransform.cs

Betölt egy metódust a segédprogrammal XSLTC.exe lefordított stíluslapról.

public:
 void Load(System::Reflection::MethodInfo ^ executeMethod, cli::array <System::Byte> ^ queryData, cli::array <Type ^> ^ earlyBoundTypes);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("This method will call into constructors of the earlyBoundTypes array which cannot be statically analyzed.")]
public void Load(System.Reflection.MethodInfo executeMethod, byte[] queryData, Type[]? earlyBoundTypes);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("This method will call into constructors of the earlyBoundTypes array which cannot be statically analyzed.")>]
member this.Load : System.Reflection.MethodInfo * byte[] * Type[] -> unit

Public Sub Load (executeMethod As MethodInfo, queryData As Byte(), earlyBoundTypes As Type())

Paraméterek

executeMethod

MethodInfo

A MethodInfo lefordított execute stíluslap fordító által létrehozott metódusát képviselő objektum.

queryData

Byte[]

Szerializált adatstruktúrák bájttömbje a staticData lefordított stíluslap mezőjében a CompileToType(XmlReader, XsltSettings, XmlResolver, Boolean, TypeBuilder, String) metódus által generált módon.

earlyBoundTypes

Type[]

A lefordított stíluslap fordító által létrehozott ebTypes mezőjében tárolt típusok tömbje.

Attribútumok

RequiresUnreferencedCodeAttribute

Példák

Az alábbi kód példa egy Load lefordított stíluslap betöltésére szolgál. Az átalakítás tíz százalékkal csökkenti az Price elem értékét.

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

class Example
{
    static void Main()
    {
        // Load a stylesheet compiled using the XSLTC.EXE utility
        Type compiledStylesheet = Assembly.Load("Transform").GetType("Transform");

        // Extract private members from the compiled stylesheet
        BindingFlags bindingFlags = BindingFlags.NonPublic | BindingFlags.Static;
        MethodInfo executeMethod = compiledStylesheet.GetMethod("Execute", bindingFlags);
        object staticData = compiledStylesheet.GetField("staticData", bindingFlags).GetValue(null);
        object earlyBoundTypes = compiledStylesheet.GetField("ebTypes", bindingFlags).GetValue(null);

        // Load into XslCompiledTransform
        XslCompiledTransform xslt = new XslCompiledTransform();
        xslt.Load(executeMethod, (byte[])staticData, (Type[])earlyBoundTypes);

        // Run the transformation
        xslt.Transform(XmlReader.Create(new StringReader("<Root><Price>9.50</Price></Root>")), (XsltArgumentList)null, Console.Out);
    }
}

Imports System.IO
Imports System.Reflection
Imports System.Xml
Imports System.Xml.Xsl

Module Module1

    Sub Main()
        ' Load a stylesheet compiled using the XSLTC.EXE utility
        Dim compiledStylesheet As Type = [Assembly].Load("Transform").GetType("Transform")

        ' Extract private members from the compiled stylesheet
        Dim bindingFlags As BindingFlags = bindingFlags.NonPublic Or bindingFlags.Static
        Dim executeMethod As MethodInfo = compiledStylesheet.GetMethod("Execute", bindingFlags)
        Dim staticData As Object = compiledStylesheet.GetField("staticData", bindingFlags).GetValue(Nothing)
        Dim earlyBoundTypes As Object = compiledStylesheet.GetField("ebTypes", bindingFlags).GetValue(Nothing)

        ' Load into XslCompiledTransform
        Dim xslt As New XslCompiledTransform()
        xslt.Load(executeMethod, CType(staticData, Byte()), CType(earlyBoundTypes, Type()))

        ' Run the transformation
        xslt.Transform(XmlReader.Create(New StringReader("<Root><Price>9.50</Price></Root>")), CType(Nothing, XsltArgumentList), Console.Out)
    End Sub
End Module

Note

A példában használt "Átalakítás" szerelvény a xsltc.exe segédprogrammal készült. A parancssori eszköz használatával kapcsolatos részletes információkért lásd: XSLT-átalakítás végrehajtása szerelvény használatával.

Az előző példakód a következő átalakítást használja:

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
  xmlns:msxsl="urn:schemas-microsoft-com:xslt"
  xmlns:user="urn:my-scripts">
  <msxsl:script language="C#" implements-prefix="user">
    <![CDATA[
  public double modifyPrice(double price){
    price*=0.9;
    return price;
  }
  ]]>
  </msxsl:script>
  <xsl:template match="Root">
    <Root xmlns="">
      <Price><xsl:value-of select="user:modifyPrice(Price)"/></Price>
    </Root>
  </xsl:template>
</xsl:stylesheet>

Megjegyzések

Ez a metódus egy lefordított stíluslapot fogad el objektum, bájttömb és típustömb formájában MethodInfo . DynamicMethod objektumokkal engedélyezheti a lefordított stíluslap metódusainak elvetét az XslCompiledTransform objektum visszaigénylésekor.

Load(XmlReader, XsltSettings, XmlResolver)

Forrás:

XslCompiledTransform.cs

A az XSLT stíluslapját fordítja le.XmlReader A XmlResolver megoldás feloldja az XSLT-t import vagy include -elemeket, és az XSLT-beállítások határozzák meg a stíluslap engedélyeit.

public:
 void Load(System::Xml::XmlReader ^ stylesheet, System::Xml::Xsl::XsltSettings ^ settings, System::Xml::XmlResolver ^ stylesheetResolver);

public void Load(System.Xml.XmlReader stylesheet, System.Xml.Xsl.XsltSettings? settings, System.Xml.XmlResolver? stylesheetResolver);

member this.Load : System.Xml.XmlReader * System.Xml.Xsl.XsltSettings * System.Xml.XmlResolver -> unit

Public Sub Load (stylesheet As XmlReader, settings As XsltSettings, stylesheetResolver As XmlResolver)

Paraméterek

stylesheet

XmlReader

A XmlReader stíluslapot tartalmazó lap.

settings

XsltSettings

A XsltSettings stíluslapra alkalmazni kívánt érték. Ha ez a nullbeállítás, a rendszer alkalmazza a Default beállítást.

stylesheetResolver

XmlResolver

Az XmlResolver XSLT-ben import és include az elemekben hivatkozott stíluslapok feloldására szolgál. Ebben az esetben a nullkülső erőforrások nem lesznek feloldva.

Kivételek

ArgumentNullException

Az stylesheet érték a következő null: .

XsltException

A stíluslap hibát tartalmaz.

Példák

Az alábbi példa betölt egy stíluslapot, és engedélyezi az XSLT-szkriptek támogatását.

// Create the XslCompiledTransform object.
XslCompiledTransform xslt = new XslCompiledTransform();

// Create a resolver and set the credentials to use.
XmlSecureResolver resolver = new XmlSecureResolver(new XmlUrlResolver(), "http://serverName/data/");
resolver.Credentials = CredentialCache.DefaultCredentials;

XmlReader reader = XmlReader.Create("http://serverName/data/xsl/sort.xsl");

// Create the XsltSettings object with script enabled.
XsltSettings settings = new XsltSettings(false,true);

// Load the style sheet.
xslt.Load(reader, settings, resolver);

' Create the XslCompiledTransform object.
Dim xslt As New XslCompiledTransform()
        
' Create a resolver and set the credentials to use.
Dim resolver As New XmlSecureResolver(New XmlUrlResolver(), "http://serverName/data/")
resolver.Credentials = CredentialCache.DefaultCredentials
        
Dim reader As XmlReader = XmlReader.Create("http://serverName/data/xsl/sort.xsl")
        
' Create the XsltSettings object with script enabled.
Dim settings As New XsltSettings(False, True)
        
' Load the style sheet.
xslt.Load(reader, settings, resolver)

Megjegyzések

Az XslCompiledTransform osztály támogatja az XSLT 1.0 szintaxist. Az XSLT stíluslapnak a névteret http://www.w3.org/1999/XSL/Transform kell használnia.

A stíluslap az összes gyermek aktuális csomópontjáról XmlReader betöltődik. Ez lehetővé teszi, hogy a dokumentum egy részét stíluslapként használja. Load A metódus befejezése után a XmlReader stíluslap vége után a következő csomóponton lesz elhelyezve. Ha elérjük a dokumentum végét, a XmlReader a fájl végére (EOF) kerül.

Lásd még

• Az XslCompiledTransform osztály használata

Load(XmlReader)

Forrás:

XslCompiledTransform.cs

A stíluslap fordítása a XmlReader.

public:
 void Load(System::Xml::XmlReader ^ stylesheet);

public void Load(System.Xml.XmlReader stylesheet);

member this.Load : System.Xml.XmlReader -> unit

Public Sub Load (stylesheet As XmlReader)

Paraméterek

stylesheet

XmlReader

A XmlReader stíluslapot tartalmazó lap.

Kivételek

ArgumentNullException

Az stylesheet érték a következő null: .

XsltException

A stíluslap hibát tartalmaz.

Példák

Az alábbi példa betölt egy objektumban XmlReader található stíluslapot.

// Create a reader that contains the style sheet.
XmlReader reader = XmlReader.Create("titles.xsl");
reader.ReadToDescendant("xsl:stylesheet");

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

' Create a reader that contains the style sheet.
Dim reader As XmlReader = XmlReader.Create("titles.xsl")
reader.ReadToDescendant("xsl:stylesheet")
        
' Load the style sheet.
Dim xslt As New XslCompiledTransform()
xslt.Load(reader)

Megjegyzések

Az XslCompiledTransform osztály támogatja az XSLT 1.0 szintaxist. Az XSLT stíluslapnak a névteret http://www.w3.org/1999/XSL/Transform kell használnia.

A stíluslap az összes gyermek aktuális csomópontjáról XmlReader betöltődik. Ez lehetővé teszi, hogy a dokumentum egy részét stíluslapként használja. Load A metódus befejezése után a XmlReader stíluslap vége után a következő csomóponton lesz elhelyezve. Ha elérjük a dokumentum végét, a XmlReader a fájl végére (EOF) kerül.

Ez a módszer a következő viselkedést követi:

• A XmlUrlResolver felhasználói hitelesítő adatokkal nem rendelkező felhasználók bármelyikének xsl:import vagy xsl:include elemeinek feldolgozására szolgálnak.

• A document() függvény le van tiltva.

• A beágyazott szkriptek nem támogatottak.

A túlterheléssel megadhatja Load(XmlReader, XsltSettings, XmlResolver) a XmlResolver szükséges hitelesítési hitelesítő adatokat, vagy különböző XSLT-beállításokat adhat meg.

Lásd még

• Az XslCompiledTransform osztály használata

Load(Type)

Forrás:

XslCompiledTransform.cs

Betölti az XSLT Fordítóval (xsltc.exe) létrehozott lefordított stíluslapot.

public:
 void Load(Type ^ compiledStylesheet);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("This method will get fields and types from the assembly of the passed in compiledStylesheet and call their constructors which cannot be statically analyzed")]
public void Load(Type compiledStylesheet);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("This method will get fields and types from the assembly of the passed in compiledStylesheet and call their constructors which cannot be statically analyzed")>]
member this.Load : Type -> unit

Public Sub Load (compiledStylesheet As Type)

Paraméterek

compiledStylesheet

Type

A lefordított stíluslapot tartalmazó osztály neve.

Ez általában a stíluslap neve. Ha másként nincs megadva, a xsltc.exe eszköz az osztály- és szerelvénynevek stíluslapjának nevét használja.

Attribútumok

RequiresUnreferencedCodeAttribute

Példák

Az alábbi példa bemutatja, hogyan tölthet be lefordított stíluslapot egy XSLT-szerelvényből. A példa feltételezi, hogy a xsltc.exe eszközt egy bookOrders.dll nevű szerelvény létrehozásához használták egy bookOrders nevű osztálysal.

Note

A kód összeállításakor az XSLT-szerelvényre kell hivatkoznia. Például: csc /r:system.dll;system.xml.dll;bookOrders.dll myCode.cs.

// Load the type of the class.
XslCompiledTransform xslt = new XslCompiledTransform();
xslt.Load(typeof(bookOrders));

Megjegyzések

A xsltc.exe eszköz stíluslapok fordítására és összeállítások létrehozására szolgál a stíluslapokból. A Load metódus betölti a lefordított stíluslapot a szerelvényből.

Note

Az XSLT-szerelvényt is referenciaként kell szerepeltetnie az alkalmazásban.

Lásd még

• XSLT szerelvényeszköz (xsltc.exe)
• Útmutató: XSLT-átalakítás végrehajtása szerelvény használatával
• Az XslCompiledTransform osztály használata

Load(String)

Forrás:

XslCompiledTransform.cs

Betölti és lefordítja a megadott URI-n található stíluslapot.

public:
 void Load(System::String ^ stylesheetUri);

public void Load(string stylesheetUri);

member this.Load : string -> unit

Public Sub Load (stylesheetUri As String)

Paraméterek

stylesheetUri

String

A stíluslap URI-ja.

Kivételek

ArgumentNullException

Az stylesheetUri érték a következő null: .

XsltException

A stíluslap hibát tartalmaz.

FileNotFoundException

A stíluslap nem található.

DirectoryNotFoundException

Az stylesheetUri érték olyan fájlnevet vagy könyvtárat tartalmaz, amely nem található.

WebException

Az stylesheetUri érték nem oldható fel.

-vagy-

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

UriFormatException

stylesheetUri nem érvényes URI.

XmlException

Elemzési hiba történt a stíluslap 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")

Megjegyzések

Az XslCompiledTransform osztály támogatja az XSLT 1.0 szintaxist. Az XSLT stíluslapnak a névteret http://www.w3.org/1999/XSL/Transform kell használnia.

Ez a módszer a következő viselkedést követi:

• A XmlUrlResolver stíluslap URI-jának feloldásához és az elemek xsl:import vagy xsl:include elemek feldolgozásához felhasználói hitelesítő adatok nélkül használható.

• A XmlReader stíluslap 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 Load metódusnak.

• A document() függvény le van tiltva.

• A beágyazott szkriptek nem támogatottak.

A túlterheléssel megadhatja Load(String, XsltSettings, XmlResolver) a XmlResolver szükséges hitelesítési hitelesítő adatokat, vagy különböző XSLT-beállításokat adhat meg.

Lásd még

• Az XslCompiledTransform osztály használata

Load(IXPathNavigable)

Forrás:

XslCompiledTransform.cs

Lefordítja az objektumban IXPathNavigable található stíluslapot.

public:
 void Load(System::Xml::XPath::IXPathNavigable ^ stylesheet);

public void Load(System.Xml.XPath.IXPathNavigable stylesheet);

member this.Load : System.Xml.XPath.IXPathNavigable -> unit

Public Sub Load (stylesheet As IXPathNavigable)

Paraméterek

stylesheet

IXPathNavigable

Az interfészt implementáló IXPathNavigable objektum. A Microsoft .NET keretrendszerben ez lehet egy XmlNode (általában egy XmlDocument), vagy egy XPathDocument, amely tartalmazza a stíluslapot.

Kivételek

ArgumentNullException

Az stylesheet érték a következő null: .

XsltException

A stíluslap hibát tartalmaz.

Példák

Az alábbi példa betölt egy objektumban XPathDocument található stíluslapot.

XslCompiledTransform xslt = new XslCompiledTransform();
xslt.Load(new XPathDocument("http://serverName/data/xsl/sort.xsl"));

Dim xslt As New XslCompiledTransform()
xslt.Load(New XPathDocument("http://serverName/data/xsl/sort.xsl"))

Megjegyzések

Az XslCompiledTransform osztály támogatja az XSLT 1.0 szintaxist. Az XSLT stíluslapnak a névteret http://www.w3.org/1999/XSL/Transform kell használnia.

Ez a módszer a következő viselkedést követi:

• A XmlUrlResolver felhasználói hitelesítő adatokkal nem rendelkező felhasználók bármelyikének xsl:import vagy xsl:include elemeinek feldolgozására szolgálnak.

• A document() függvény le van tiltva.

• A beágyazott szkriptek nem támogatottak.

A túlterheléssel megadhatja Load a XmlResolver szükséges hitelesítési hitelesítő adatokat, vagy különböző XSLT-beállításokat adhat meg.

Lásd még

• Az XslCompiledTransform osztály használata