XsltArgumentList.AddParam(String, String, Object) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Добавляет параметр в XsltArgumentList и связывает его с проверенным именем пространства имен.
public:
void AddParam(System::String ^ name, System::String ^ namespaceUri, System::Object ^ parameter);
public void AddParam (string name, string namespaceUri, object parameter);
member this.AddParam : string * string * obj -> unit
Public Sub AddParam (name As String, namespaceUri As String, parameter As Object)
Параметры
- name
- String
Имя для связи с параметром.
- namespaceUri
- String
URI пространства имен для связи с параметром. Чтобы использовать пространство имен по умолчанию, укажите пустую строку.
- parameter
- Object
Значение параметра или объект, который требуется добавить в список.
Исключения
namespaceUri
имеет значение null
или http://www.w3.org/1999/XSL/Transform.
name
не является допустимым именем в соответствии со спецификацией W3C XML.
namespaceUri
уже имеет ассоциированный с ним параметр.
Примеры
В следующем примере метод используется AddParam для создания параметра, представляющего текущую дату и время.
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>
Комментарии
Должен parameter
соответствовать типу W3C. В следующей таблице показаны типы W3C, XPath или XSLT, а также класс corresponding.NET.
Тип W3C | Класс Equivalent.NET (тип) |
---|---|
String (XPath) |
String |
Boolean (XPath) |
Boolean |
Number (XPath) |
Double |
Result Tree Fragment (XSLT) |
XPathNavigator |
Node Set (XPath) |
XPathNodeIteratorXPathNavigator[] |
Node * (XPath) |
XPathNavigator |
*Это эквивалентно набору узлов, содержащему единственный узел.
Если объект параметра, вызываемый из таблицы стилей, не является одним из указанных выше, он преобразуется в соответствии со следующими правилами:
Числовые типы среды CLR преобразуются в Double.
Типы IXPathNavigable преобразуются в типы XPathNavigator.
XPathNavigator[]
преобразуется в XPathNodeIterator.
Все другие типы вызывают ошибку.