XsltArgumentList.AddParam メソッドとは何？わかりやすく解説 Weblio辞書

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

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

C++

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

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 には、既にパラメータが関連付けられています。

例外の種類

条件

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

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

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>