XslCompiledTransform.Load Methode

Referenz

Definition

Namespace:: System.Xml.Xsl

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

Load(IXPathNavigable, XsltSettings, XmlResolver)	Kompiliert das im IXPathNavigable enthaltene XSLT-Stylesheet. Die XmlResolver löst alle XSLT- `import` oder `include` -Elemente auf, und die XSLT-Einstellungen bestimmen die Berechtigungen für das Stylesheet.
Load(String, XsltSettings, XmlResolver)	Lädt und kompiliert das vom URI angegebene XSLT-Stylesheet. Die XmlResolver löst alle XSLT- `import` oder `include` -Elemente auf, und die XSLT-Einstellungen bestimmen die Berechtigungen für das Stylesheet.
Load(MethodInfo, Byte[], Type[])	Lädt eine Methode aus einem Stylesheet, das mit `XSLTC.exe` kompiliert wurde.
Load(XmlReader, XsltSettings, XmlResolver)	Kompiliert das im XmlReader enthaltene XSLT-Stylesheet. Die XmlResolver löst alle XSLT- `import` oder `include` -Elemente auf, und die XSLT-Einstellungen bestimmen die Berechtigungen für das Stylesheet.
Load(XmlReader)	Kompiliert das im XmlReader 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 am angegebenen URI abgelegte Stylesheet.
Load(IXPathNavigable)	Kompiliert das im IXPathNavigable-Objekt enthaltene Stylesheet.

Hinweise

Obwohl die Gesamtleistung der XslCompiledTransform-Klasse besser ist als die der XslTransform-Klasse, ist die Leistung der Load-Methode der XslCompiledTransform-Klasse möglicherweise langsamer als die Load-Methode der XslTransform-Klasse, wenn sie zum ersten Mal für eine Transformation aufgerufen wird. Dies liegt daran, dass die XSLT-Datei zunächst kompiliert werden muss, bevor sie geladen wird. Weitere Informationen finden Sie im folgenden Blogbeitrag: XslCompiledTransform Slower than XslTransform? (Ist XslCompiledTransform langsamer als XslTransform?)

Hinweis

Es gibt Unterschiede zwischen einer XSLT, die im Debugmodus kompiliert wurde, und einer im Releasemodus kompilierten XSLT. In einigen Fällen werden durch Stylesheets, die im Debugmodus kompiliert wurden, während Load keine Fehler ausgelöst. Die Stylesheets schlagen jedoch später während Transform fehl. Das gleiche, im Releasemodus kompilierte Stylesheet schlägt während Load fehl. Ein Beispiel für solches Verhalten ist, wenn eine Variable, die kein Knotengruppentyp ist, einem Ausdruck zugeordnet wird, der eine Knotengruppe erfordert.

Load(IXPathNavigable, XsltSettings, XmlResolver)

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Kompiliert das im IXPathNavigable enthaltene XSLT-Stylesheet. Die XmlResolver löst alle XSLT- import oder include -Elemente auf, und 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 XmlNode (normalerweise ein XmlDocument) oder ein XPathDocument mit dem Stylesheet sein.

settings: XsltSettings

Die auf das Stylesheet angewendeten XsltSettings. Bei einem Wert von null wird die Default-Einstellung angewendet.

stylesheetResolver: XmlResolver

Die XmlResolver , die verwendet wird, um alle Stylesheets aufzulösen, auf die in XSLT import und include Elementen verwiesen wird. Bei null werden externe Ressourcen nicht aufgelöst.

Ausnahmen

ArgumentNullException

Der stylesheet-Wert 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 import oder include 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

Lädt und kompiliert das vom URI angegebene XSLT-Stylesheet. Die XmlResolver löst alle XSLT- import oder include -Elemente auf, und 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

Die auf das Stylesheet angewendeten XsltSettings. Bei einem Wert von null wird die Default-Einstellung angewendet.

stylesheetResolver: XmlResolver

Der XmlResolver zum Auflösen des Stylesheet-URI und aller Stylesheets, auf die in XSLT import und include Elementen verwiesen wird.

Ausnahmen

ArgumentNullException

Der stylesheetUri-Wert oder der stylesheetResolver-Wert 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 -

Bei der Verarbeitung der Anforderung ist ein Fehler aufgetreten.

UriFormatException

stylesheetUri ist kein gültiger URI.

XmlException

Beim Laden des Stylesheets ist ein Analysefehler aufgetreten.

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 mit Standardeinstellungen wird verwendet, um das Stylesheet zu laden. Die DTD-Verarbeitung ist für deaktiviert XmlReader. Wenn Sie eine DTD-Verarbeitung benötigen, erstellen Sie ein XmlReader mit aktiviertem Feature, 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

Lädt eine Methode aus einem Stylesheet, das mit XSLTC.exe kompiliert wurde.

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

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

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

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 von serialisierten Datenstrukturen im staticData Feld des kompilierten Stylesheets, das von der CompileToType(XmlReader, XsltSettings, XmlResolver, Boolean, TypeBuilder, String) -Methode generiert wird.

earlyBoundTypes: Type[]

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

Beispiele

Im folgenden Codebeispiel wird verwendet, Load um ein kompiliertes Stylesheet zu laden. 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

Hinweis

Die in diesem Beispiel verwendete Assembly "Transform" wurde mithilfe des Hilfsprogramms xsltc.exe erstellt. Ausführliche Informationen zur Verwendung dieses Befehlszeilentools finden Sie unter Vorgehensweise: Ausführen einer XSLT-Transformation mithilfe einer 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, damit kompilierte Stylesheetmethoden verworfen werden können, wenn das XslCompiledTransform Objekt wieder abgerufen wird.

Gilt für:

Load(XmlReader, XsltSettings, XmlResolver)

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Kompiliert das im XmlReader enthaltene XSLT-Stylesheet. Die XmlResolver löst alle XSLT- import oder include -Elemente auf, und 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

Der XmlReader, der das Stylesheet enthält.

settings: XsltSettings

Die auf das Stylesheet angewendeten XsltSettings. Bei einem Wert von null wird die Default-Einstellung angewendet.

stylesheetResolver: XmlResolver

Die XmlResolver , die verwendet wird, um alle Stylesheets aufzulösen, auf die in XSLT import und include Elementen verwiesen wird. Bei null werden externe Ressourcen nicht aufgelöst.

Ausnahmen

ArgumentNullException

Der stylesheet-Wert ist null.

XsltException

Das Stylesheet enthält einen Fehler.

Beispiele

Im folgenden Beispiel wird ein Stylesheet geladen und die Unterstützung für XSLT-Skripts 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 lädt vom aktuellen Knoten des XmlReader über alle untergeordneten Elemente. Dadurch können Sie einen Teil eines Dokuments als Stylesheet verwenden. Nachdem die Load -Methode abgeschlossen ist, wird die XmlReader auf dem nächsten Knoten nach dem Ende des Stylesheets positioniert. Wenn das Ende des Dokuments erreicht wird, wird der XmlReader am Ende der Datei (EOF) platziert.

Weitere Informationen

Verwenden der XslCompiledTransform-Klasse

Gilt für:

Load(XmlReader)

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Kompiliert das im XmlReader 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, der das Stylesheet enthält.

Ausnahmen

ArgumentNullException

Der stylesheet-Wert 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:

Ein XmlUrlResolver ohne Benutzeranmeldeinformationen wird verwendet, um elemente xsl:import oder xsl:include zu verarbeiten.
Die document() Funktion ist deaktiviert.
Eingebettete Skripts werden nicht unterstützt.

Sie können die Load(XmlReader, XsltSettings, XmlResolver) Überladung verwenden, um einen XmlResolver mit den erforderlichen Anmeldeinformationen für die Authentifizierung anzugeben oder unterschiedliche XSLT-Einstellungen anzugeben.

Weitere Informationen

Verwenden der XslCompiledTransform-Klasse

Gilt für:

Load(Type)

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

public void Load (Type compiledStylesheet);

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 normalerweise der Name des Stylesheets. Wenn nicht anders angegeben, verwendet xsltc.exe den Namen des Stylesheets als Klassen- und als Assemblynamen.

Beispiele

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

Hinweis

Sie müssen beim Kompilieren des Codes 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 tool xsltc.exe wird verwendet, um Stylesheets zu kompilieren und Assemblys aus den Stylesheets zu generieren. Die Load -Methode lädt das kompilierte Stylesheet aus der Assembly.

Hinweis

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

Weitere Informationen

Gilt für:

Load(String)

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Quelle:: XslCompiledTransform.cs

Lädt und kompiliert das am angegebenen URI abgelegte Stylesheet.

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

Bei der Verarbeitung der Anforderung ist ein Fehler aufgetreten.

UriFormatException

stylesheetUri ist kein gültiger URI.

XmlException

Beim Laden des Stylesheets ist ein Analysefehler aufgetreten.

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 ohne Benutzeranmeldeinformationen wird verwendet, um den Stylesheet-URI aufzulösen und elemente xsl:import oder xsl:include zu verarbeiten.
Ein XmlReader mit Standardeinstellungen wird verwendet, um das Stylesheet zu laden. Die DTD-Verarbeitung ist für deaktiviert XmlReader. Wenn Sie eine DTD-Verarbeitung benötigen, erstellen Sie ein XmlReader mit aktiviertem Feature, und übergeben Sie es an die Load -Methode.
Die document() Funktion ist deaktiviert.
Eingebettete Skripts werden nicht unterstützt.

Sie können die Load(String, XsltSettings, XmlResolver) Überladung verwenden, um einen XmlResolver mit den erforderlichen Anmeldeinformationen für die Authentifizierung anzugeben oder unterschiedliche XSLT-Einstellungen anzugeben.

Weitere Informationen

Verwenden der XslCompiledTransform-Klasse

Gilt für:

Load(IXPathNavigable)

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

Ausnahmen

ArgumentNullException

Der stylesheet-Wert 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:

Ein XmlUrlResolver ohne Benutzeranmeldeinformationen wird verwendet, um elemente xsl:import oder xsl:include zu verarbeiten.
Die document() Funktion ist deaktiviert.
Eingebettete Skripts werden nicht unterstützt.

Sie können die Load Überladung verwenden, um einen XmlResolver mit den erforderlichen Anmeldeinformationen für die Authentifizierung anzugeben oder unterschiedliche XSLT-Einstellungen anzugeben.

Weitere Informationen

Verwenden der XslCompiledTransform-Klasse

Gilt für:

Freigeben über

XslCompiledTransform.Load Methode

Definition

Überlädt

Hinweise

Load(IXPathNavigable, XsltSettings, XmlResolver)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Load(String, XsltSettings, XmlResolver)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

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

Parameter

Beispiele

Hinweise

Gilt für:

Load(XmlReader, XsltSettings, XmlResolver)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Load(XmlReader)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Load(Type)

Parameter

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Load(String)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Load(IXPathNavigable)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen