XslCompiledTransform.Load XslCompiledTransform.Load XslCompiledTransform.Load XslCompiledTransform.Load Method

Definition

Kompiliert das Stylesheet.Compiles the style sheet.

Überlädt

Load(IXPathNavigable, XsltSettings, XmlResolver) Load(IXPathNavigable, XsltSettings, XmlResolver) Load(IXPathNavigable, XsltSettings, XmlResolver) Load(IXPathNavigable, XsltSettings, XmlResolver)

Kompiliert das im IXPathNavigable enthaltene XSLT-Stylesheet.Compiles the XSLT style sheet contained in the IXPathNavigable. Der XmlResolver löst die vorhandenen import-XSLT-Elemente und include-XSLT-Elemente auf, und die XSLT-Einstellungen legen die Berechtigungen für das Stylesheet fest.The XmlResolver resolves any XSLT import or include elements and the XSLT settings determine the permissions for the style sheet.

Load(String, XsltSettings, XmlResolver) Load(String, XsltSettings, XmlResolver) Load(String, XsltSettings, XmlResolver) Load(String, XsltSettings, XmlResolver)

Lädt und kompiliert das vom URI angegebene XSLT-Stylesheet.Loads and compiles the XSLT style sheet specified by the URI. Der XmlResolver löst die vorhandenen import-XSLT-Elemente und include-XSLT-Elemente auf, und die XSLT-Einstellungen legen die Berechtigungen für das Stylesheet fest.The XmlResolver resolves any XSLT import or include elements and the XSLT settings determine the permissions for the style sheet.

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

Lädt eine Methode aus einem Stylesheet, das mit XSLTC.exe kompiliert wurde.Loads a method from a style sheet compiled using the XSLTC.exe utility.

Load(XmlReader, XsltSettings, XmlResolver) Load(XmlReader, XsltSettings, XmlResolver) Load(XmlReader, XsltSettings, XmlResolver) Load(XmlReader, XsltSettings, XmlResolver)

Kompiliert das im XmlReader enthaltene XSLT-Stylesheet.Compiles the XSLT style sheet contained in the XmlReader. Der XmlResolver löst die vorhandenen import-XSLT-Elemente und include-XSLT-Elemente auf, und die XSLT-Einstellungen legen die Berechtigungen für das Stylesheet fest.The XmlResolver resolves any XSLT import or include elements and the XSLT settings determine the permissions for the style sheet.

Load(XmlReader) Load(XmlReader) Load(XmlReader) Load(XmlReader)

Kompiliert das im XmlReader enthaltene Stylesheet.Compiles the style sheet contained in the XmlReader.

Load(Type) Load(Type) Load(Type) Load(Type)

Lädt das kompilierte Stylesheet, das mit dem XSLT-Compiler (xsltc.exe) erstellt wurde.Loads the compiled style sheet that was created using the XSLT Compiler (xsltc.exe).

Load(String) Load(String) Load(String) Load(String)

Lädt und kompiliert das am angegebenen URI abgelegte Stylesheet.Loads and compiles the style sheet located at the specified URI.

Load(IXPathNavigable) Load(IXPathNavigable) Load(IXPathNavigable) Load(IXPathNavigable)

Kompiliert das im IXPathNavigable-Objekt enthaltene Stylesheet.Compiles the style sheet contained in the IXPathNavigable object.

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.Although the overall performance of the XslCompiledTransform class is better than the XslTransform class, the Load method of the XslCompiledTransform class might perform more slowly than the Load method of the XslTransform class the first time it is called on a transformation. Dies liegt daran, dass die XSLT-Datei zunächst kompiliert werden muss, bevor sie geladen wird.This is because the XSLT file must be compiled before it is loaded. Weitere Informationen finden Sie im folgenden Blogbeitrag: XslCompiledTransform Slower than XslTransform? (XslCompiledTransform langsamer als XslTransform)For more information, see the following blog post: XslCompiledTransform Slower than XslTransform?

Hinweis

Es gibt Unterschiede zwischen einer XSLT, die im Debugmodus kompiliert wurde, und einer im Releasemodus kompilierten XSLT.There are differences between XSLT compiled in Debug mode and XSLT compiled in Release mode. 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.In some situations, style sheets compiled in Debug mode will not throw errors during Load, but will later fail during Transform. Das gleiche, im Releasemodus kompilierte Stylesheet schlägt während Load fehl.The same style sheet compiled in Release mode will fail during Load. Ein Beispiel für solches Verhalten ist, wenn eine Variable, die kein Knotengruppentyp ist, einem Ausdruck zugeordnet wird, der eine Knotengruppe erfordert.An example of such behavior is when a variable that is not of a node-set type is assigned to an expression where a node-set is required.

Load(IXPathNavigable, XsltSettings, XmlResolver) Load(IXPathNavigable, XsltSettings, XmlResolver) Load(IXPathNavigable, XsltSettings, XmlResolver) Load(IXPathNavigable, XsltSettings, XmlResolver)

Kompiliert das im IXPathNavigable enthaltene XSLT-Stylesheet.Compiles the XSLT style sheet contained in the IXPathNavigable. Der XmlResolver löst die vorhandenen import-XSLT-Elemente und include-XSLT-Elemente auf, und die XSLT-Einstellungen legen die Berechtigungen für das Stylesheet fest.The XmlResolver resolves any XSLT import or include elements and the XSLT settings determine the permissions for the style sheet.

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

Ein Objekt, das die IXPathNavigable-Schnittstelle implementiert.An object implementing the IXPathNavigable interface. In .Microsoft NET Framework kann dies entweder ein XmlNode (normalerweise ein XmlDocument) oder ein XPathDocument mit dem Stylesheet sein.In the Microsoft .NET Framework, this can be either an XmlNode (typically an XmlDocument), or an XPathDocument containing the style sheet.

settings
XsltSettings XsltSettings XsltSettings XsltSettings

Die auf das Stylesheet angewendeten XsltSettings.The XsltSettings to apply to the style sheet. Bei einem Wert von null wird die Default-Einstellung angewendet.If this is null, the Default setting is applied.

stylesheetResolver
XmlResolver XmlResolver XmlResolver XmlResolver

Der XmlResolver zum Auflösen vorhandener Stylesheets, auf die in import-XSLT-Elementen und include-XSLT-Elementen verwiesen wird.The XmlResolver used to resolve any style sheets referenced in XSLT import and include elements. Bei null werden externe Ressourcen nicht aufgelöst.If this is null, external resources are not resolved.

Ausnahmen

Der stylesheet-Wert ist null.The stylesheet value is null.

Das Stylesheet enthält einen Fehler.The style sheet contains an error.

Beispiele

Im folgende Beispiel wird ein Stylesheet geladen.The following example loads a style sheet. Die XmlSecureResolver Objekt enthält die notwendigen Informationen für den Zugriff auf import oder include Elemente, die im Stylesheet gefunden.The XmlSecureResolver object contains the credentials necessary to access any import or include elements found in the style sheet.

// 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.The XslCompiledTransform class supports the XSLT 1.0 syntax. XSLT-Stylesheet verwenden, muss die http://www.w3.org/1999/XSL/Transform Namespace.The XSLT style sheet must use the http://www.w3.org/1999/XSL/Transform namespace.

Siehe auch

Load(String, XsltSettings, XmlResolver) Load(String, XsltSettings, XmlResolver) Load(String, XsltSettings, XmlResolver) Load(String, XsltSettings, XmlResolver)

Lädt und kompiliert das vom URI angegebene XSLT-Stylesheet.Loads and compiles the XSLT style sheet specified by the URI. Der XmlResolver löst die vorhandenen import-XSLT-Elemente und include-XSLT-Elemente auf, und die XSLT-Einstellungen legen die Berechtigungen für das Stylesheet fest.The XmlResolver resolves any XSLT import or include elements and the XSLT settings determine the permissions for the style sheet.

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)

Parameter

stylesheetUri
String String String String

Der URI des Stylesheets.The URI of the style sheet.

settings
XsltSettings XsltSettings XsltSettings XsltSettings

Die auf das Stylesheet angewendeten XsltSettings.The XsltSettings to apply to the style sheet. Bei einem Wert von null wird die Default-Einstellung angewendet.If this is null, the Default setting is applied.

stylesheetResolver
XmlResolver XmlResolver XmlResolver XmlResolver

Der XmlResolver, mit dem der URI des Stylesheets aufgelöst wird, sowie Stylesheets, auf die von import-XSLT-Elementen und include-XSLT-Elementen verwiesen wird.The XmlResolver used to resolve the style sheet URI and any style sheets referenced in XSLT import and include elements.

Ausnahmen

Der stylesheetUri-Wert oder der stylesheetResolver-Wert ist null.The stylesheetUri or stylesheetResolver value is null.

Das Stylesheet enthält einen Fehler.The style sheet contains an error.

Das Stylesheet kann nicht gefunden werden.The style sheet cannot be found.

Der stylesheetUri-Wert enthält einen Dateinamen oder ein Verzeichnis, das nicht gefunden werden kann.The stylesheetUri value includes a filename or directory that cannot be found.

Der stylesheetUri-Wert kann nicht aufgelöst werden.The stylesheetUri value cannot be resolved.

- oder --or- Fehler beim Verarbeiten der Anforderung.An error occurred while processing the request.

stylesheetUri ist kein gültiger URI.stylesheetUri is not a valid URI.

Beim Laden des Stylesheets ist ein Analysefehler aufgetreten.There was a parsing error loading the style sheet.

Beispiele

Das folgende Beispiel lädt ein Stylesheet, die auf eine Netzwerkressource gespeichert ist.The following example loads a style sheet that is stored on a network resource. Ein XmlSecureResolver-Objekt gibt die Anmeldeinformationen an, die für den Zugriff auf das Stylesheet erforderlich sind.An XmlSecureResolver object specifies the credentials necessary to access the style sheet.

// 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.The XslCompiledTransform class supports the XSLT 1.0 syntax. XSLT-Stylesheet verwenden, muss die http://www.w3.org/1999/XSL/Transform Namespace.The XSLT style sheet must use the http://www.w3.org/1999/XSL/Transform namespace.

Ein XmlReader mit Standardeinstellungen zum Laden des Stylesheets verwendet wird.An XmlReader with default settings is used to load the style sheet. DTD-Verarbeitung ist deaktiviert, auf die XmlReader.DTD processing is disabled on the XmlReader. Wenn eine DTD-Verarbeitung erforderlich ist, erstellen Sie eine XmlReader mit diesem Feature aktiviert, und übergeben es an der Load Methode.If you require DTD processing, create an XmlReader with this feature enabled, and pass it to the Load method.

Siehe auch

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

Lädt eine Methode aus einem Stylesheet, das mit XSLTC.exe kompiliert wurde.Loads a method from a style sheet compiled using the XSLTC.exe utility.

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);
member this.Load : System.Reflection.MethodInfo * byte[] * Type[] -> unit
Public Sub Load (executeMethod As MethodInfo, queryData As Byte(), earlyBoundTypes As Type())

Parameter

executeMethod
MethodInfo MethodInfo MethodInfo MethodInfo

Ein MethodInfo-Objekt, das die vom Compiler generierte execute-Methode des kompilierten Stylesheets darstellt.A MethodInfo object representing the compiler-generated execute method of the compiled style sheet.

queryData
Byte[]

Ein Bytearray mit serialisierten Datenstrukturen im staticData-Feld des kompilierten Stylesheets, wie es von der CompileToType(XmlReader, XsltSettings, XmlResolver, Boolean, TypeBuilder, String)-Methode generiert wurde.A byte array of serialized data structures in the staticData field of the compiled style sheet as generated by the CompileToType(XmlReader, XsltSettings, XmlResolver, Boolean, TypeBuilder, String) method.

earlyBoundTypes
Type[]

Ein Array mit Typen, das im vom Compiler generierten ebTypes-Feld des kompilierten Stylesheets gespeichert ist.An array of types stored in the compiler-generated ebTypes field of the compiled style sheet.

Beispiele

Das Codebeispiel unten verwendet die Load ein kompilierten Stylesheets zu laden.The code example below uses the Load to load a compiled style sheet. Die Transformation für den Wert des verringert die Price Element um zehn Prozent.The transformation reduces the value of the Price element by ten percent.

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

In diesem Beispiel verwendete "Transformieren" Assembly wurde mit dem Hilfsprogramm xsltc.exe erstellt.The "Transform" assembly used in this example was built using the xsltc.exe utility. Ausführliche Informationen zur Verwendung dieses Befehlszeilentool finden Sie unter Vorgehensweise: Ausführen eine XSLT-Transformation mittels einer Assembly.For detailed information on using this command line tool, see How to: Perform an XSLT Transformation by Using an Assembly.

Im vorherigen Codebeispiel verwendet die folgende Transformationen:The previous code example uses the following transformation:

<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 kompilierte Stylesheet in Form von einem MethodInfo -Objekt, ein Bytearray und ein Typarray.This method accepts a compiled style sheet in the form of a MethodInfo object, a byte array, and a type array. DynamicMethod Objekte können verwendet werden, um das kompilierte Stylesheet Methoden zuzulassen, verworfen, wenn die XslCompiledTransform Objekt wieder zugänglich gemacht wird.DynamicMethod objects may be used to allow compiled style sheet methods to be discarded when the XslCompiledTransform object is reclaimed.

Load(XmlReader, XsltSettings, XmlResolver) Load(XmlReader, XsltSettings, XmlResolver) Load(XmlReader, XsltSettings, XmlResolver) Load(XmlReader, XsltSettings, XmlResolver)

Kompiliert das im XmlReader enthaltene XSLT-Stylesheet.Compiles the XSLT style sheet contained in the XmlReader. Der XmlResolver löst die vorhandenen import-XSLT-Elemente und include-XSLT-Elemente auf, und die XSLT-Einstellungen legen die Berechtigungen für das Stylesheet fest.The XmlResolver resolves any XSLT import or include elements and the XSLT settings determine the permissions for the style sheet.

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

Der XmlReader, der das Stylesheet enthält.The XmlReader containing the style sheet.

settings
XsltSettings XsltSettings XsltSettings XsltSettings

Die auf das Stylesheet angewendeten XsltSettings.The XsltSettings to apply to the style sheet. Bei einem Wert von null wird die Default-Einstellung angewendet.If this is null, the Default setting is applied.

stylesheetResolver
XmlResolver XmlResolver XmlResolver XmlResolver

Der XmlResolver zum Auflösen vorhandener Stylesheets, auf die in import-XSLT-Elementen und include-XSLT-Elementen verwiesen wird.The XmlResolver used to resolve any style sheets referenced in XSLT import and include elements. Bei null werden externe Ressourcen nicht aufgelöst.If this is null, external resources are not resolved.

Ausnahmen

Der stylesheet-Wert ist null.The stylesheet value is null.

Das Stylesheet enthält einen Fehler.The style sheet contains an error.

Beispiele

Im folgenden Beispiel wird ein Stylesheet geladen und aktiviert die Unterstützung für XSLT-Skripterstellung.The following example loads a style sheet and enables support for XSLT scripting.

// 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.The XslCompiledTransform class supports the XSLT 1.0 syntax. XSLT-Stylesheet verwenden, muss die http://www.w3.org/1999/XSL/Transform Namespace.The XSLT style sheet must use the http://www.w3.org/1999/XSL/Transform namespace.

Das Stylesheet geladen wird, aus dem aktuellen Knoten von der XmlReader über alle untergeordneten Elemente.The style sheet loads from the current node of the XmlReader through all its children. Dadurch können Sie einen Teil eines Dokuments als das Stylesheet verwenden.This enables you to use a portion of a document as the style sheet. Nachdem die Load Methode ausgeführt wird, die XmlReader auf den nächsten Knoten positioniert ist, die nach dem Ende des Stylesheets.After the Load method completes, the XmlReader is positioned on the next node after the end of the style sheet. Wenn das Ende des Dokuments erreicht wird, wird der XmlReader am Ende der Datei (EOF) platziert.If the end of the document is reached, the XmlReader is positioned at the end of file (EOF).

Siehe auch

Load(XmlReader) Load(XmlReader) Load(XmlReader) Load(XmlReader)

Kompiliert das im XmlReader enthaltene Stylesheet.Compiles the style sheet contained in the 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)

Parameter

stylesheet
XmlReader XmlReader XmlReader XmlReader

Ein XmlReader, der das Stylesheet enthält.An XmlReader containing the style sheet.

Ausnahmen

Der stylesheet-Wert ist null.The stylesheet value is null.

Das Stylesheet enthält einen Fehler.The style sheet contains an error.

Beispiele

Das folgende Beispiel lädt ein im enthaltenen Stylesheet eine XmlReader Objekt.The following example loads a style sheet contained in an XmlReader object.

// 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.The XslCompiledTransform class supports the XSLT 1.0 syntax. XSLT-Stylesheet verwenden, muss die http://www.w3.org/1999/XSL/Transform Namespace.The XSLT style sheet must use the http://www.w3.org/1999/XSL/Transform namespace.

Das Stylesheet geladen wird, aus dem aktuellen Knoten von der XmlReader über alle untergeordneten Elemente.The style sheet loads from the current node of the XmlReader through all its children. Dadurch können Sie einen Teil eines Dokuments als das Stylesheet verwenden.This enables you to use a portion of a document as the style sheet. Nachdem die Load Methode ausgeführt wird, die XmlReader auf den nächsten Knoten positioniert ist, die nach dem Ende des Stylesheets.After the Load method completes, the XmlReader is positioned on the next node after the end of the style sheet. Wenn das Ende des Dokuments erreicht wird, wird der XmlReader am Ende der Datei (EOF) platziert.If the end of the document is reached, the XmlReader is positioned at the end of file (EOF).

Diese Methode hat das folgende Verhalten:This method has the following behavior:

  • Ein XmlUrlResolver ohne Anmeldeinformationen wird zum Verarbeiten eines xsl:import oder xsl:include Elemente.An XmlUrlResolver with no user credentials is used to process any xsl:import or xsl:include elements.

  • Die document() Funktion ist deaktiviert.The document() function is disabled.

  • Eingebettete Skripts werden nicht unterstützt.Embedded scripts are not supported.

Können Sie die Load(XmlReader, XsltSettings, XmlResolver) Überladung an eine XmlResolver mit den Anmeldeinformationen für die erforderliche Authentifizierung oder andere XSLT-Einstellungen angeben.You can use the Load(XmlReader, XsltSettings, XmlResolver) overload to specify an XmlResolver with the necessary authentication credentials, or to specify different XSLT settings.

Siehe auch

Load(Type) Load(Type) Load(Type) Load(Type)

Lädt das kompilierte Stylesheet, das mit dem XSLT-Compiler (xsltc.exe) erstellt wurde.Loads the compiled style sheet that was created using the XSLT Compiler (xsltc.exe).

public:
 void Load(Type ^ compiledStylesheet);
public void Load (Type compiledStylesheet);
member this.Load : Type -> unit
Public Sub Load (compiledStylesheet As Type)

Parameter

compiledStylesheet
Type Type Type Type

Der Name der Klasse, die das kompilierte Stylesheet enthält.The name of the class that contains the compiled style sheet.

Dies ist normalerweise der Name des Stylesheets.This is usually the name of the style sheet. Wenn nicht anders angegeben, verwendet xsltc.exe den Namen des Stylesheets als Klassen- und als Assemblynamen.Unless otherwise specified, the xsltc.exe tool uses the name of the style sheet for the class and assembly names.

Beispiele

Das folgende Beispiel zeigt, wie ein kompilierte Stylesheet aus einer XSLT-Assembly geladen wird.The following example shows how to load a compiled style sheet from an XSLT assembly. Im Beispiel wird davon ausgegangen, dass das xsltc.exe-Tool zum Erstellen einer Assembly mit dem Namen der mit der Klasse bookOrders bookOrders.dll verwendet wurde.The example assumes that the xsltc.exe tool was used to create an assembly named bookOrders.dll with a class named bookOrders.

Hinweis

Sie müssen die XSLT-Assembly verweisen, beim Kompilieren des Codes.You have to reference the XSLT assembly when compiling the code. Beispielsweise csc /r:system.dll;system.xml.dll;bookOrders.dll myCode.cs.For example, 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 zum Kompilieren von Stylesheets und Generieren von Assemblys aus den Stylesheets.The xsltc.exe tool is used to compile style sheets and generate assemblies from the style sheets. Die Load Methode lädt das kompilierte Stylesheet, aus der Assembly.The Load method loads the compiled style sheet from the assembly.

Hinweis

Sie müssen auch die XSLT-Assembly als Verweis in der Anwendung einschließen.You must also include the XSLT assembly as a reference in your application.

Siehe auch

Load(String) Load(String) Load(String) Load(String)

Lädt und kompiliert das am angegebenen URI abgelegte Stylesheet.Loads and compiles the style sheet located at the specified URI.

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

Der URI des Stylesheets.The URI of the style sheet.

Ausnahmen

Der stylesheetUri-Wert ist null.The stylesheetUri value is null.

Das Stylesheet enthält einen Fehler.The style sheet contains an error.

Das Stylesheet kann nicht gefunden werden.The style sheet cannot be found.

Der stylesheetUri-Wert enthält einen Dateinamen oder ein Verzeichnis, das nicht gefunden werden kann.The stylesheetUri value includes a filename or directory that cannot be found.

Der stylesheetUri-Wert kann nicht aufgelöst werden.The stylesheetUri value cannot be resolved.

- oder --or- Fehler beim Verarbeiten der Anforderung.An error occurred while processing the request.

stylesheetUri ist kein gültiger URI.stylesheetUri is not a valid URI.

Beim Laden des Stylesheets ist ein Analysefehler aufgetreten.There was a parsing error loading the style sheet.

Beispiele

Im folgende Beispiel führt eine Transformation, und es gibt in einer Datei.The following example executes a transform and outputs to a file.

// Load the style sheet.
XslCompiledTransform xslt = new XslCompiledTransform();
xslt.Load("output.xsl");

// Execute the transform and output the results to a file.
xslt.Transform("books.xml", "books.html");
' Load the style sheet.
Dim xslt As New XslCompiledTransform()
xslt.Load("output.xsl")
        
' Execute the transform and output the results to a file.
xslt.Transform("books.xml", "books.html")

Hinweise

Die XslCompiledTransform Klasse unterstützt die XSLT 1.0-Syntax.The XslCompiledTransform class supports the XSLT 1.0 syntax. XSLT-Stylesheet verwenden, muss die http://www.w3.org/1999/XSL/Transform Namespace.The XSLT style sheet must use the http://www.w3.org/1999/XSL/Transform namespace.

Diese Methode hat das folgende Verhalten:This method has the following behavior:

  • Ein XmlUrlResolver ohne Benutzer-Anmeldeinformationen wird verwendet, um den URI des Stylesheets aufgelöst und verarbeiten alle xsl:import oder xsl:include Elemente.An XmlUrlResolver with no user credentials is used to resolve the style sheet URI, and process any xsl:import or xsl:include elements.

  • Ein XmlReader mit Standardeinstellungen zum Laden des Stylesheets verwendet wird.An XmlReader with default settings is used to load the style sheet. DTD-Verarbeitung ist deaktiviert, auf die XmlReader.DTD processing is disabled on the XmlReader. Wenn eine DTD-Verarbeitung erforderlich ist, erstellen Sie eine XmlReader mit diesem Feature aktiviert, und übergeben es an der Load Methode.If you require DTD processing, create an XmlReader with this feature enabled, and pass it to the Load method.

  • Die document() Funktion ist deaktiviert.The document() function is disabled.

  • Eingebettete Skripts werden nicht unterstützt.Embedded scripts are not supported.

Können Sie die Load(String, XsltSettings, XmlResolver) Überladung an eine XmlResolver mit den Anmeldeinformationen für die erforderliche Authentifizierung oder andere XSLT-Einstellungen angeben.You can use the Load(String, XsltSettings, XmlResolver) overload to specify an XmlResolver with the necessary authentication credentials, or to specify different XSLT settings.

Siehe auch

Load(IXPathNavigable) Load(IXPathNavigable) Load(IXPathNavigable) Load(IXPathNavigable)

Kompiliert das im IXPathNavigable-Objekt enthaltene Stylesheet.Compiles the style sheet contained in the IXPathNavigable object.

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

Ein Objekt, das die IXPathNavigable-Schnittstelle implementiert.An object implementing the IXPathNavigable interface. In .Microsoft NET Framework kann dies entweder ein XmlNode (normalerweise ein XmlDocument) oder ein XPathDocument mit dem Stylesheet sein.In the Microsoft .NET Framework, this can be either an XmlNode (typically an XmlDocument), or an XPathDocument containing the style sheet.

Ausnahmen

Der stylesheet-Wert ist null.The stylesheet value is null.

Das Stylesheet enthält einen Fehler.The style sheet contains an error.

Beispiele

Das folgende Beispiel lädt ein im enthaltenen Stylesheet eine XPathDocument Objekt.The following example loads a style sheet contained in an XPathDocument object.

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.The XslCompiledTransform class supports the XSLT 1.0 syntax. XSLT-Stylesheet verwenden, muss die http://www.w3.org/1999/XSL/Transform Namespace.The XSLT style sheet must use the http://www.w3.org/1999/XSL/Transform namespace.

Diese Methode hat das folgende Verhalten:This method has the following behavior:

  • Ein XmlUrlResolver ohne Anmeldeinformationen wird zum Verarbeiten eines xsl:import oder xsl:include Elemente.An XmlUrlResolver with no user credentials is used to process any xsl:import or xsl:include elements.

  • Die document() Funktion ist deaktiviert.The document() function is disabled.

  • Eingebettete Skripts werden nicht unterstützt.Embedded scripts are not supported.

Können Sie die Load Überladung an eine XmlResolver mit den Anmeldeinformationen für die erforderliche Authentifizierung oder andere XSLT-Einstellungen angeben.You can use the Load overload to specify an XmlResolver with the necessary authentication credentials, or to specify different XSLT settings.

Siehe auch

Gilt für: