XmlValidatingEventArgs-Klasse

Artikel
04/27/2010

Stellt Daten für das Validating-Ereignis eines Felds oder einer Gruppe bereit.

Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Syntax

Public MustInherit Class XmlValidatingEventArgs
    Inherits XmlEventArgs

Dim instance As XmlValidatingEventArgs

public abstract class XmlValidatingEventArgs : XmlEventArgs

Hinweise

Das XmlValidatingEventArgs-Objekt wird an den Ereignishandler für das Validating-Ereignis übergeben, das auftritt, nachdem Änderungen an dem einem Formular zugrunde liegenden XML-Dokument akzeptiert wurden, jedoch bevor das Changed-Ereignis auftrat.

Die XmlValidatingEventArgs-Klasse wird von der XmlEventArgs-Klasse abgeleitet. Diese stellt Eigenschaften bereit, die im Ereignishandler zum Abrufen von Informationen zu den Daten verwendet werden können, die im dem Formular zugrunde liegenden XML-Dokument überprüft werden, sowie zu dem Knoten, der überprüft wird. Das XmlEventArgs-Objekt stellt z. B. die Site-Eigenschaft bereit. Diese ruft einen Verweis auf ein XPathNavigator-Objekt ab, das auf den Knoten zeigt, der im dem Formular zugrunde liegenden XML-Dokument überprüft wird. Das dem Formular zugrunde liegende XML-Dokument ist jedoch während des Validating-Ereignisses schreibgeschützt.

Zusätzlich zu diesen Eigenschaften stellt die XmlValidatingEventArgs-Klasse die überladene ReportError-Methode bereit, mit der der FormErrorCollection-Auflistung des Formulars Fehler hinzugefügt und benutzerdefinierte Fehlerinformationen für Fehler, die während des Validating-Ereignisses auftreten, angegeben werden können.

Die überladene ReportError-Methode der XmlValidatingEventArgs-Klasse entspricht der ReportError-Methode der DataDOMEvent-Schnittstelle im Microsoft Office InfoPath 2003-Objektmodell für verwalteten Code.

Vererbungshierarchie

System.Object
   System.EventArgs
     Microsoft.Office.InfoPath.XmlEventArgs
      Microsoft.Office.InfoPath.XmlValidatingEventArgs

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Referenz

XmlValidatingEventArgs-Member
Microsoft.Office.InfoPath-Namespace

Freigeben über