msxsl:script를 사용하는 스크립트 블록

XslCompiledTransform 클래스는 msxsl:script 요소를 사용하여 포함된 스크립트를 지원합니다. 스타일시트가 로드되면 정의된 함수는 CodeDOM(코드 문서 개체 모델)에 의해 CIL(공용 중간 언어)로 컴파일되고 런타임 중에 실행됩니다. 포함된 스크립트 블록에서 생성된 어셈블리는 스타일시트에 대해 생성된 어셈블리와 별개입니다.

XSLT 스크립트 사용

포함된 스크립트에 대한 지원은 XslCompiledTransform 클래스의 선택적 XSLT 설정입니다. 스크립트 지원은 기본적으로 사용하지 않도록 설정되어 있습니다. 스크립트 지원을 사용하도록 설정하려면 속성이 XsltSettings 설정된 EnableScript 개체를 true 만들고 개체를 메서드에 Load 전달합니다.

msxsl:script 요소 정의

이 msxsl:script 요소는 XSLT 1.0 권장 사항에 대한 Microsoft 확장이며 다음 정의를 가집니다.

<msxsl:script language = "language-name" implements-prefix = "prefix of user namespace"> </msxsl:script>

msxsl 접두사는 네임스페이스 URI에 urn:schemas-microsoft-com:xslt 바인딩됩니다. 스타일시트에는 네임스페이스 선언이 xmlns:msxsl=urn:schemas-microsoft-com:xslt 포함되어야 합니다.

language 특성은 선택 사항입니다. 해당 값은 포함된 코드 블록의 코드 언어입니다. 언어는 CodeDomProvider.CreateProvider 메서드를 사용하여 적합한 CodeDOM 컴파일러에 매핑됩니다. 클래스는 XslCompiledTransform 적절한 공급자가 컴퓨터에 설치되어 있고 machine.config 파일의 system.codedom 섹션에 등록되어 있다고 가정하여 Microsoft .NET 언어를 지원할 수 있습니다. language 특성을 지정하지 않으면 언어가 기본적으로 JScript로 설정됩니다. 언어 이름은 대/소문자를 구분하지 않으므로 'JavaScript' 및 'javascript'는 동일합니다.

특성은 implements-prefix 필수입니다. 이 특성은 네임스페이스를 선언하고 스크립트 블록과 연결하는 데 사용됩니다. 이 특성의 값은 네임스페이스를 나타내는 접두사입니다. 이 접두사는 스타일시트 어딘가에 정의할 수 있습니다.

<msxsl:script implements-prefix='your-prefix' language='CSharp'>
<![CDATA[
// Code block.
]]>
</msxsl:script>

스크립트 함수

함수는 요소 내에서 msxsl:script 선언할 수 있습니다. 함수가 선언되면 스크립트 블록에 포함됩니다. 스타일시트에는 각각 서로 독립적으로 작동하는 여러 스크립트 블록이 포함될 수 있습니다. 즉, 스크립트 블록 내에서 실행하는 경우 동일한 네임스페이스와 동일한 스크립팅 언어로 선언되지 않는 한 다른 스크립트 블록에서 정의한 함수를 호출할 수 없습니다. 각 스크립트 블록은 자체 언어로 되어 있을 수 있으며 해당 언어 파서의 문법 규칙에 따라 블록이 구문 분석되므로 사용 중인 언어에 올바른 구문을 사용하는 것이 좋습니다. 예를 들어 Microsoft C# 스크립트 블록에 있는 경우 C# 주석 구문을 사용합니다.

함수에 제공된 인수 및 반환 값은 모든 형식일 수 있습니다. W3C XPath 형식은 CLR(공용 언어 런타임) 형식의 하위 집합이므로 형식 변환은 XPath 형식으로 간주되지 않는 형식에서 발생합니다. 다음 표에서는 해당 W3C 형식 및 동등한 CLR 형식을 보여 있습니다.

CLR 숫자 형식은 .로 Double변환됩니다. 형식이 DateTime .로 String변환됩니다. IXPathNavigable 형식이 .로 XPathNavigator변환됩니다. XPathNavigator[]가 XPathNodeIterator로 변환됩니다.

다른 모든 유형은 오류를 발생시킵니다.

네임스페이스 및 어셈블리 가져오기

XslCompiledTransform 클래스는 msxsl:script 요소에서 기본적으로 지원되는 어셈블리 및 네임스페이스 집합을 미리 정의합니다. 그러나 msxsl:script 블록 내에서 어셈블리와 네임스페이스를 가져와서 미리 정의된 목록에 없는 네임스페이스에 속하는 클래스와 멤버를 사용할 수 있습니다.

어셈블리

다음 두 어셈블리는 기본적으로 참조됩니다.

• System.dll

• System.Xml.dll

• Microsoft.VisualBasic.dll(스크립트 언어가 VB인 경우)

msxsl:assembly 요소를 사용하여 추가 어셈블리를 가져올 수 있습니다. 여기에는 스타일시트가 컴파일될 때의 어셈블리가 포함됩니다. msxsl:assembly 요소의 정의는 다음과 같습니다.

<msxsl:script>
  <msxsl:assembly name="system.assemblyName" />
  <msxsl:assembly href="path-name" />
    <![CDATA[
    // User code
    ]]>
</msxsl:script>

name 속성은 어셈블리의 이름을 포함하고, href 속성은 어셈블리의 경로를 포함합니다. 어셈블리 이름은 전체 이름(예: "System.Data, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089") 또는 "System.Web"과 같은 짧은 이름일 수 있습니다.

네임스페이스

기본적으로 다음 네임스페이스가 포함됩니다.

• 시스템

• System.Collection

• System.Text

• System.Text.RegularExpressions

• System.Xml

• System.Xml.Xsl

• System.Xml.XPath

• Microsoft.VisualBasic(스크립트 언어가 VB인 경우)

특성을 사용하여 namespace 추가 네임스페이스에 대한 지원을 추가할 수 있습니다. 특성 값은 네임스페이스의 이름입니다.

<msxsl:script>
  <msxsl:using namespace="system.namespaceName" />
    <![CDATA[
    // User code
    ]]>
</msxsl:script>

예시

다음 예제에서는 포함된 스크립트를 사용하여 반지름이 지정된 원의 둘레를 계산합니다.

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

public class Sample {

  private const String filename = "number.xml";
  private const String stylesheet = "calc.xsl";

  public static void Main() {

    // Compile the style sheet.
    XsltSettings xslt_settings = new XsltSettings();
    xslt_settings.EnableScript = true;
    XslCompiledTransform xslt = new XslCompiledTransform();
    xslt.Load(stylesheet, xslt_settings, new XmlUrlResolver());

    // Load the XML source file.
    XPathDocument doc = new XPathDocument(filename);

    // Create an XmlWriter.
    XmlWriterSettings settings = new XmlWriterSettings();
    settings.OmitXmlDeclaration = true;
    settings.Indent = true;
    XmlWriter writer = XmlWriter.Create("output.xml", settings);

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

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

Public class Sample

    Private Const filename As String = "number.xml"
    Private Const stylesheet As String = "calc.xsl"

    Public Shared Sub Main()

        ' Compile the style sheet.
        Dim xslt_settings As XsltSettings = New XsltSettings()
        xslt_settings.EnableScript = true
        Dim xslt As XslCompiledTransform = New XslCompiledTransform()
        xslt.Load(stylesheet, xslt_settings, New XmlUrlResolver())

        ' Load the XML source file.
        Dim doc As XPathDocument = New XPathDocument(filename)

        ' Create an XmlWriter.
        Dim settings As XmlWriterSettings = New XmlWriterSettings()
        settings.OmitXmlDeclaration = true
        settings.Indent = true
        Dim writer As XmlWriter = XmlWriter.Create("output.xml", settings)

        ' Execute the transformation.
        xslt.Transform(doc, writer)
        writer.Close()
    End Sub
End Class

number.xml

<?xml version='1.0'?>
<data>
  <circle>
    <radius>12</radius>
  </circle>
  <circle>
    <radius>37.5</radius>
  </circle>
</data>

calc.xsl

<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 circumference(double radius){
    double pi = 3.14;
    double circ = pi*radius*2;
    return circ;
  }
  ]]>
  </msxsl:script>
  <xsl:template match="data">
    <circles>
      <xsl:for-each select="circle">
        <circle>
          <xsl:copy-of select="node()"/>
          <circumference>
            <xsl:value-of select="user:circumference(radius)"/>
          </circumference>
        </circle>
      </xsl:for-each>
    </circles>
  </xsl:template>
</xsl:stylesheet>

출력

<circles xmlns:msxsl="urn:schemas-microsoft-com:xslt" xmlns:user="urn:my-scripts">
  <circle>
    <radius>12</radius>
    <circumference>75.36</circumference>
  </circle>
  <circle>
    <radius>37.5</radius>
    <circumference>235.5</circumference>
  </circle>
</circles>

참고하십시오

• XSLT 변환
• 동적 소스 코드 생성 및 컴파일