XmlReaderSettings.ValidationEventHandler Ereignis

Definition

Namespace:

System.Xml

Assemblys:

netstandard.dll, System.Xml.ReaderWriter.dll

Quelle:

XmlReaderSettings.cs

Tritt auf, wenn der Leser Auf Gültigkeitsfehler auftritt.

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 zum Erstellen eines Readers angegeben werden sollen, der mithilfe eines Inlineschemas überprüft wird und auch Überprüfungswarnungen anzeigt. Der Überprüfungsereignishandler 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 auf, wenn dies ValidationType auf einen DTD oder Schemamehrere Werte festgelegt ist. Wenn die Einstellung für die ReportValidationWarningsValidationFlags Eigenschaft aktiviert wurde, treten diese Ereignisse auch auf, wenn Überprüfungswarnungen aufgetreten sind.

Wenn der Leser für die Überprüfung konfiguriert ist und kein Überprüfungsereignishandler festgelegt wurde, wird für alle Überprüfungsfehler ein XmlSchemaValidationException Fehler ausgelöst. (Validierungswarnungen führen nicht dazu, dass ein XmlSchemaValidationException Fehler ausgelöst wird).

Von Bedeutung

Überprüfungsfehlermeldungen können vertrauliche Inhaltsmodellinformationen verfügbar machen. Überprüfungsfehler- und Warnmeldungen werden mithilfe des ValidationEventHandler Delegaten behandelt oder, wenn kein Ereignishandler dem XmlSchemaValidationException Objekt zugewiesen wird, als XmlReaderSettings dargestellt (Validierungswarnungen verursachen kein XmlSchemaValidationException Auslösen). Diese Inhaltsmodellinformationen sollten in nicht vertrauenswürdigen Szenarien nicht verfügbar gemacht werden. Überprüfungswarnungen werden standardmäßig unterdrückt und können durch Festlegen des ReportValidationWarnings Flags gemeldet werden.

Die SourceUri Eigenschaft eines Objekts 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)