XsltArgumentList.AddParam メソッド

.NET Framework クラス ライブラリ リファレンス

XsltArgumentList.AddParam メソッド

パラメータを XsltArgumentList に追加し、それを名前空間限定名に関連付けます。

名前空間: System.Xml.Xsl
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Sub AddParam ( _
    name As String, _
    namespaceUri As String, _
    parameter As Object _
)

Visual Basic (使用法)

Dim instance As XsltArgumentList
Dim name As String
Dim namespaceUri As String
Dim parameter As Object

instance.AddParam(name, namespaceUri, parameter)

C#

public void AddParam (
    string name,
    string namespaceUri,
    Object parameter
)

C++

public:
void AddParam (
    String^ name, 
    String^ namespaceUri, 
    Object^ parameter
)

J#

public void AddParam (
    String name, 
    String namespaceUri, 
    Object parameter
)

JScript

public function AddParam (
    name : String, 
    namespaceUri : String, 
    parameter : Object
)

パラメータ

name

パラメータに関連付ける名前。

namespaceUri

パラメータに関連付ける名前空間 URI。既定の名前空間を使用するには、空の文字列を指定します。

parameter

リストに追加するパラメータ値またはオブジェクト。

例外

例外の種類	条件
ArgumentException	namespaceUri が null 参照 (Visual Basic では Nothing) または http://www.w3.org/1999/XSL/Transform です。 name が、W3C XML 仕様に準拠した有効な名前ではありません。 namespaceUri には、既にパラメータが関連付けられています。

解説

parameter は W3C 仕様の型に対応している必要があります。W3C 仕様の型 (XPath または XSLT のいずれか)、および対応する .NET クラスを次の表に示します。

W3C 仕様の型	対応する .NET クラス (型)
String (XPath)	String
Boolean (XPath)	Boolean
Number (XPath)	Double
Result Tree Fragment (XSLT)	XPathNavigator
Node Set (XPath)	XPathNodeIterator XPathNavigator[]
Node* (XPath)	XPathNavigator

* これは、単一ノードを含んでいるノード セットと等価です。

パラメータ オブジェクトが上のいずれかでない場合は、次の規則に従って変換されます。CLR 数値型は、Double に変換されます。DateTime 型は、String に変換されます。IXPathNavigable 型は、XPathNavigator に変換されます。XPathNavigator[] 型は、XPathNodeIterator に変換されます。

これ以外の型はすべて、エラーがスローされます。

使用例

AddParam メソッドを使用して、現在の日付と時刻を表すパラメータを作成する例を次に示します。

Visual Basic

Imports System
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())
        
        ' Transform the file.
        xslt.Transform("order.xml", xslArg, XmlWriter.Create("output.xml"))
    
    End Sub 'Main 
End Class 'Sample

C#

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.
     xslt.Transform("order.xml", xslArg, XmlWriter.Create("output.xml"));
    
  }
}

C++

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
using namespace System::Xml::XPath;
using namespace System::Xml::Xsl;
int main()
{
   
   // Create the XslCompiledTransform and load the stylesheet.
   XslCompiledTransform^ xslt = gcnew XslCompiledTransform;
   xslt->Load( "order.xsl" );
 
   // Create the XsltArgumentList.
   XsltArgumentList^ xslArg = gcnew XsltArgumentList;
   
   // Create a parameter which represents the current date and time.
   DateTime d = DateTime::Now;
   xslArg->AddParam( "date", "", d );
      
   // Transform the file.
   xslt->Transform("order.xml", xslArg, XmlWriter::Create("output.xml"));
}

J#

import System.*;
import System.IO.*;
import System.Xml.*;
import System.Xml.XPath.*;
import System.Xml.Xsl.*;

public class Sample
{

    public static void main(String[]
 args)
    {
        // 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.get_Now();
        xslArg.AddParam("date", "", d.ToString());

        // Transform the file.
        xslt.Transform("order.xml", xslArg, XmlWriter.Create("output.xml"));
  
    } //main 
} //Sample

この例では、次の 2 つのデータ ファイルを入力として使用しています。

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>

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
XsltArgumentList クラス
XsltArgumentList メンバ
System.Xml.Xsl 名前空間
その他の技術情報
XSLT 拡張オブジェクト
XSLT パラメータ
XslCompiledTransform クラスの使用