XmlReaderSettings.ValidationEventHandler イベント

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

XmlReaderSettings.ValidationEventHandler イベント

メモ : このイベントは、.NET Framework version 2.0 で新しく追加されたものです。

リーダーが検証エラーを検出すると発生します。

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

Visual Basic (宣言)

Public Event ValidationEventHandler As
 ValidationEventHandler

Visual Basic (使用法)

Dim instance As XmlReaderSettings
Dim handler As ValidationEventHandler

AddHandler instance.ValidationEventHandler, handler

C#

public event ValidationEventHandler ValidationEventHandler

C++

public:
event ValidationEventHandler^ ValidationEventHandler {
    void add (ValidationEventHandler^ value);
    void remove (ValidationEventHandler^ value);
}

J#

/** @event */
public void add_ValidationEventHandler (ValidationEventHandler
 value)

/** @event */
public void remove_ValidationEventHandler (ValidationEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

これらのイベントは、ValidationType が DTD または Schema に設定されている場合に、XML インスタンス ドキュメントを読み取ると発生します。ValidationFlags プロパティで ReportValidationWarnings 設定が有効になっている場合は、検証警告が検出されたときにもこれらのイベントが発生します。

リーダーが検証用に構成され、検証イベント ハンドラが設定されていない場合は、すべての検証エラーに対して XmlSchemaValidationException がスローされます (検証警告では XmlSchemaValidationException はスローされません)。

セキュリティに関するメモ

検証エラー メッセージによって、コンテンツ モデルの機密情報が公開される場合があります。検証エラー メッセージと検証警告メッセージは、ValidationEventHandler デリゲートを使用して処理されます。ただし XmlReaderSettings オブジェクトにイベント ハンドラが用意されていない場合は、XmlSchemaValidationException として公開されます (検証の警告では XmlSchemaValidationException がスローされません)。信頼関係のないシナリオでは、このコンテンツ モデル情報を公開しないでください。既定では検証警告メッセージは表示されません。ReportValidationWarnings フラグを設定するとこのメッセージを報告できます。 XmlSchemaValidationException の SourceUri プロパティは、例外が発生する原因となったスキーマ ファイルへの URI パスを返します。信頼関係のないシナリオでは、SourceUri プロパティを公開しないでください。

使用例

インライン スキーマを使用して検証を行い、検証警告も表示するリーダーを作成するように指定する設定の例を次に示します。検証イベント ハンドラは、XmlSeverityType 列挙体を使用して警告とエラーを区別します。

Visual Basic

Imports System
Imports System.Xml
Imports System.Xml.Schema
Imports System.IO

public class ValidXSD 

  public shared sub Main()
 

    ' Set the validation settings.
    Dim settings as XmlReaderSettings = new
 XmlReaderSettings()
    settings.ValidationType = ValidationType.Schema
    settings.ValidationFlags = settings.ValidationFlags Or XmlSchemaValidationFlags.ProcessInlineSchema
    settings.ValidationFlags = settings.ValidationFlags Or XmlSchemaValidationFlags.ReportValidationWarnings
      AddHandler settings.ValidationEventHandler, AddressOf
 ValidationCallBack

    ' Create the XmlReader object.
    Dim reader as XmlReader = XmlReader.Create("inlineSchema.xml",
 settings)

    ' Parse the file. 
    while (reader.Read())
    end while
  end sub

  ' Display any warnings or errors.
  private shared sub ValidationCallBack
 (sender as object, args as
 ValidationEventArgs)
     if (args.Severity=XmlSeverityType.Warning)
       Console.WriteLine("   Warning: Matching schema not found.
  No validation occurred." + args.Message)
     else
        Console.WriteLine("   Validation error: "
 + args.Message)
     end if
  end sub 

end class 

C#

using System;
using System.Xml;
using System.Xml.Schema;
using System.IO;

public class ValidXSD {

  public static void Main()
 {

    // Set the validation settings.
    XmlReaderSettings settings = new XmlReaderSettings();
    settings.ValidationType = ValidationType.Schema;
    settings.ValidationFlags |= XmlSchemaValidationFlags.ProcessInlineSchema;
    settings.ValidationFlags |= XmlSchemaValidationFlags.ReportValidationWarnings;
    settings.ValidationEventHandler += new ValidationEventHandler
 (ValidationCallBack);

    // Create the XmlReader object.
    XmlReader reader = XmlReader.Create("inlineSchema.xml", settings);

    // Parse the file. 
    while (reader.Read());
    
  }

  // Display any warnings or errors.
  private static void ValidationCallBack
 (object sender, ValidationEventArgs args) {
     if (args.Severity==XmlSeverityType.Warning)
       Console.WriteLine("\tWarning: Matching schema not found.  No validation
 occurred." + args.Message);
     else
        Console.WriteLine("\tValidation error: " + args.Message);

  }  

}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
XmlReaderSettings クラス
XmlReaderSettings メンバ
System.Xml 名前空間
その他の技術情報
XML リーダーの作成
XmlReader による XML データの検証