XmlValidatingEventArgs-Klasse

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

Vererbungshierarchie

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

Namespace:  Microsoft.Office.InfoPath
Assembly:  Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)

Syntax

'Declaration
Public MustInherit Class XmlValidatingEventArgs _
    Inherits XmlEventArgs
'Usage
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.

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Die Threadsicherheit von Instanzmembern ist nicht gewährleistet.

Siehe auch

Referenz

XmlValidatingEventArgs-Member

Microsoft.Office.InfoPath-Namespace