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. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.