XslCompiledTransform.Load Methode

Definition

Namespace:: System.Xml.Xsl

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

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Kompiliert das Stylesheet.

Überlädt

Name	Beschreibung
Load(IXPathNavigable, XsltSettings, XmlResolver)	Kompiliert das XSLT-Stylesheet, das in der IXPathNavigableDatei enthalten ist. Die XmlResolver Auflösungen von XSLT `import` oder `include` Elementen sowie die XSLT-Einstellungen bestimmen die Berechtigungen für das Stylesheet.
Load(String, XsltSettings, XmlResolver)	Lädt und kompiliert das durch den URI angegebene XSLT-Stylesheet. Die XmlResolver Auflösungen von XSLT `import` oder `include` Elementen sowie die XSLT-Einstellungen bestimmen die Berechtigungen für das Stylesheet.
Load(MethodInfo, Byte[], Type[])	Lädt eine Methode aus einem stylesheet, das mithilfe des `XSLTC.exe` Hilfsprogramms kompiliert wurde.
Load(XmlReader, XsltSettings, XmlResolver)	Kompiliert das XSLT-Stylesheet, das in der XmlReaderDatei enthalten ist. Die XmlResolver Auflösungen von XSLT `import` oder `include` Elementen sowie die XSLT-Einstellungen bestimmen die Berechtigungen für das Stylesheet.
Load(XmlReader)	Kompiliert das in der XmlReaderDatei enthaltene Stylesheet.
Load(Type)	Lädt das kompilierte Stylesheet, das mit dem XSLT-Compiler (xsltc.exe) erstellt wurde.
Load(String)	Lädt und kompiliert das Stylesheet, das sich am angegebenen URI befindet.
Load(IXPathNavigable)	Kompiliert das im IXPathNavigable Objekt enthaltene Stylesheet.

Hinweise

Obwohl die Gesamtleistung der XslCompiledTransform Klasse besser ist als die XslTransform Klasse, kann die Load Methode der XslCompiledTransform Klasse langsamer als die Load Methode der XslTransform Klasse ausgeführt werden, wenn sie zum ersten Mal für eine Transformation aufgerufen wird. Dies liegt daran, dass die XSLT-Datei vor dem Laden kompiliert werden muss. Weitere Informationen finden Sie im folgenden Blogbeitrag: XslCompiledTransform Langsamer als XslTransform?

Note

Es gibt Unterschiede zwischen XSLT, die im Debugmodus kompiliert wurden, und XSLT, die im Releasemodus kompiliert wurden. In einigen Situationen löst Stylesheets, die im Debugmodus kompiliert wurden, während der Fehler nicht ausLoad, sondern später fehlschlagen.Transform Das im Releasemodus kompilierte Stylesheet schlägt während Loaddes Vorgangs fehl. Ein Beispiel für ein solches Verhalten ist, wenn eine Variable, die nicht vom Knotensatztyp ist, einem Ausdruck zugewiesen wird, in dem ein Knotensatz erforderlich ist.

Load(IXPathNavigable, XsltSettings, XmlResolver)

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Kompiliert das XSLT-Stylesheet, das in der IXPathNavigableDatei enthalten ist. Die XmlResolver Auflösungen von XSLT import oder include Elementen sowie die XSLT-Einstellungen bestimmen die Berechtigungen für das Stylesheet.

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

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)

Parameter

stylesheet: IXPathNavigable

Ein Objekt, das die IXPathNavigable Schnittstelle implementiert. In Microsoft .NET Framework kann dies entweder ein (in der Regel ein XmlNode XmlDocument) oder ein XPathDocument Stylesheet sein.

settings: XsltSettings

Der XsltSettings auf das Stylesheet angewendet werden soll. Wenn dies der Fall ist null, wird die Default Einstellung angewendet.

stylesheetResolver: XmlResolver

Wird XmlResolver verwendet, um alle Stylesheets aufzulösen, auf die in XSLT import und include Elementen verwiesen wird. Wenn dies der Fall ist null, werden externe Ressourcen nicht aufgelöst.

Ausnahmen

ArgumentNullException

Der wert stylesheet ist null.

XsltException

Das Stylesheet enthält einen Fehler.

Beispiele

Im folgenden Beispiel wird ein Stylesheet geladen. Das XmlSecureResolver Objekt enthält die Anmeldeinformationen, die für den Zugriff auf elemente importinclude im Stylesheet erforderlich sind.

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

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

' Create a resolver and specify the necessary credentials.
Dim resolver As New XmlUrlResolver()
Dim myCred As System.Net.NetworkCredential
myCred = New System.Net.NetworkCredential(UserName, SecurelyStoredPassword, Domain)
resolver.Credentials = myCred
        
' Load the style sheet.
Dim xslt As New XslCompiledTransform()
xslt.Load(New XPathDocument("http://serverName/data/xsl/sort.xsl"), XsltSettings.Default, resolver)

Hinweise

Die XslCompiledTransform Klasse unterstützt die XSLT 1.0-Syntax. Das XSLT-Stylesheet muss den http://www.w3.org/1999/XSL/Transform Namespace verwenden.

Weitere Informationen

Verwenden der XslCompiledTransform-Klasse

Gilt für:

Load(String, XsltSettings, XmlResolver)

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Lädt und kompiliert das durch den URI angegebene XSLT-Stylesheet. Die XmlResolver Auflösungen von XSLT import oder include Elementen sowie die XSLT-Einstellungen bestimmen die Berechtigungen für das Stylesheet.

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

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)

Parameter

stylesheetUri: String

Der URI des Stylesheets.

settings: XsltSettings

Der XsltSettings auf das Stylesheet angewendet werden soll. Wenn dies der Fall ist null, wird die Default Einstellung angewendet.

stylesheetResolver: XmlResolver

Wird XmlResolver verwendet, um den Stylesheet-URI und alle Stylesheets aufzulösen, auf die in XSLT import und include Elementen verwiesen wird.

Ausnahmen

ArgumentNullException

Der stylesheetUri Wert ist stylesheetResolvernull.

XsltException

Das Stylesheet enthält einen Fehler.

FileNotFoundException

Das Stylesheet kann nicht gefunden werden.

DirectoryNotFoundException

Der stylesheetUri Wert enthält einen Dateinamen oder ein Verzeichnis, das nicht gefunden werden kann.

WebException

Der stylesheetUri Wert kann nicht aufgelöst werden.

- oder -

Fehler beim Verarbeiten der Anforderung.

UriFormatException

stylesheetUri ist kein gültiger URI.

XmlException

Fehler beim Laden des Stylesheets.

Beispiele

Im folgenden Beispiel wird ein Stylesheet geladen, das in einer Netzwerkressource gespeichert ist. Ein XmlSecureResolver Objekt gibt die Anmeldeinformationen an, die für den Zugriff auf das Stylesheet erforderlich sind.

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

// Load the style sheet.
xslt.Load("http://serverName/data/xsl/sort.xsl", null, 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
        
' Load the style sheet.
xslt.Load("http://serverName/data/xsl/sort.xsl", Nothing, resolver)

Hinweise

Die XslCompiledTransform Klasse unterstützt die XSLT 1.0-Syntax. Das XSLT-Stylesheet muss den http://www.w3.org/1999/XSL/Transform Namespace verwenden.

Ein XmlReader Standardeinstellungen wird verwendet, um das Stylesheet zu laden. DIE DTD-Verarbeitung ist für die XmlReader. Wenn Sie eine DTD-Verarbeitung benötigen, erstellen Sie ein XmlReader Feature mit aktivierter Funktion, und übergeben Sie es an die Load Methode.

Weitere Informationen

Verwenden der XslCompiledTransform-Klasse

Gilt für:

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

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Lädt eine Methode aus einem stylesheet, das mithilfe des XSLTC.exe Hilfsprogramms kompiliert wurde.

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

public void Load(System.Reflection.MethodInfo executeMethod, byte[] queryData, Type[]? earlyBoundTypes);

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

member this.Load : System.Reflection.MethodInfo * byte[] * Type[] -> unit

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

Parameter

executeMethod: MethodInfo

Ein MethodInfo Objekt, das die vom Compiler generierte execute Methode des kompilierten Stylesheets darstellt.

queryData: Byte[]

Ein Bytearray serialisierter Datenstrukturen im staticData Feld des kompilierten Stylesheets, wie durch die CompileToType(XmlReader, XsltSettings, XmlResolver, Boolean, TypeBuilder, String) Methode generiert.

earlyBoundTypes: Type[]

Ein Array von Typen, die im vom Compiler generierten ebTypes Feld des kompilierten Stylesheets gespeichert sind.

Attribute: RequiresUnreferencedCodeAttribute

Beispiele

Im folgenden Codebeispiel wird ein Load kompiliertes Stylesheet geladen. Die Transformation reduziert den Wert des Price Elements um zehn Prozent.

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

Die in diesem Beispiel verwendete "Transform"-Assembly wurde mit dem hilfsprogramm xsltc.exe erstellt. Ausführliche Informationen zur Verwendung dieses Befehlszeilentools finden Sie unter How to: Perform an XSLT Transformation by Using an Assembly.

Im vorherigen Codebeispiel wird die folgende Transformation verwendet:

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

Hinweise

Diese Methode akzeptiert ein kompiliertes Stylesheet in Form eines MethodInfo Objekts, eines Bytearrays und eines Typarrays. DynamicMethod Objekte können verwendet werden, um zuzulassen, dass kompilierte Stylesheetmethoden verworfen werden, wenn das XslCompiledTransform Objekt erneut beansprucht wird.

Gilt für:

Load(XmlReader, XsltSettings, XmlResolver)

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Kompiliert das XSLT-Stylesheet, das in der XmlReaderDatei enthalten ist. Die XmlResolver Auflösungen von XSLT import oder include Elementen sowie die XSLT-Einstellungen bestimmen die Berechtigungen für das Stylesheet.

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

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)

Parameter

stylesheet: XmlReader

Das XmlReader Enthaltende Stylesheet.

settings: XsltSettings

Der XsltSettings auf das Stylesheet angewendet werden soll. Wenn dies der Fall ist null, wird die Default Einstellung angewendet.

stylesheetResolver: XmlResolver

Ausnahmen

ArgumentNullException

Der wert stylesheet ist null.

XsltException

Das Stylesheet enthält einen Fehler.

Beispiele

Im folgenden Beispiel wird ein Stylesheet geladen und die Unterstützung für XSLT-Skripting aktiviert.

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

Hinweise

Die XslCompiledTransform Klasse unterstützt die XSLT 1.0-Syntax. Das XSLT-Stylesheet muss den http://www.w3.org/1999/XSL/Transform Namespace verwenden.

Das Stylesheet wird vom aktuellen Knoten der XmlReader durch alle untergeordneten Elemente geladen. Auf diese Weise können Sie einen Teil eines Dokuments als Stylesheet verwenden. Nach Abschluss der Load Methode wird die XmlReader Position auf dem nächsten Knoten nach dem Ende des Stylesheets positioniert. Wenn das Ende des Dokuments erreicht ist, wird das XmlReader Dokument am Ende der Datei (EOF) positioniert.

Weitere Informationen

Verwenden der XslCompiledTransform-Klasse

Gilt für:

Load(XmlReader)

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Kompiliert das in der XmlReaderDatei enthaltene Stylesheet.

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)

Parameter

stylesheet: XmlReader

Ein XmlReader Stylesheet, das das Stylesheet enthält.

Ausnahmen

ArgumentNullException

Der wert stylesheet ist null.

XsltException

Das Stylesheet enthält einen Fehler.

Beispiele

Im folgenden Beispiel wird ein Stylesheet geladen, das in einem XmlReader Objekt enthalten ist.

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

Hinweise

Die XslCompiledTransform Klasse unterstützt die XSLT 1.0-Syntax. Das XSLT-Stylesheet muss den http://www.w3.org/1999/XSL/Transform Namespace verwenden.

Diese Methode hat das folgende Verhalten:

Eine XmlUrlResolver Ohne Benutzeranmeldeinformationen wird zum Verarbeiten von Elementen xsl:import oder xsl:include Elementen verwendet.
Die document() Funktion ist deaktiviert.
Eingebettete Skripts werden nicht unterstützt.

Mit der Load(XmlReader, XsltSettings, XmlResolver) Überladung können Sie eine XmlResolver mit den erforderlichen Authentifizierungsanmeldeinformationen angeben oder unterschiedliche XSLT-Einstellungen angeben.

Weitere Informationen

Verwenden der XslCompiledTransform-Klasse

Gilt für:

Load(Type)

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Lädt das kompilierte Stylesheet, das mit dem XSLT-Compiler (xsltc.exe) erstellt wurde.

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

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

member this.Load : Type -> unit

Public Sub Load (compiledStylesheet As Type)

Parameter

compiledStylesheet: Type

Der Name der Klasse, die das kompilierte Stylesheet enthält.

Dies ist in der Regel der Name des Stylesheets. Sofern nicht anders angegeben, verwendet das xsltc.exe Tool den Namen des Stylesheets für die Klassen- und Assemblynamen.

Attribute: RequiresUnreferencedCodeAttribute

Beispiele

Das folgende Beispiel zeigt, wie ein kompiliertes Stylesheet aus einer XSLT-Assembly geladen wird. Im Beispiel wird davon ausgegangen, dass das xsltc.exe-Tool verwendet wurde, um eine Assembly namens bookOrders.dll mit einer Klasse mit dem Namen "bookOrders" zu erstellen.

Note

Beim Kompilieren des Codes müssen Sie auf die XSLT-Assembly verweisen. Beispiel: 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));

Hinweise

Das xsltc.exe Tool wird verwendet, um Stylesheets zu kompilieren und Assemblys aus den Stylesheets zu generieren. Die Load Methode lädt das kompilierte Stylesheet aus der Assembly.

Note

Sie müssen die XSLT-Assembly auch als Verweis in Ihre Anwendung einschließen.

Weitere Informationen

Gilt für:

Load(String)

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Lädt und kompiliert das Stylesheet, das sich am angegebenen URI befindet.

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

public void Load(string stylesheetUri);

member this.Load : string -> unit

Public Sub Load (stylesheetUri As String)

Parameter

stylesheetUri: String

Der URI des Stylesheets.

Ausnahmen

ArgumentNullException

Der wert stylesheetUri ist null.

XsltException

Das Stylesheet enthält einen Fehler.

FileNotFoundException

Das Stylesheet kann nicht gefunden werden.

DirectoryNotFoundException

Der stylesheetUri Wert enthält einen Dateinamen oder ein Verzeichnis, das nicht gefunden werden kann.

WebException

Der stylesheetUri Wert kann nicht aufgelöst werden.

- oder -

Fehler beim Verarbeiten der Anforderung.

UriFormatException

stylesheetUri ist kein gültiger URI.

XmlException

Fehler beim Laden des Stylesheets.

Beispiele

Im folgenden Beispiel wird eine Transformation ausgeführt und in eine Datei ausgegeben.

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

Hinweise

Die XslCompiledTransform Klasse unterstützt die XSLT 1.0-Syntax. Das XSLT-Stylesheet muss den http://www.w3.org/1999/XSL/Transform Namespace verwenden.

Diese Methode hat das folgende Verhalten:

Ein XmlUrlResolver Benutzer ohne Benutzeranmeldeinformationen wird verwendet, um den Stylesheet-URI aufzulösen und alle xsl:import Elemente zu xsl:include verarbeiten.
Ein XmlReader Standardeinstellungen wird verwendet, um das Stylesheet zu laden. DIE DTD-Verarbeitung ist für die XmlReader. Wenn Sie eine DTD-Verarbeitung benötigen, erstellen Sie ein XmlReader Feature mit aktivierter Funktion, und übergeben Sie es an die Load Methode.
Die document() Funktion ist deaktiviert.
Eingebettete Skripts werden nicht unterstützt.

Mit der Load(String, XsltSettings, XmlResolver) Überladung können Sie eine XmlResolver mit den erforderlichen Authentifizierungsanmeldeinformationen angeben oder unterschiedliche XSLT-Einstellungen angeben.

Weitere Informationen

Verwenden der XslCompiledTransform-Klasse

Gilt für:

Load(IXPathNavigable)

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Kompiliert das im IXPathNavigable Objekt enthaltene Stylesheet.

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)

Parameter

stylesheet: IXPathNavigable

Ein Objekt, das die IXPathNavigable Schnittstelle implementiert. In Microsoft .NET Framework kann dies entweder ein (in der Regel ein XmlNode XmlDocument) oder ein XPathDocument Stylesheet sein.

Ausnahmen

ArgumentNullException

Der wert stylesheet ist null.

XsltException

Das Stylesheet enthält einen Fehler.

Beispiele

Im folgenden Beispiel wird ein Stylesheet geladen, das in einem XPathDocument Objekt enthalten ist.

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

Hinweise

Die XslCompiledTransform Klasse unterstützt die XSLT 1.0-Syntax. Das XSLT-Stylesheet muss den http://www.w3.org/1999/XSL/Transform Namespace verwenden.

Diese Methode hat das folgende Verhalten:

Eine XmlUrlResolver Ohne Benutzeranmeldeinformationen wird zum Verarbeiten von Elementen xsl:import oder xsl:include Elementen verwendet.
Die document() Funktion ist deaktiviert.
Eingebettete Skripts werden nicht unterstützt.

Mit der Load Überladung können Sie eine XmlResolver mit den erforderlichen Authentifizierungsanmeldeinformationen angeben oder unterschiedliche XSLT-Einstellungen angeben.

Weitere Informationen

Verwenden der XslCompiledTransform-Klasse

Gilt für:

Feedback

War diese Seite hilfreich?