XmlFormCancelEventArgs クラス
フォームとその基になる XML ドキュメントによって発生したイベントをキャンセルしたときに表示されるユーザー設定メッセージのデータを提供します。
名前空間: Microsoft.Office.InfoPath
アセンブリ: Microsoft.Office.InfoPath (microsoft.office.infopath.dll 内)
構文
'宣言
Public MustInherit Class XmlFormCancelEventArgs
Inherits CancelEventArgs
'使用
Dim instance As XmlFormCancelEventArgs
public abstract class XmlFormCancelEventArgs : CancelEventArgs
コメント
XmlFormCancelEvent オブジェクトには Message および MessageDetails プロパティがあります。これらを使用して、Changing、Validating、Save、Merge、Submit、VersionUpgrade、および Loading イベントをキャンセルしたときのユーザー設定メッセージを指定または取得します。
既定では、Message および MessageDetails プロパティは null 値になっています。
両方の値が null の場合は、イベントをキャンセルすると既定のエラー メッセージが表示されます。
両方の値が null 以外の場合は、Message および MessageDetails プロパティに指定した値がエラー メッセージ ダイアログ ボックスに表示されます。
両方のプロパティを空の文字列に設定すると、エラー メッセージ ダイアログ ボックスにはテキストが表示されません。
Message プロパティを null に設定し、MessageDetails プロパティを null 以外に設定することができます。また、その逆も可能です。いずれかの値が null 以外であれば、指定した値が表示されます。たとえば、Message が null でも MessageDetails に値を指定すると、詳細セクションだけがあって最上位レベルのテキストがないエラー メッセージ ダイアログ ボックスが表示されます。
InfoPath のデザイン モード ユーザー インターフェイスでは、[ツール] メニューの [フォーム送信オプション] コマンドを使用して、送信が成功または失敗したときに表示されるユーザー設定のメッセージを指定できます。コードで Message プロパティまたは MessageDetails プロパティが設定されている場合は、InfoPath のユーザー インターフェイスで指定したテキストよりこれらの値が優先されます。
継承階層
System.Object
System.EventArgs
System.ComponentModel.CancelEventArgs
Microsoft.Office.InfoPath.XmlFormCancelEventArgs
Microsoft.Office.InfoPath.SaveCancelEventArgs
スレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。