XmlReaderSettings.ValidationEventHandler Ereignis

Definition

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Quelle:

XmlReaderSettings.cs

Tritt ein, wenn der Reader Validierungsfehler feststellt.

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

public event System.Xml.Schema.ValidationEventHandler ValidationEventHandler;

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

Ereignistyp

ValidationEventHandler

Beispiele

Das folgende Beispiel zeigt die Einstellungen, die angegeben werden sollen, um einen Reader zu erstellen, der mithilfe eines Inlineschemas überprüft wird und auch Validierungswarnungen anzeigt. Der Validierungsereignishandler verwendet die XmlSeverityType Enumeration, um zwischen Warnungen und Fehlern zu unterscheiden.

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

Hinweise

Diese Ereignisse treten beim Lesen eines XML-Instanzdokuments aufDTD, wenn entweder ValidationType oder Schemafestgelegt ist. Wenn die ReportValidationWarnings Einstellung für die ValidationFlags -Eigenschaft aktiviert wurde, treten diese Ereignisse auch auf, wenn Validierungswarnungen auftreten.

Wenn der Reader für die Überprüfung konfiguriert ist und kein Validierungsereignishandler festgelegt wurde, wird für alle Validierungsfehler ein XmlSchemaValidationException ausgelöst. (Überprüfungswarnungen führen nicht dazu, dass ein XmlSchemaValidationException ausgelöst wird.)

Wichtig

Überprüfungsfehlermeldungen können vertrauliche Inhaltsmodellinformationen verfügbar machen. Validierungsfehler und Warnmeldungen werden mithilfe des ValidationEventHandler Delegaten behandelt oder als verfügbar XmlSchemaValidationException gemacht, wenn kein Ereignishandler für das XmlReaderSettings Objekt bereitgestellt wird (Validierungswarnungen führen nicht dazu, dass ein XmlSchemaValidationException ausgelöst wird). Diese Inhaltsmodellinformationen sollten in nicht vertrauenswürdigen Szenarien nicht verfügbar gemacht werden. Validierungswarnungen werden standardmäßig unterdrückt und können durch Festlegen des ReportValidationWarnings Flags gemeldet werden.

Die SourceUri -Eigenschaft eines XmlSchemaValidationException gibt den URI-Pfad zur Schemadatei zurück, die die Ausnahme verursacht hat. Die SourceUri Eigenschaft sollte in nicht vertrauenswürdigen Szenarien nicht verfügbar gemacht werden.

Weitere Informationen

• XmlReader
• Create(String)