チュートリアル: XSLT 階層の使用

[アーティクル]
08/31/2012

XSLT 階層ツールは、多くの XML 開発タスクを簡素化します。XSLT スタイルシートには、多くの場合 includes 命令および imports 命令が使用されています。コンパイルはプリンシパルスタイルシートから開始されますが、XSLT スタイルシートのコンパイル結果としてエラーが表示された場合、プリンシパルスタイルシート以外のものがエラーの原因である可能性があります。エラーを修正するか、スタイルシートを編集するには、インクルードまたはインポートされたスタイルシートへのアクセスが必要になる場合があります。デバッガーでスタイルシートをステップ実行すると、インクルードまたはインポートされたスタイルシートが開かれる場合があり、1 つまたは複数のインクルードされたスタイルシートにブレークポイントを追加することができます。

XSLT 階層ツールが役立つ別のシナリオとして、ビルトインテンプレート規則にブレークポイントを挿入することがあります。テンプレート規則は、スタイルシートの各モードに対して生成される特別なテンプレートであり、ノードに該当するテンプレートが他にない場合に、xsl:apply-templates により呼び出されます。ビルトインテンプレート規則でデバッグを実行するには、XSLT デバッガーで一時フォルダーに規則のファイルを作成し、プリンシパルスタイルシートと共にコンパイルします。何らかの xsl:apply-template からコードへのステップインを実行しないと、プリンシパルスタイルシートにインクルードされたスタイルシートを探したり、ビルトインテンプレート規則を持つスタイルシートを探して開くことが困難になる場合があります。

このトピックの例には、参照されるスタイルシート内のデバッグが示されています。

手順

Visual Studio で XML ドキュメントを開きます。この例では、次の collection.xml ドキュメントを使用しています。

<?xml version="1.0" encoding="utf-8"?>
<?xml-stylesheet type="text/xsl" href="xslinclude.xsl"?>
<COLLECTION>
  <BOOK>
    <TITLE>Lover Birds</TITLE>
    <AUTHOR>Cynthia Randall</AUTHOR>
    <PUBLISHER>Lucerne Publishing</PUBLISHER>
  </BOOK>
  <BOOK>
    <TITLE>The Sundered Grail</TITLE>
    <AUTHOR>Eva Corets</AUTHOR>
    <PUBLISHER>Lucerne Publishing</PUBLISHER>
  </BOOK>
  <BOOK>
    <TITLE>Splish Splash</TITLE>
    <AUTHOR>Paula Thurman</AUTHOR>
    <PUBLISHER>Scootney</PUBLISHER>
  </BOOK>
</COLLECTION>

次の xslincludefile.xsl を追加します。

<?xml version='1.0'?>
<xsl:stylesheet version="1.0"
      xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
      xml:space="preserve">

<xsl:template match="TITLE">
   Title - <xsl:value-of select="."/><BR/>
</xsl:template>

<xsl:template match="AUTHOR">
   Author - <xsl:value-of select="."/><BR/>
</xsl:template>

<xsl:template match="PUBLISHER">
   Publisher - <xsl:value-of select="."/><BR/><!-- removed second <BR/> -->
</xsl:template>

</xsl:stylesheet>

次の xslinclude.xsl ファイルを追加します。

<?xml version='1.0'?>
<xsl:stylesheet version="1.0"
      xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

  <xsl:output method="xml" omit-xml-declaration="yes"/>

  <xsl:template match="/">
    <xsl:for-each select="COLLECTION/BOOK">
      <xsl:apply-templates select="TITLE"/>
      <xsl:apply-templates select="AUTHOR"/>
      <xsl:apply-templates select="PUBLISHER"/>
      <BR/>
      <!-- add this -->
    </xsl:for-each>
  </xsl:template>

  <!-- The following template rule will not be called,
  because the related template in the including stylesheet
  is called. If we move this template so that
  it follows the xsl:include instruction, this one
  will be called instead.-->
  <xsl:template match="TITLE">
    <DIV STYLE="color:blue">
      Title: <xsl:value-of select="."/>
    </DIV>
  </xsl:template>

  <xsl:include href="xslincludefile.xsl" />
</xsl:stylesheet>

<xsl:include href="xslincludefile.xsl" /> 命令にブレークポイントを追加します。
デバッグを開始します。
デバッガーが <xsl:include href="xslincludefile.xsl" /> 命令で停止したときに、ステップインボタンを押します。参照されるスタイルシート内でデバッグを継続することができます。階層が表示され、デザイナーに正しいパスが示されます。

次の方法で共有

チュートリアル: XSLT 階層の使用

手順

関連項目

タスク

その他のリソース