Freigeben über


XmlFormCancelEventArgs-Klasse

Liefert Daten für die benutzerdefinierte Meldung, die beim Abbrechen von Ereignissen angezeigt wird, die vom Formular und dem zugrunde liegenden XML-Dokuments ausgelöst werden.

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

Syntax

'Declaration
Public MustInherit Class XmlFormCancelEventArgs
    Inherits CancelEventArgs
'Usage
Dim instance As XmlFormCancelEventArgs
public abstract class XmlFormCancelEventArgs : CancelEventArgs

Hinweise

Das XmlFormCancelEvent-Objekt stellt die Eigenschaften Message und MessageDetails bereit, um eine benutzerdefinierte Meldung anzugeben oder abzurufen, wenn die Ereignisse Changing, Validating, Save, Merge, Submit, VersionUpgrade und Loading abgebrochen werden.

Standardmäßig haben die Eigenschaften Message und MessageDetails den Wert null.

  • Wenn beide Werte null sind, wird die Standardfehlermeldung angezeigt, wenn ein Ereignis abgebrochen wird.

  • Wenn beide Werte ungleich null sind, werden die für die Eigenschaften Message und MessageDetails angegebenen Werte im Dialogfeld der Fehlermeldung angezeigt.

  • Wenn für beide Eigenschaften eine leere Zeichenkette festgelegt ist, wird kein Text im Dialogfeld der Fehlermeldung angezeigt.

  • Die Message-Eigenschaft kann null sein, und die MessageDetails-Eigenschaft kann ungleich null sein und umgekehrt. Wenn einer der Werte ungleich null ist, zeigt InfoPath den angegebenen Wert an. Wenn z. B. Message gleich null ist, aber für MessageDetails ein Wert angegeben ist, zeigt InfoPath ein Dialogfeld mit einer Fehlermeldung an, in dem nur der Detailbereich, aber kein Text der obersten Ebene, enthalten ist.

  • Im Entwurfsmodus können Sie auf der InfoPath-Benutzeroberfläche eine benutzerdefinierte Meldung angeben, die angezeigt wird, wenn erfolgreiche oder Fehler zurückgebende Vorgänge angezeigt werden. Verwenden Sie dazu den Befehl Formularsendeoptionen im Menü Extras. Wenn die Eigenschaft Message oder MessageDetails in Code festgelegt ist, überschreiben diese Werte alle Texte, die auf der InfoPath-Benutzeroberfläche angegeben sind.

Vererbungshierarchie

System.Object
   System.EventArgs
     System.ComponentModel.CancelEventArgs
      Microsoft.Office.InfoPath.XmlFormCancelEventArgs
         Microsoft.Office.InfoPath.SaveCancelEventArgs

Threadsicherheit

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

Siehe auch

Referenz

XmlFormCancelEventArgs-Member
Microsoft.Office.InfoPath-Namespace