XmlReaderSettings.ValidationFlags プロパティ

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

XmlReaderSettings.ValidationFlags プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

スキーマ検証の設定を示す値を取得または設定します。この設定は、XmlReader オブジェクトを検証するスキーマに適用します (ValidationType.Schema に設定された ValidationType プロパティ)。

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

Visual Basic (宣言)

Public Property ValidationFlags As
 XmlSchemaValidationFlags

Visual Basic (使用法)

Dim instance As XmlReaderSettings
Dim value As XmlSchemaValidationFlags

value = instance.ValidationFlags

instance.ValidationFlags = value

C#

public XmlSchemaValidationFlags ValidationFlags { get;
 set; }

C++

public:
property XmlSchemaValidationFlags ValidationFlags {
    XmlSchemaValidationFlags get ();
    void set (XmlSchemaValidationFlags value);
}

J#

/** @property */
public XmlSchemaValidationFlags get_ValidationFlags ()

/** @property */
public void set_ValidationFlags (XmlSchemaValidationFlags
 value)

JScript

public function get ValidationFlags
 () : XmlSchemaValidationFlags

public function set ValidationFlags
 (value : XmlSchemaValidationFlags)

プロパティ値
一連の XmlSchemaValidationFlags 値。ProcessIdentityConstraints および AllowXmlAttributes は既定で有効になります。ProcessInlineSchema、ProcessSchemaLocation、および ReportValidationWarnings は既定で無効になります。

解説

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

既定では、XmlReaderSettings オブジェクトの ProcessInlineSchema 検証フラグおよび ProcessSchemaLocation 検証フラグは設定されません。これらのフラグを設定すると、XmlReader のインスタンス ドキュメントで検出されたスキーマの場所を解決するときに、XmlReaderSettings オブジェクトの XmlResolver が使用されます。XmlResolver オブジェクトが null 参照 (Visual Basic では Nothing) の場合は、ProcessInlineSchema 検証フラグと ProcessSchemaLocation 検証フラグが設定されていても、スキーマの場所は解決されません。 検証を実行しているときにスキーマを追加すると新しい型が追加されるため、検証しているドキュメントの検証結果を変えることができます。このため、信頼関係のあるソースの外部スキーマだけを解決するようにしてください。 可用性の高い状況で、信頼関係のない大量の XML ドキュメントをドキュメントの大部分について ID 制約のあるスキーマに対して検証する場合は、ProcessIdentityConstraints フラグを無効にすることをお勧めします (既定ではこのフラグは有効)。

使用例

ProcessInlineSchema 設定を有効にする例を次に示します。

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 データの検証