XslCompiledTransform.Transform Метод

Определение

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

Сборки:: netstandard.dll, System.Xml.ReaderWriter.dll

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

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

Сборка:: netstandard.dll

Важно!

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

Выполняет преобразование XSLT.

Перегрузки

Имя	Описание
Transform(XmlReader, XsltArgumentList, TextWriter)	Выполняет преобразование с помощью входного документа, указанного XmlReader объектом, и выводит результаты в TextWriterобъект. Предоставляет XsltArgumentList дополнительные аргументы во время выполнения.
Transform(IXPathNavigable, XsltArgumentList, XmlWriter)	Выполняет преобразование с помощью входного документа, указанного IXPathNavigable объектом, и выводит результаты в объект XmlWriter. Предоставляет XsltArgumentList дополнительные аргументы во время выполнения.
Transform(IXPathNavigable, XsltArgumentList, TextWriter)	Выполняет преобразование с помощью входного документа, указанного IXPathNavigable объектом, и выводит результаты в объект TextWriter. Предоставляет XsltArgumentList дополнительные аргументы во время выполнения.
Transform(IXPathNavigable, XsltArgumentList, Stream)	Выполняет преобразование с помощью входного документа, указанного IXPathNavigable объектом, и выводит результаты в поток. Предоставляет XsltArgumentList дополнительные аргументы среды выполнения.
Transform(XmlReader, XsltArgumentList, XmlWriter)	Выполняет преобразование с помощью входного документа, указанного XmlReader объектом, и выводит результаты в объект XmlWriter. Предоставляет XsltArgumentList дополнительные аргументы во время выполнения.
Transform(XmlReader, XsltArgumentList, Stream)	Выполняет преобразование с помощью входного документа, указанного XmlReader объектом, и выводит результаты в поток. Предоставляет XsltArgumentList дополнительные аргументы во время выполнения.
Transform(String, String)	Выполняет преобразование с помощью входного документа, указанного URI, и выводит результаты в файл.
Transform(String, XsltArgumentList, TextWriter)	Выполняет преобразование с помощью входного документа, указанного URI, и выводит результаты в объект TextWriter.
Transform(String, XsltArgumentList, Stream)	Выполняет преобразование с помощью входного документа, указанного URI, и выводит результаты в поток. Предоставляет XsltArgumentList дополнительные аргументы во время выполнения.
Transform(IXPathNavigable, XmlWriter)	Выполняет преобразование с помощью входного документа, указанного IXPathNavigable объектом, и выводит результаты в объект XmlWriter.
Transform(XmlReader, XmlWriter)	Выполняет преобразование с помощью входного документа, указанного XmlReader объектом, и выводит результаты в объект XmlWriter.
Transform(String, XmlWriter)	Выполняет преобразование с помощью входного документа, указанного URI, и выводит результаты в объект XmlWriter.
Transform(XmlReader, XsltArgumentList, XmlWriter, XmlResolver)	Выполняет преобразование с помощью входного документа, указанного XmlReader объектом, и выводит результаты в объект XmlWriter. Предоставляет XsltArgumentList дополнительные аргументы во время выполнения и XmlResolver разрешает функцию XSLT `document()` .
Transform(String, XsltArgumentList, XmlWriter)	Выполняет преобразование с помощью входного документа, указанного URI, и выводит результаты в объект XmlWriter. Предоставляет XsltArgumentList дополнительные аргументы во время выполнения.
Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver)	Выполняет преобразование с помощью входного документа, указанного IXPathNavigable объектом, и выводит результаты в объект XmlWriter. Предоставляет XsltArgumentList дополнительные аргументы времени выполнения и XmlResolver разрешает функцию XSLT `document()` .

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

Transform(XmlReader, XsltArgumentList, TextWriter)

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

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

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

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

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

Выполняет преобразование с помощью входного документа, указанного XmlReader объектом, и выводит результаты в TextWriterобъект. Предоставляет XsltArgumentList дополнительные аргументы во время выполнения.

public:
 void Transform(System::Xml::XmlReader ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::IO::TextWriter ^ results);

public void Transform(System.Xml.XmlReader input, System.Xml.Xsl.XsltArgumentList? arguments, System.IO.TextWriter results);

public void Transform(System.Xml.XmlReader input, System.Xml.Xsl.XsltArgumentList arguments, System.IO.TextWriter results);

member this.Transform : System.Xml.XmlReader * System.Xml.Xsl.XsltArgumentList * System.IO.TextWriter -> unit

Public Sub Transform (input As XmlReader, arguments As XsltArgumentList, results As TextWriter)

Параметры

input: XmlReader

Содержащий XmlReader входной документ.

arguments: XsltArgumentList

Содержащий XsltArgumentList аргументы, отвечающие пространству имен, используемые в качестве входных данных для преобразования. Это значение может быть равно null.

results: TextWriter

Значение TextWriter , в которое требуется вывести данные.

Исключения

ArgumentNullException

Значение input или results значение null.

XsltException

Произошла ошибка при выполнении преобразования XSLT.

Если таблица стилей включает функцию XSLT document() , она разрешается с помощью XmlUrlResolver без учетных данных пользователя. Если внешний ресурс находится в сетевом ресурсе, требующего проверки подлинности, используйте перегрузку, которая принимает XmlResolver один из его аргументов и укажите XmlResolver необходимые учетные данные.

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

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

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

Transform(IXPathNavigable, XsltArgumentList, XmlWriter)

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

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

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

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

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

Выполняет преобразование с помощью входного документа, указанного IXPathNavigable объектом, и выводит результаты в объект XmlWriter. Предоставляет XsltArgumentList дополнительные аргументы во время выполнения.

public:
 void Transform(System::Xml::XPath::IXPathNavigable ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::Xml::XmlWriter ^ results);

public void Transform(System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList? arguments, System.Xml.XmlWriter results);

public void Transform(System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList arguments, System.Xml.XmlWriter results);

member this.Transform : System.Xml.XPath.IXPathNavigable * System.Xml.Xsl.XsltArgumentList * System.Xml.XmlWriter -> unit

Public Sub Transform (input As IXPathNavigable, arguments As XsltArgumentList, results As XmlWriter)

Параметры

input: IXPathNavigable

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

arguments: XsltArgumentList

results: XmlWriter

Значение XmlWriter , в которое требуется вывести данные.

Если таблица стилей xsl:output содержит элемент, необходимо создать XmlWriter объект, XmlWriterSettings возвращаемый из OutputSettings свойства. Это гарантирует наличие XmlWriter правильных параметров выходных данных.

Исключения

ArgumentNullException

Значение input или results значение null.

XsltException

Произошла ошибка при выполнении преобразования XSLT.

Если функция XSLT document() включена, она разрешается с помощью XmlUrlResolver учетных данных пользователя без учетных данных пользователя. Если внешний ресурс находится в сетевом ресурсе, требующего проверки подлинности, используйте перегрузку, которая принимает XmlResolver один из его аргументов и укажите XmlResolver необходимые учетные данные.

Этот метод не поддерживает xsl:strip-space элемент. Если скомпилированный лист стилей включал xsl:strip-space элемент, необходимо использовать Transform перегрузку, которая принимает XmlReader в качестве входного аргумента.

Интерфейс IXPathNavigable реализуется в классах XmlNode и XPathDocument классах. Эти классы представляют кэш XML-данных в памяти.

Класс XmlNode основан на объектной модели документа W3C (DOM) и включает возможности редактирования.
Класс XPathDocument — это хранилище данных только для чтения на основе модели данных XPath. XPathDocument — рекомендуемый класс для обработки XSLT. Он обеспечивает более высокую производительность по сравнению с классом XmlNode .

Преобразования применяются к документу в целом. Другими словами, если вы передаете узел, отличный от корневого узла документа, это не препятствует процессу преобразования получать доступ ко всем узлам в загруженном документе. Чтобы преобразовать фрагмент узла, необходимо создать объект, содержащий только фрагмент узла, и передать этот объект в Transform метод. Дополнительные сведения см. в разделе "Практическое руководство. Преобразование фрагмента узла".

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

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

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

Transform(IXPathNavigable, XsltArgumentList, TextWriter)

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

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

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

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

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

Выполняет преобразование с помощью входного документа, указанного IXPathNavigable объектом, и выводит результаты в объект TextWriter. Предоставляет XsltArgumentList дополнительные аргументы во время выполнения.

public:
 void Transform(System::Xml::XPath::IXPathNavigable ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::IO::TextWriter ^ results);

public void Transform(System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList? arguments, System.IO.TextWriter results);

public void Transform(System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList arguments, System.IO.TextWriter results);

member this.Transform : System.Xml.XPath.IXPathNavigable * System.Xml.Xsl.XsltArgumentList * System.IO.TextWriter -> unit

Public Sub Transform (input As IXPathNavigable, arguments As XsltArgumentList, results As TextWriter)

Параметры

input: IXPathNavigable

arguments: XsltArgumentList

results: TextWriter

Значение TextWriter , в которое требуется вывести данные.

Исключения

ArgumentNullException

Значение input или results значение null.

XsltException

Произошла ошибка при выполнении преобразования XSLT.

Класс XmlNode основан на объектной модели документа W3C (DOM) и включает возможности редактирования.
Класс XPathDocument — это хранилище данных только для чтения на основе модели данных XPath. XPathDocument — рекомендуемый класс для обработки XSLT. Он обеспечивает более высокую производительность по сравнению с классом XmlNode .

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

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

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

Transform(IXPathNavigable, XsltArgumentList, Stream)

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

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

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

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

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

Выполняет преобразование с помощью входного документа, указанного IXPathNavigable объектом, и выводит результаты в поток. Предоставляет XsltArgumentList дополнительные аргументы среды выполнения.

public:
 void Transform(System::Xml::XPath::IXPathNavigable ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::IO::Stream ^ results);

public void Transform(System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList? arguments, System.IO.Stream results);

public void Transform(System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList arguments, System.IO.Stream results);

member this.Transform : System.Xml.XPath.IXPathNavigable * System.Xml.Xsl.XsltArgumentList * System.IO.Stream -> unit

Public Sub Transform (input As IXPathNavigable, arguments As XsltArgumentList, results As Stream)

Параметры

input: IXPathNavigable

arguments: XsltArgumentList

results: Stream

Поток, в который требуется вывести выходные данные.

Исключения

ArgumentNullException

Значение input или results значение null.

XsltException

Произошла ошибка при выполнении преобразования XSLT.

Примеры

В следующем примере выполняется преобразование XSLT и выходные данные в объект FileStream.

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

// Create the FileStream.
using (FileStream fs = new FileStream(@"c:\data\output.xml", FileMode.Create))
{
   // Execute the transformation.
   xslt.Transform(new XPathDocument("books.xml"), null, fs);
}

' Load the style sheet.
Dim xslt As New XslCompiledTransform()
xslt.Load("output.xsl")
        
' Create the FileStream.
Using fs As New FileStream("c:\data\output.xml", FileMode.Create)
   ' Execute the transformation.
    xslt.Transform(New XPathDocument("books.xml"), Nothing, fs)
End Using

Класс XmlNode основан на объектной модели документа W3C (DOM) и включает возможности редактирования.
Класс XPathDocument — это хранилище данных только для чтения на основе модели данных XPath. XPathDocument — рекомендуемый класс для обработки XSLT. Он обеспечивает более высокую производительность по сравнению с классом XmlNode .

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

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

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

Transform(XmlReader, XsltArgumentList, XmlWriter)

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

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

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

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

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

Выполняет преобразование с помощью входного документа, указанного XmlReader объектом, и выводит результаты в объект XmlWriter. Предоставляет XsltArgumentList дополнительные аргументы во время выполнения.

public:
 void Transform(System::Xml::XmlReader ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::Xml::XmlWriter ^ results);

public void Transform(System.Xml.XmlReader input, System.Xml.Xsl.XsltArgumentList? arguments, System.Xml.XmlWriter results);

public void Transform(System.Xml.XmlReader input, System.Xml.Xsl.XsltArgumentList arguments, System.Xml.XmlWriter results);

member this.Transform : System.Xml.XmlReader * System.Xml.Xsl.XsltArgumentList * System.Xml.XmlWriter -> unit

Public Sub Transform (input As XmlReader, arguments As XsltArgumentList, results As XmlWriter)

Параметры

input: XmlReader

Содержащий XmlReader входной документ.

arguments: XsltArgumentList

results: XmlWriter

Значение XmlWriter , в которое требуется вывести данные.

Исключения

ArgumentNullException

Значение input или results значение null.

XsltException

Произошла ошибка при выполнении преобразования XSLT.

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

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

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

Transform(XmlReader, XsltArgumentList, Stream)

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

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

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

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

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

Выполняет преобразование с помощью входного документа, указанного XmlReader объектом, и выводит результаты в поток. Предоставляет XsltArgumentList дополнительные аргументы во время выполнения.

public:
 void Transform(System::Xml::XmlReader ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::IO::Stream ^ results);

public void Transform(System.Xml.XmlReader input, System.Xml.Xsl.XsltArgumentList? arguments, System.IO.Stream results);

public void Transform(System.Xml.XmlReader input, System.Xml.Xsl.XsltArgumentList arguments, System.IO.Stream results);

member this.Transform : System.Xml.XmlReader * System.Xml.Xsl.XsltArgumentList * System.IO.Stream -> unit

Public Sub Transform (input As XmlReader, arguments As XsltArgumentList, results As Stream)

Параметры

input: XmlReader

Содержащий XmlReader входной документ.

arguments: XsltArgumentList

results: Stream

Поток, в который требуется вывести выходные данные.

Исключения

ArgumentNullException

Значение input или results значение null.

XsltException

Произошла ошибка при выполнении преобразования XSLT.

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

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

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

Transform(String, String)

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

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

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

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

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

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

public:
 void Transform(System::String ^ inputUri, System::String ^ resultsFile);

public void Transform(string inputUri, string resultsFile);

member this.Transform : string * string -> unit

Public Sub Transform (inputUri As String, resultsFile As String)

Параметры

inputUri: String

Универсальный код ресурса (URI) входного документа.

resultsFile: String

Универсальный код ресурса (URI) выходного файла.

Исключения

ArgumentNullException

Значение inputUri или resultsFile значение null.

XsltException

Произошла ошибка при выполнении преобразования XSLT.

FileNotFoundException

Не удается найти входной документ.

DirectoryNotFoundException

inputUri Не resultsFile удается найти имя файла или каталог.

WebException

inputUri Разрешить или resultsFile значение невозможно.

–или–

Произошла ошибка при обработке запроса.

UriFormatException

inputUri или resultsFile не является допустимым универсальным кодом ресурса (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")

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

books.xml

<?xml version='1.0'?>
<!-- This file represents a fragment of a book store inventory database -->
<bookstore>
  <book genre="autobiography" publicationdate="1981" ISBN="1-861003-11-0">
    <title>The Autobiography of Benjamin Franklin</title>
    <author>
      <first-name>Benjamin</first-name>
      <last-name>Franklin</last-name>
    </author>
    <price>8.99</price>
  </book>
  <book genre="novel" publicationdate="1967" ISBN="0-201-63361-2">
    <title>The Confidence Man</title>
    <author>
      <first-name>Herman</first-name>
      <last-name>Melville</last-name>
    </author>
    <price>11.99</price>
  </book>
  <book genre="philosophy" publicationdate="1991" ISBN="1-861001-57-6">
    <title>The Gorgias</title>
    <author>
      <name>Plato</name>
    </author>
    <price>9.99</price>
  </book>
</bookstore>

output.xsl

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
<xsl:template match="bookstore">
  <HTML>
    <BODY>
      <TABLE BORDER="2">
        <TR>
          <TD>ISBN</TD>
          <TD>Title</TD>
          <TD>Price</TD>
        </TR>
        <xsl:apply-templates select="book"/>
      </TABLE>
    </BODY>
  </HTML>
</xsl:template>
<xsl:template match="book">
  <TR>
    <TD><xsl:value-of select="@ISBN"/></TD>
    <TD><xsl:value-of select="title"/></TD>
    <TD><xsl:value-of select="price"/></TD>
  </TR>
</xsl:template>
</xsl:stylesheet>

Этот метод использует значение по умолчанию XmlUrlResolver без учетных данных пользователя для разрешения входных и выходных документов. Если любой из этих ресурсов находится в сетевом ресурсе, требующего проверки подлинности, используйте перегрузку, XmlResolver принимающую в качестве одного из его аргументов, и укажите XmlResolver необходимые учетные данные.

Для XmlReader загрузки входного документа используется параметр по умолчанию. Обработка DTD отключена в элементе XmlReader. Если требуется обработка DTD, создайте XmlReader ее с включенным компонентом и передайте его в Transform метод.

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

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

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

Transform(String, XsltArgumentList, TextWriter)

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

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

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

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

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

Выполняет преобразование с помощью входного документа, указанного URI, и выводит результаты в объект TextWriter.

public:
 void Transform(System::String ^ inputUri, System::Xml::Xsl::XsltArgumentList ^ arguments, System::IO::TextWriter ^ results);

public void Transform(string inputUri, System.Xml.Xsl.XsltArgumentList? arguments, System.IO.TextWriter results);

public void Transform(string inputUri, System.Xml.Xsl.XsltArgumentList arguments, System.IO.TextWriter results);

member this.Transform : string * System.Xml.Xsl.XsltArgumentList * System.IO.TextWriter -> unit

Public Sub Transform (inputUri As String, arguments As XsltArgumentList, results As TextWriter)

Параметры

inputUri: String

Универсальный код ресурса (URI) входного документа.

arguments: XsltArgumentList

results: TextWriter

Значение TextWriter , в которое требуется вывести данные.

Исключения

ArgumentNullException

Значение inputUri или results значение null.

XsltException

Произошла ошибка при выполнении преобразования XSLT.

DirectoryNotFoundException

Значение inputUri содержит имя файла или каталог, не удается найти.

WebException

Невозможно inputUri устранить значение.

–или–

Произошла ошибка при обработке запроса.

UriFormatException

inputUri недопустимый универсальный код ресурса (URI).

XmlException

Произошла ошибка синтаксического анализа загрузки входного документа.

Примеры

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

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

// Transform the file and output an HTML string.
string HTMLoutput;
StringWriter writer = new StringWriter();
xslt.Transform("books.xml", null, writer);
HTMLoutput = writer.ToString();
writer.Close();

' Load the style sheet.
Dim xslt As New XslCompiledTransform()
xslt.Load("HTML_out.xsl")
        
' Transform the file and output an HTML string.
Dim HTMLoutput As String
Dim writer As New StringWriter()
xslt.Transform("books.xml", Nothing, writer)
HTMLoutput = writer.ToString()
writer.Close()

Этот метод использует значение по умолчанию XmlUrlResolver без учетных данных пользователя для разрешения входного документа и любых экземпляров функции XSLT document() , найденных в таблице стилей. Если любой из этих ресурсов находится в сетевом ресурсе, требующего проверки подлинности, используйте перегрузку, XmlResolver принимающую в качестве одного из его аргументов, и укажите XmlResolver необходимые учетные данные.

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

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

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

Transform(String, XsltArgumentList, Stream)

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

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

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

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

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

Выполняет преобразование с помощью входного документа, указанного URI, и выводит результаты в поток. Предоставляет XsltArgumentList дополнительные аргументы во время выполнения.

public:
 void Transform(System::String ^ inputUri, System::Xml::Xsl::XsltArgumentList ^ arguments, System::IO::Stream ^ results);

public void Transform(string inputUri, System.Xml.Xsl.XsltArgumentList? arguments, System.IO.Stream results);

public void Transform(string inputUri, System.Xml.Xsl.XsltArgumentList arguments, System.IO.Stream results);

member this.Transform : string * System.Xml.Xsl.XsltArgumentList * System.IO.Stream -> unit

Public Sub Transform (inputUri As String, arguments As XsltArgumentList, results As Stream)

Параметры

inputUri: String

Универсальный код ресурса (URI) входного документа.

arguments: XsltArgumentList

results: Stream

Поток, в который требуется вывести выходные данные.

Исключения

ArgumentNullException

Значение inputUri или results значение null.

XsltException

Произошла ошибка при выполнении преобразования XSLT.

DirectoryNotFoundException

Значение inputUri содержит имя файла или каталог, не удается найти.

WebException

Невозможно inputUri устранить значение.

–или–

Произошла ошибка при обработке запроса.

UriFormatException

inputUri недопустимый универсальный код ресурса (URI).

XmlException

Произошла ошибка синтаксического анализа загрузки входного документа.

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

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

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

Transform(IXPathNavigable, XmlWriter)

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

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

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

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

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

Выполняет преобразование с помощью входного документа, указанного IXPathNavigable объектом, и выводит результаты в объект XmlWriter.

public:
 void Transform(System::Xml::XPath::IXPathNavigable ^ input, System::Xml::XmlWriter ^ results);

public void Transform(System.Xml.XPath.IXPathNavigable input, System.Xml.XmlWriter results);

member this.Transform : System.Xml.XPath.IXPathNavigable * System.Xml.XmlWriter -> unit

Public Sub Transform (input As IXPathNavigable, results As XmlWriter)

Параметры

input: IXPathNavigable

results: XmlWriter

Значение XmlWriter , в которое требуется вывести данные.

Исключения

ArgumentNullException

Значение input или results значение null.

XsltException

Произошла ошибка при выполнении преобразования XSLT.

Примеры

В следующем примере выполняется преобразование XSLT и выходные данные объекта XmlWriter .

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

// Create the writer.
XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.IndentChars = "\t";
XmlWriter writer = XmlWriter.Create("output.xml", settings);

// Execute the transformation.
xslt.Transform(new XPathDocument("books.xml"), writer);
writer.Close();

' Load the style sheet.
Dim xslt As New XslCompiledTransform()
xslt.Load("output.xsl")
        
' Create the writer.
Dim settings As New XmlWriterSettings()
settings.Indent = True
settings.IndentChars = vbTab
Dim writer As XmlWriter = XmlWriter.Create("output.xml", settings)
        
' Execute the transformation.
xslt.Transform(New XPathDocument("books.xml"), writer)
writer.Close()

Класс XmlNode основан на объектной модели документа W3C (DOM) и включает возможности редактирования.
Класс XPathDocument — это хранилище данных только для чтения на основе модели данных XPath. XPathDocument — рекомендуемый класс для обработки XSLT. Он обеспечивает более высокую производительность по сравнению с классом XmlNode .

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

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

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

Transform(XmlReader, XmlWriter)

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

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

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

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

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

Выполняет преобразование с помощью входного документа, указанного XmlReader объектом, и выводит результаты в объект XmlWriter.

public:
 void Transform(System::Xml::XmlReader ^ input, System::Xml::XmlWriter ^ results);

public void Transform(System.Xml.XmlReader input, System.Xml.XmlWriter results);

member this.Transform : System.Xml.XmlReader * System.Xml.XmlWriter -> unit

Public Sub Transform (input As XmlReader, results As XmlWriter)

Параметры

input: XmlReader

Содержащий XmlReader входной документ.

results: XmlWriter

Значение XmlWriter , в которое требуется вывести данные.

Исключения

ArgumentNullException

Значение input или results значение null.

XsltException

Произошла ошибка при выполнении преобразования XSLT.

Примеры

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

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

// Create the writer.
XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.IndentChars = "\t";
XmlWriter writer = XmlWriter.Create("output.xml", settings);

XmlReader reader = XmlReader.Create("books.xml");
reader.MoveToContent();

// Execute the transformation.
xslt.Transform(reader, writer);
writer.Close();
reader.Close();

' Load the style sheet.
Dim xslt As New XslCompiledTransform()
xslt.Load("output.xsl")
        
' Create the writer.
Dim settings As New XmlWriterSettings()
settings.Indent = True
settings.IndentChars = vbTab
Dim writer As XmlWriter = XmlWriter.Create("output.xml", settings)
        
Dim reader As XmlReader = XmlReader.Create("books.xml")
reader.MoveToContent()
        
' Execute the transformation.
xslt.Transform(reader, writer)
writer.Close()
reader.Close()

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

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

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

Transform(String, XmlWriter)

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

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

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

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

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

Выполняет преобразование с помощью входного документа, указанного URI, и выводит результаты в объект XmlWriter.

public:
 void Transform(System::String ^ inputUri, System::Xml::XmlWriter ^ results);

public void Transform(string inputUri, System.Xml.XmlWriter results);

member this.Transform : string * System.Xml.XmlWriter -> unit

Public Sub Transform (inputUri As String, results As XmlWriter)

Параметры

inputUri: String

Универсальный код ресурса (URI) входного документа.

results: XmlWriter

Значение XmlWriter , в которое требуется вывести данные.

Исключения

ArgumentNullException

Значение inputUri или results значение null.

XsltException

Произошла ошибка при выполнении преобразования XSLT.

DirectoryNotFoundException

Значение inputUri содержит имя файла или каталог, не удается найти.

WebException

Невозможно inputUri устранить значение.

–или–

Произошла ошибка при обработке запроса.

UriFormatException

inputUri недопустимый универсальный код ресурса (URI).

XmlException

Произошла ошибка синтаксического анализа загрузки входного документа.

Примеры

В следующем примере выполняется преобразование XSLT и выходные данные объекта XmlWriter .

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

// Create the writer.
XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.IndentChars = "\t";
XmlWriter writer = XmlWriter.Create("output.xml", settings);

// Execute the transformation.
xslt.Transform("books.xml", writer);
writer.Close();

' Load the style sheet.
Dim xslt As New XslCompiledTransform()
xslt.Load("output.xsl")
        
' Create the writer.
Dim settings As New XmlWriterSettings()
settings.Indent = True
settings.IndentChars = vbTab
Dim writer As XmlWriter = XmlWriter.Create("output.xml", settings)
        
' Execute the transformation.
xslt.Transform("books.xml", writer)
writer.Close()

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

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

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

Transform(XmlReader, XsltArgumentList, XmlWriter, XmlResolver)

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

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

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

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

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

public:
 void Transform(System::Xml::XmlReader ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::Xml::XmlWriter ^ results, System::Xml::XmlResolver ^ documentResolver);

public void Transform(System.Xml.XmlReader input, System.Xml.Xsl.XsltArgumentList? arguments, System.Xml.XmlWriter results, System.Xml.XmlResolver? documentResolver);

public void Transform(System.Xml.XmlReader input, System.Xml.Xsl.XsltArgumentList arguments, System.Xml.XmlWriter results, System.Xml.XmlResolver documentResolver);

member this.Transform : System.Xml.XmlReader * System.Xml.Xsl.XsltArgumentList * System.Xml.XmlWriter * System.Xml.XmlResolver -> unit

Public Sub Transform (input As XmlReader, arguments As XsltArgumentList, results As XmlWriter, documentResolver As XmlResolver)

Параметры

input: XmlReader

Содержащий XmlReader входной документ.

arguments: XsltArgumentList

results: XmlWriter

Значение XmlWriter , в которое требуется вывести данные.

documentResolver: XmlResolver

Используется XmlResolver для разрешения функции XSLT document() . Если это nullтак, document() функция не разрешается.

Исключения

ArgumentNullException

Значение input или results значение null.

XsltException

Произошла ошибка при выполнении преобразования XSLT.

Примеры

В следующем примере используется для XmlSecureResolver разрешения функции XSLT document() .

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

XsltSettings settings = new XsltSettings();
settings.EnableDocumentFunction = true;

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

// Transform the file.
using (XmlReader reader = XmlReader.Create("books.xml"))
{
   using (XmlWriter writer = XmlWriter.Create("output.xml"))
   {
      xslt.Transform(reader, null, writer, resolver);
   }
}

' Create a resolver and specify the necessary credentials.
Dim resolver As New XmlSecureResolver(New XmlUrlResolver(), "http://serverName/data/")
Dim myCred As System.Net.NetworkCredential
myCred = New System.Net.NetworkCredential(UserName, SecurelyStoredPassword, Domain)
resolver.Credentials = myCred
        
Dim settings As New XsltSettings()
settings.EnableDocumentFunction = True
        
' Load the style sheet.
Dim xslt As New XslCompiledTransform()
xslt.Load("http://serverName/data/xsl/sort.xsl", settings, resolver)
        
' Transform the file.
        Using reader As XmlReader = XmlReader.Create("books.xml")

            Using writer As XmlWriter = XmlWriter.Create("output.xml")
                xslt.Transform(reader, Nothing, writer, resolver)
            End Using

        End Using

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

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

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

Transform(String, XsltArgumentList, XmlWriter)

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

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

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

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

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

Выполняет преобразование с помощью входного документа, указанного URI, и выводит результаты в объект XmlWriter. Предоставляет XsltArgumentList дополнительные аргументы во время выполнения.

public:
 void Transform(System::String ^ inputUri, System::Xml::Xsl::XsltArgumentList ^ arguments, System::Xml::XmlWriter ^ results);

public void Transform(string inputUri, System.Xml.Xsl.XsltArgumentList? arguments, System.Xml.XmlWriter results);

public void Transform(string inputUri, System.Xml.Xsl.XsltArgumentList arguments, System.Xml.XmlWriter results);

member this.Transform : string * System.Xml.Xsl.XsltArgumentList * System.Xml.XmlWriter -> unit

Public Sub Transform (inputUri As String, arguments As XsltArgumentList, results As XmlWriter)

Параметры

inputUri: String

Универсальный код ресурса (URI) входного документа.

arguments: XsltArgumentList

results: XmlWriter

Значение XmlWriter , в которое требуется вывести данные.

Исключения

ArgumentNullException

Значение inputUri или results значение null.

XsltException

Произошла ошибка при выполнении преобразования XSLT.

DirectoryNotFoundException

Значение inputUri содержит имя файла или каталог, не удается найти.

WebException

Невозможно inputUri устранить значение.

–или–

Произошла ошибка при обработке запроса.

UriFormatException

inputUri недопустимый универсальный код ресурса (URI).

XmlException

Произошла ошибка синтаксического анализа загрузки входного документа.

Примеры

В следующем примере объект используется XsltArgumentList для создания параметра, представляющего текущую дату и время.

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

public class Sample
{

    public static void Main()
    {

        // Create the XslCompiledTransform and load the stylesheet.
        XslCompiledTransform xslt = new XslCompiledTransform();
        xslt.Load("order.xsl");

        // Create the XsltArgumentList.
        XsltArgumentList xslArg = new XsltArgumentList();

        // Create a parameter which represents the current date and time.
        DateTime d = DateTime.Now;
        xslArg.AddParam("date", "", d.ToString());

        // Transform the file.
        using (XmlWriter w = XmlWriter.Create("output.xml"))
        {
            xslt.Transform("order.xml", xslArg, w);
        }
    }
}

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

Public Class Sample

    Public Shared Sub Main()

        ' Create the XslCompiledTransform and load the stylesheet.
        Dim xslt As New XslCompiledTransform()
        xslt.Load("order.xsl")

        ' Create the XsltArgumentList.
        Dim xslArg As New XsltArgumentList()

        ' Create a parameter which represents the current date and time.
        Dim d As DateTime = DateTime.Now
        xslArg.AddParam("date", "", d.ToString())

        Using w As XmlWriter = XmlWriter.Create("output.xml")
            ' Transform the file.
            xslt.Transform("order.xml", xslArg, w)
        End Using

    End Sub
End Class

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

order.xml

<!--Represents a customer order-->
<order>
  <book ISBN='10-861003-324'>
    <title>The Handmaid's Tale</title>
    <price>19.95</price>
  </book>
  <cd ISBN='2-3631-4'>
    <title>Americana</title>
    <price>16.95</price>
  </cd>
</order>

order.xsl

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
  <xsl:param name="date"/>
  <xsl:template match="/">
    <order>
      <date><xsl:value-of select="$date"/></date>
      <total><xsl:value-of select="sum(//price)"/></total>
    </order>
  </xsl:template>
</xsl:stylesheet>

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

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

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

Transform(IXPathNavigable, XsltArgumentList, XmlWriter, XmlResolver)

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

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

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

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

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

public:
 void Transform(System::Xml::XPath::IXPathNavigable ^ input, System::Xml::Xsl::XsltArgumentList ^ arguments, System::Xml::XmlWriter ^ results, System::Xml::XmlResolver ^ documentResolver);

public void Transform(System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList? arguments, System.Xml.XmlWriter results, System.Xml.XmlResolver? documentResolver);

public void Transform(System.Xml.XPath.IXPathNavigable input, System.Xml.Xsl.XsltArgumentList arguments, System.Xml.XmlWriter results, System.Xml.XmlResolver documentResolver);

member this.Transform : System.Xml.XPath.IXPathNavigable * System.Xml.Xsl.XsltArgumentList * System.Xml.XmlWriter * System.Xml.XmlResolver -> unit

Public Sub Transform (input As IXPathNavigable, arguments As XsltArgumentList, results As XmlWriter, documentResolver As XmlResolver)

Параметры

input: IXPathNavigable

Документ для преобразования, указанного IXPathNavigable объектом.

arguments: XsltArgumentList

Список аргументов как XsltArgumentList.

results: XmlWriter

Значение XmlWriter , в которое требуется вывести данные.

Если таблица стилей xsl:output содержит элемент, необходимо создать XmlWriter его с помощью XmlWriterSettings объекта, возвращаемого из OutputSettings свойства. Это гарантирует наличие XmlWriter правильных параметров выходных данных.

documentResolver: XmlResolver

Используется XmlResolver для разрешения функции XSLT document() . Если это nullтак, document() функция не разрешается.

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

Кері байланыс

Бет пайдалы болды ма?

XslCompiledTransform.Transform Метод

Определение

Перегрузки

Комментарии

Transform(XmlReader, XsltArgumentList, TextWriter)

Параметры

Исключения

Комментарии

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

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

Transform(IXPathNavigable, XsltArgumentList, XmlWriter)

Параметры

Исключения

Комментарии

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

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

Transform(IXPathNavigable, XsltArgumentList, TextWriter)

Параметры

Исключения

Комментарии

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

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

Transform(IXPathNavigable, XsltArgumentList, Stream)

Параметры

Исключения

Примеры

Комментарии

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

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

Transform(XmlReader, XsltArgumentList, XmlWriter)

Параметры

Исключения

Комментарии

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

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

Transform(XmlReader, XsltArgumentList, Stream)

Параметры

Исключения

Комментарии

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

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

Transform(String, String)

Параметры

Исключения

Примеры

Комментарии

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

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

Transform(String, XsltArgumentList, TextWriter)

Параметры

Исключения

Примеры

Комментарии

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

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

Transform(String, XsltArgumentList, Stream)

Параметры

Исключения

Комментарии

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

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

Transform(IXPathNavigable, XmlWriter)

Параметры

Исключения

Примеры

Комментарии

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

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

Transform(XmlReader, XmlWriter)

Параметры

Исключения

Примеры

Комментарии

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

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

Transform(String, XmlWriter)

Параметры

Исключения

Примеры

Комментарии