Freigeben über


XmlEvent.Validating Ereignis

Definition

Tritt auf, nachdem Änderungen am einem Formular zugrunde liegenden XML-Dokument akzeptiert wurden, aber bevor das Changed Ereignis aufgetreten ist.

public:
 abstract event Microsoft::Office::InfoPath::XmlValidatingEventHandler ^ Validating;
public abstract event Microsoft.Office.InfoPath.XmlValidatingEventHandler Validating;
member this.Validating : Microsoft.Office.InfoPath.XmlValidatingEventHandler 
Public MustOverride Custom Event Validating As XmlValidatingEventHandler 

Ereignistyp

Ausnahmen

Es wurde versucht, das Ereignis an einen Knoten einer sekundären Datenquelle zu binden. Dieses Ereignis wird für sekundäre Datenquellen nicht unterstützt.

Beispiele

Im folgenden Beispiel wird, nachdem eine Änderung für field9 akzeptiert wurde, das Validating-Ereignis ausgelöst, und ein FormError Objekt, das field6 zugeordnet ist, wird der FormErrorCollection des Formulars mithilfe der Add(XPathNavigator, String, String, String) -Methode hinzugefügt.

Auf diese Weise erfolgt die Zuordnung einer Fehlermeldung zu field6. Die Zeichenfolge, die message als Parameter der Add-Methode übergeben wird, wird in einer Bildschirmtipp angezeigt, wenn der Benutzer den Mauszeiger über feld6 bewegt. Wenn der Benutzer mit der rechten Maustaste auf field6 klickt und dann auf Vollständige Fehlerbeschreibung klickt, zeigt InfoPath die vollständige Fehlermeldung einschließlich der Zeichenfolge an, die messageDetails als Parameter der Add-Methode übergeben wird.

public void field9_Validating(object sender, XmlValidatingEventArgs e)
{
   XPathNavigator errNode = 
      this.CreateNavigator().SelectSingleNode("/my:myFields/my:field6", 
      NamespaceManager);

   this.Errors.Add(errNode, "Field9Validating", 
      "Field9 was validated.", 
      "Field9 was validated and an error was assocated with Field6.");
}
Public Sub field9_Validating(ByVal sender As Object, _
   ByVal e As XmlValidatingEventArgs )
   Dim errNode As XPathNavigator = _
      Me.CreateNavigator().SelectSingleNode("/my:myFields/my:field6", _
      NamespaceManager)

   Me.Errors.Add(errNode, "Field9Validating", _
      "Field9 was validated.", _
      "Field9 was validated and an error was associated with Field6.")
End Sub

Hinweise

Wichtig: Das Validierungsereignis soll nicht vom Entwickler im Formularcode instanziiert werden. Wenn Sie Ihrer Formularvorlage über die Benutzeroberfläche des Entwurfsmodus einen Ereignishandler hinzufügen, generiert Microsoft InfoPath Code in der InternalStartup-Methode Ihrer Formularcodedatei mithilfe der EventManager -Klasse und des Members der XmlEvent -Klasse, um Ereignisse auf Dokumentebene an ihre Ereignishandler zu binden. Weitere Informationen zum Hinzufügen von Ereignishandlern im InfoPath-Entwurfsmodus finden Sie unter Vorgehensweise: Hinzufügen eines Ereignishandlers.

Das Validating-Ereignis wird mithilfe des XmlValidatingEventHandler Delegaten gebunden.

Dieser Ereignishandler lässt nicht zu, dass Benutzer einen Vorgang abbrechen.

Während des Validate-Ereignisses wird das dem Formular zugrunde liegende XML-Dokument in den Schreibschutzmodus versetzt.

Das Validate-Ereignis wird in der Regel verwendet, um Fehler zu behandeln und mit der FormErrorCollection Auflistung zu arbeiten, z. B. zum Hinzufügen neuer Fehler oder Löschen vorhandener Fehler.

Auf diesen Typ oder dieses Mitglied kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler oder in einem Webbrowser geöffnet wurden.

Gilt für: