XslCompiledTransform.Load Метод

Ссылка

Определение

Пространство имен:: System.Xml.Xsl

Сборка:: System.Xml.ReaderWriter.dll

Сборка:: System.Xml.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Компилирует таблицу стилей.

Перегрузки

Load(IXPathNavigable, XsltSettings, XmlResolver)	Компилирует таблицу стилей XSLT, содержащуюся в объекте IXPathNavigable. разрешает XmlResolver все XSLT `import` или элементы, `include` а параметры XSLT определяют разрешения для таблицы стилей.
Load(String, XsltSettings, XmlResolver)	Загружает и компилирует таблицу стилей XSLT, указанную по URI. разрешает XmlResolver все XSLT `import` или элементы, `include` а параметры XSLT определяют разрешения для таблицы стилей.
Load(MethodInfo, Byte[], Type[])	Загружает метод из таблицы стилей, скомпилированной с помощью средства `XSLTC.exe`.
Load(XmlReader, XsltSettings, XmlResolver)	Компилирует таблицу стилей XSLT, содержащуюся в объекте XmlReader. разрешает XmlResolver все XSLT `import` или элементы, `include` а параметры XSLT определяют разрешения для таблицы стилей.
Load(XmlReader)	Компилирует таблицу стилей, содержащуюся в объекте XmlReader.
Load(Type)	Загружает скомпилированную таблицу стилей, которая была создана с помощью XSLT-компилятора (xsltc.exe).
Load(String)	Загружает и компилирует таблицу стилей, расположенную по указанному URI.
Load(IXPathNavigable)	Компилирует таблицу стилей, содержащуюся в таблице IXPathNavigable.

Хотя класс XslCompiledTransform имеет более высокий общий уровень производительности, чем класс XslTransform, метод Load класса XslCompiledTransform может выполняться медленнее, чем метод Load класса XslTransform при первом вызове преобразования. Причина этого заключается в необходимости компиляции XSLT-файла перед его загрузкой. Дополнительные сведения см. в следующей записи блога: XslCompiledTransform выполняется медленнее, чем XslTransform?

Примечание

Ниже приведены различия между XSLT, скомпилированными в режиме отладки и режиме выпуска. В некоторых случаях таблицы стилей, скомпилированные в режиме отладки, не выдают ошибки во время вызова Load, но завершаются ошибкой позже, при вызове метода Transform. Та же таблица стилей, скомпилированная в режиме выпуска, завершается ошибкой во время вызова Load. Например, это может произойти в том случае, если переменная, не принадлежащая к типу набора узлов, присваивается выражению, где требуется набор узлов.

Load(IXPathNavigable, XsltSettings, XmlResolver)

Исходный код:: XslCompiledTransform.cs

Исходный код:: XslCompiledTransform.cs

Исходный код:: XslCompiledTransform.cs

Компилирует таблицу стилей XSLT, содержащуюся в объекте IXPathNavigable. разрешает XmlResolver все XSLT import или элементы, include а параметры XSLT определяют разрешения для таблицы стилей.

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)

Параметры

stylesheet: IXPathNavigable

Объект, реализующий интерфейс IXPathNavigable. В Microsoft .NET Framework это может быть либо XmlNode (обычно XmlDocument), либо XPathDocument, содержащий таблицу стилей.

settings: XsltSettings

Объект XsltSettings, который следует применить к таблице стилей. Если значение равно null, применяется параметр Default.

stylesheetResolver: XmlResolver

Используется XmlResolver для разрешения всех таблиц стилей, на которые ссылается XSLT import и include элементы. Если его значение равно null, внешние ресурсы не определяются.

Исключения

ArgumentNullException

Значение stylesheet — null.

XsltException

Таблица стилей содержит ошибку.

Примеры

В следующем примере загружается таблица стилей. Объект XmlSecureResolver содержит учетные данные, необходимые для доступа к элементам import или include , найденным в таблице стилей.

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

См. также раздел

Использование класса XslCompiledTransform

Применяется к

Load(String, XsltSettings, XmlResolver)

Исходный код:: XslCompiledTransform.cs

Исходный код:: XslCompiledTransform.cs

Исходный код:: XslCompiledTransform.cs

Загружает и компилирует таблицу стилей XSLT, указанную по URI. разрешает XmlResolver все XSLT import или элементы, include а параметры XSLT определяют разрешения для таблицы стилей.

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)

Параметры

stylesheetUri: String

URI таблицы стилей.

settings: XsltSettings

stylesheetResolver: XmlResolver

, используемый XmlResolver для разрешения URI таблицы стилей и всех таблиц стилей, на которые ссылается XSLT import и include элементы.

Исключения

ArgumentNullException

Параметру stylesheetUri или stylesheetResolver задано значение null.

XsltException

Таблица стилей содержит ошибку.

FileNotFoundException

Не удается найти таблицу стилей.

DirectoryNotFoundException

Значение stylesheetUri включает имя файла или каталог, который невозможно найти.

WebException

Значение stylesheetUri не удается разрешить.

-или-

При обработке этого запроса возникла ошибка.

UriFormatException

stylesheetUri не является допустимым URI.

XmlException

Произошла ошибка анализа при загрузке таблицы стилей.

Примеры

В следующем примере загружается таблица стилей, которая хранится в сетевом ресурсе. Объект XmlSecureResolver задает учетные данные, необходимые для доступа к таблице стилей.

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

С XmlReader параметрами по умолчанию используется для загрузки таблицы стилей. Обработка DTD отключена в XmlReader. Если требуется обработка DTD, создайте с включенной XmlReader функцией и передайте ее методу Load .

См. также раздел

Использование класса XslCompiledTransform

Применяется к

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

Исходный код:: XslCompiledTransform.cs

Исходный код:: XslCompiledTransform.cs

Исходный код:: XslCompiledTransform.cs

Загружает метод из таблицы стилей, скомпилированной с помощью средства XSLTC.exe.

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

Параметры

executeMethod: MethodInfo

Объект MethodInfo , представляющий созданный execute компилятором метод скомпилированной таблицы стилей.

queryData: Byte[]

Массив байтов сериализованных структур данных в staticData поле скомпилированной таблицы стилей, созданной методом CompileToType(XmlReader, XsltSettings, XmlResolver, Boolean, TypeBuilder, String) .

earlyBoundTypes: Type[]

Массив типов, хранящихся в созданном ebTypes компилятором поле скомпилированной таблицы стилей.

Примеры

В приведенном ниже примере кода используется Load для загрузки скомпилированной таблицы стилей. Преобразование уменьшает значение элемента на Price десять процентов.

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

Примечание

Сборка Transform, используемая в этом примере, была создана с помощью служебной программы xsltc.exe. Подробные сведения об использовании этого средства командной строки см. в разделе Практическое руководство. Выполнение преобразования XSLT с помощью сборки.

В предыдущем примере кода используется следующее преобразование:

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

Этот метод принимает скомпилированную таблицу стилей MethodInfo в виде объекта, массива байтов и массива типов. DynamicMethod объекты можно использовать для разрешения отмены скомпилированных методов таблицы стилей при освобождении XslCompiledTransform объекта.

Применяется к

Load(XmlReader, XsltSettings, XmlResolver)

Исходный код:: XslCompiledTransform.cs

Исходный код:: XslCompiledTransform.cs

Исходный код:: XslCompiledTransform.cs

Компилирует таблицу стилей XSLT, содержащуюся в объекте XmlReader. разрешает XmlResolver все XSLT import или элементы, include а параметры XSLT определяют разрешения для таблицы стилей.

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)

Параметры

stylesheet: XmlReader

XmlReader, содержащий таблицу стилей.

settings: XsltSettings

stylesheetResolver: XmlResolver

Исключения

ArgumentNullException

Значение stylesheet — null.

XsltException

Таблица стилей содержит ошибку.

Примеры

В следующем примере загружается таблица стилей и включается поддержка скриптов XSLT.

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

Таблица стилей загружается из текущего узла через все его дочерние XmlReader элементы. Это позволяет использовать часть документа в качестве таблицы стилей. Load После завершения XmlReader метода объект размещается на следующем узле после конца таблицы стилей. По достижении конца документа объект XmlReader позиционируется в конец файла (EOF).

См. также раздел

Использование класса XslCompiledTransform

Применяется к

Load(XmlReader)

Исходный код:: XslCompiledTransform.cs

Исходный код:: XslCompiledTransform.cs

Исходный код:: XslCompiledTransform.cs

Компилирует таблицу стилей, содержащуюся в объекте 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)

Параметры

stylesheet: XmlReader

XmlReader, содержащий таблицу стилей.

Исключения

ArgumentNullException

Значение stylesheet — null.

XsltException

Таблица стилей содержит ошибку.

Примеры

В следующем примере загружается таблица стилей, содержащаяся в объекте XmlReader .

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

Объект XmlUrlResolver без учетных данных пользователя используется для обработки любых xsl:import элементов или xsl:include .
Функция document() отключена.
Внедренные скрипты не поддерживаются.

Перегрузку Load(XmlReader, XsltSettings, XmlResolver) можно использовать для указания XmlResolver с необходимыми учетными данными проверки подлинности или для указания других параметров XSLT.

См. также раздел

Использование класса XslCompiledTransform

Применяется к

Load(Type)

Исходный код:: XslCompiledTransform.cs

Исходный код:: XslCompiledTransform.cs

Исходный код:: XslCompiledTransform.cs

Загружает скомпилированную таблицу стилей, которая была создана с помощью XSLT-компилятора (xsltc.exe).

public:
 void Load(Type ^ compiledStylesheet);

public void Load (Type compiledStylesheet);

member this.Load : Type -> unit

Public Sub Load (compiledStylesheet As Type)

Параметры

compiledStylesheet: Type

Имя класса, содержащего скомпилированную таблицу стилей.

Как правило, это имя таблицы стилей. Если иное не указано, средство xsltc.exe использует имя таблицы стилей в именах классов и сборок.

Примеры

В следующем примере показано, как загрузить скомпилированную таблицу стилей из сборки XSLT. В примере предполагается, что средство xsltc.exe использовалось для создания сборки с именем bookOrders.dll с классом bookOrders.

Примечание

При компиляции кода необходимо ссылаться на сборку XSLT. Например, 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));

См. также раздел

Применяется к

Load(String)

Исходный код:: XslCompiledTransform.cs

Исходный код:: XslCompiledTransform.cs

Исходный код:: XslCompiledTransform.cs

Загружает и компилирует таблицу стилей, расположенную по указанному URI.

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

public void Load (string stylesheetUri);

member this.Load : string -> unit

Public Sub Load (stylesheetUri As String)

Параметры

stylesheetUri: String

URI таблицы стилей.

Исключения

ArgumentNullException

Значение stylesheetUri — null.

XsltException

Таблица стилей содержит ошибку.

FileNotFoundException

Не удается найти таблицу стилей.

DirectoryNotFoundException

Значение stylesheetUri включает имя файла или каталог, который невозможно найти.

WebException

Значение stylesheetUri не удается разрешить.

-или-

При обработке этого запроса возникла ошибка.

UriFormatException

stylesheetUri не является допустимым URI.

XmlException

Произошла ошибка анализа при загрузке таблицы стилей.

Примеры

В следующем примере выполняется преобразование и выводится в файл.

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

Объект XmlUrlResolver без учетных данных пользователя используется для разрешения URI таблицы стилей и обработки любых xsl:import элементов или xsl:include .
Для загрузки таблицы стилей XmlReader используется с параметрами по умолчанию. Обработка DTD отключена на XmlReader. Если требуется обработка DTD, создайте XmlReader объект с включенной функцией и передайте его в Load метод .
Функция document() отключена.
Внедренные скрипты не поддерживаются.

Перегрузку Load(String, XsltSettings, XmlResolver) можно использовать для указания XmlResolver с необходимыми учетными данными проверки подлинности или для указания других параметров XSLT.

См. также раздел

Использование класса XslCompiledTransform

Применяется к

Load(IXPathNavigable)

Исходный код:: XslCompiledTransform.cs

Исходный код:: XslCompiledTransform.cs

Исходный код:: XslCompiledTransform.cs

Компилирует таблицу стилей, содержащуюся в таблице IXPathNavigable.

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)

Параметры

stylesheet: IXPathNavigable

Исключения

ArgumentNullException

Значение stylesheet — null.

XsltException

Таблица стилей содержит ошибку.

Примеры

В следующем примере загружается таблица стилей, содержащаяся в объекте XPathDocument .

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

Объект XmlUrlResolver без учетных данных пользователя используется для обработки любых xsl:import элементов или xsl:include .
Функция document() отключена.
Внедренные скрипты не поддерживаются.

Перегрузку Load можно использовать для указания XmlResolver с необходимыми учетными данными проверки подлинности или для указания других параметров XSLT.

См. также раздел

Использование класса XslCompiledTransform

Применяется к

Поделиться через

XslCompiledTransform.Load Метод

Определение

Перегрузки

Комментарии

Load(IXPathNavigable, XsltSettings, XmlResolver)

Параметры

Исключения

Примеры

Комментарии

См. также раздел

Применяется к

Load(String, XsltSettings, XmlResolver)

Параметры

Исключения

Примеры

Комментарии

См. также раздел

Применяется к

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

Параметры

Примеры

Комментарии

Применяется к

Load(XmlReader, XsltSettings, XmlResolver)

Параметры

Исключения

Примеры

Комментарии

См. также раздел

Применяется к

Load(XmlReader)

Параметры

Исключения

Примеры

Комментарии

См. также раздел

Применяется к

Load(Type)

Параметры

Примеры

Комментарии

См. также раздел

Применяется к

Load(String)

Параметры

Исключения

Примеры

Комментарии

См. также раздел

Применяется к

Load(IXPathNavigable)

Параметры

Исключения

Примеры

Комментарии

См. также раздел

Применяется к

Обратная связь

Дополнительные ресурсы