XmlReaderSettings.ValidationEventHandler Kejadian

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlReaderSettings.cs

Terjadi ketika pembaca mengalami kesalahan validasi.

public:
 event System::Xml::Schema::ValidationEventHandler ^ ValidationEventHandler;

public event System.Xml.Schema.ValidationEventHandler ValidationEventHandler;

member this.ValidationEventHandler : System.Xml.Schema.ValidationEventHandler 

Jenis Acara

ValidationEventHandler

Contoh

Contoh berikut menunjukkan pengaturan untuk menentukan untuk membuat pembaca yang memvalidasi menggunakan skema sebaris dan yang juga menampilkan peringatan validasi. Penanganan aktivitas validasi menggunakan XmlSeverityType enumerasi untuk membedakan antara peringatan dan kesalahan.

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);
  }
}

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

Keterangan

Peristiwa ini terjadi saat membaca dokumen instans XML jika ValidationType diatur ke DTD atau Schema. ReportValidationWarnings Jika pengaturan telah diaktifkan pada ValidationFlags properti, peristiwa ini juga terjadi ketika peringatan validasi ditemui.

Jika pembaca dikonfigurasi untuk validasi dan tidak ada penanganan aktivitas validasi yang telah ditetapkan, akan XmlSchemaValidationException dilemparkan untuk semua kesalahan validasi. (Peringatan validasi tidak menyebabkan dilemparkan XmlSchemaValidationException ).

Penting

Pesan kesalahan validasi dapat mengekspos informasi model konten sensitif. Kesalahan validasi dan peringatan pesan ditangani dengan delegasi ValidationEventHandler, atau diekspos sebagai XmlSchemaValidationException jika tidak ada penanganan acara yang disediakan untuk objek XmlReaderSettings (peringatan validasi tidak menyebabkan XmlSchemaValidationException dilemparkan). Informasi model konten ini tidak boleh diekspos dalam skenario yang tidak tepercaya. Pesan peringatan validasi ditekan secara default dan dapat dilaporkan dengan mengatur ReportValidationWarnings bendera.

Properti SourceUri dari XmlSchemaValidationException mengembalikan jalur URI ke file skema yang menyebabkan pengecualian. Properti SourceUri tidak boleh diekspos dalam skenario yang tidak tepercaya.

Lihat juga

• XmlReader
• Create(String)