XsltMessageEncounteredEventArgs クラス

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

XsltMessageEncounteredEventArgs クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

XsltMessageEncountered イベントのデータを提供します。

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

Visual Basic (宣言)

Public MustInherit Class
 XsltMessageEncounteredEventArgs
    Inherits EventArgs

Visual Basic (使用法)

Dim instance As XsltMessageEncounteredEventArgs

C#

public abstract class XsltMessageEncounteredEventArgs
 : EventArgs

C++

public ref class XsltMessageEncounteredEventArgs
 abstract : public EventArgs

J#

public abstract class XsltMessageEncounteredEventArgs
 extends EventArgs

JScript

public abstract class XsltMessageEncounteredEventArgs
 extends EventArgs

解説

スタイル シートに xsl:message が指定されている場合、XSLT の処理中に XsltMessageEncountered イベントが発生します。

メモ
terminate 属性が "yes" に設定されている場合、XSLT プロセッサは、メッセージの処理後、スタイル シートの実行を中止します。

使用例

XsltMessageEncounteredEventArgs を使用して、xsl:message の内容をコンソールに表示する方法を次の例に示します。サンプルを実行すると、"Message received: Author name is not in the correct format <author><name>Plato</name></author>" というメッセージがコンソールに出力されます。

Visual Basic

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

Public Class Sample    
    
  Public Shared Sub Main()
 
        
    ' Create the XslCompiledTransform object and load the style sheet.
    Dim xslt As New XslCompiledTransform()
    xslt.Load("message.xsl")
        
    Dim argList As New XsltArgumentList()
    AddHandler argList.XsltMessageEncountered, AddressOf
 MessageCallBack
        
    ' Load the file to transform.
    Dim doc As New XPathDocument("books.xml")
        
    ' Transform the file.
    xslt.Transform(doc, argList, XmlWriter.Create("output.xml"))
    
  End Sub 'Main     
    
  Private Shared Sub MessageCallBack(ByVal
 sender As Object, ByVal
 e As XsltMessageEncounteredEventArgs) 
    Console.WriteLine("Message received: {0}", e.Message)
    
  End Sub 'MessageCallBack
End Class 'Sample 

C#

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

public class Sample {

  public static void Main()
 {

    // Create the XslCompiledTransform object and load the style sheet.
    XslCompiledTransform xslt = new XslCompiledTransform();
    xslt.Load("message.xsl");

    XsltArgumentList argList = new XsltArgumentList();
    argList.XsltMessageEncountered += new XsltMessageEncounteredEventHandler(MessageCallBack);
    
    // Load the file to transform.
    XPathDocument doc = new XPathDocument("books.xml");

    // Transform the file.
    xslt.Transform(doc, argList, XmlWriter.Create("output.xml"));

  }

  private static void MessageCallBack(object
 sender, XsltMessageEncounteredEventArgs e) {
    Console.WriteLine("Message received: {0}", e.Message);
  }

}

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

books.xml

<bookstore>
  <book genre="autobiography"
 publicationdate="1981" ISBN="1-861003-11-0">
    <title>The Autobiography
 of Benjamin Franklin</title>
    <author>
      <first-name>Benjamin</first-name>
      <last-name>Franklin</last-name>
    </author>
    <price>8.99</price>
  </book>
  <book genre="novel" publicationdate="1967"
 ISBN="0-201-63361-2">
    <title>The Confidence
 Man</title>
    <author>
      <first-name>Herman</first-name>
      <last-name>Melville</last-name>
    </author>
    <price>11.99</price>
  </book>
  <book genre="philosophy" publicationdate="1991"
 ISBN="1-861001-57-6">
    <title>The Gorgias</title>
    <author>
      <name>Plato</name>
    </author>
    <price>9.99</price>
  </book>
</bookstore>

message.xsl

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
 version="1.0">
  <xsl:output method="xml" omit-xml-declaration="yes"/>

<xsl:template match="/">
     <xsl:apply-templates select="*"/>
     <xsl:copy-of select="."/>
  </xsl:template>

  <xsl:template match="*">
     <xsl:apply-templates select="//author"/>
  </xsl:template>

  <xsl:template match="author">
    <xsl:if test="not (last-name)">
       <xsl:message terminate="no">Author
 name is not in the correct format <xsl:copy-of
 select="."/>
       </xsl:message>
    </xsl:if>
  </xsl:template>

</xsl:stylesheet>

継承階層

System.Object
   System.EventArgs
    System.Xml.Xsl.XsltMessageEncounteredEventArgs

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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

参照

関連項目
XsltMessageEncounteredEventArgs メンバ
System.Xml.Xsl 名前空間
XsltArgumentList クラス