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.
Vererbungshierarchie
System.Object
System.EventArgs
System.ComponentModel.CancelEventArgs
Microsoft.Office.InfoPath.XmlFormCancelEventArgs
Microsoft.Office.InfoPath.SaveCancelEventArgs
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 ein Nullverweis (Nothing in Visual Basic).
Wenn beide Werte ein Nullverweis (Nothing in Visual Basic) 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 ein Nullverweis (Nothing in Visual Basic) 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 ein Nullverweis (Nothing in Visual Basic) 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.
Threadsicherheit
Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Die Threadsicherheit von Instanzmembern ist nicht gewährleistet.