DataDOMEvent.ReportError メソッド

定義

名前空間:

Microsoft.Office.Interop.InfoPath.SemiTrust

アセンブリ:

Microsoft.Office.Interop.InfoPath.SemiTrust.dll

オブジェクトを ErrorObject 作成し、コレクションに ErrorsCollection 追加します。

public:
 Microsoft::Office::Interop::InfoPath::SemiTrust::ErrorObject ^ ReportError(System::Object ^ varNode, System::String ^ bstrShortErrorMessage, bool fSiteIndependent, System::String ^ bstrDetailedErrorMessage, int lErrorCode, System::String ^ bstrType);

public Microsoft.Office.Interop.InfoPath.SemiTrust.ErrorObject ReportError (object varNode, string bstrShortErrorMessage, bool fSiteIndependent, string bstrDetailedErrorMessage, int lErrorCode, string bstrType);

abstract member ReportError : obj * string * bool * string * int * string -> Microsoft.Office.Interop.InfoPath.SemiTrust.ErrorObject

Public Function ReportError (varNode As Object, bstrShortErrorMessage As String, fSiteIndependent As Boolean, bstrDetailedErrorMessage As String, lErrorCode As Integer, bstrType As String) As ErrorObject

パラメーター

varNode

Object

エラーが関連付けられる XML DOM (Document Object Model) ノード。

bstrShortErrorMessage

String

短いエラー メッセージに使用されるテキスト。

fSiteIndependent

Boolean

Error オブジェクトの自動削除の条件を設定します。 true の場合は、Error オブジェクトに対応する XPath 式と一致したいずれかのノードが変更されると、Error オブジェクトは削除されます。 false の場合、指定されたイベント オブジェクトのプロパティによってSite返されたノードが変更されると、Error オブジェクトが削除されます。

bstrDetailedErrorMessage

String

詳細なエラー メッセージに使用されるテキスト。

lErrorCode

Int32

エラー コードとして使用される数字。

bstrType

String

既定値は "modeless" です。 値の変更を自動的に拒否するか、または変更を承認するか拒否するかの指定をユーザーに求めるかを決定します。 もう 1 つの値は "modal" です。

戻り値

ErrorObject

ErrorObject新しく作成された Error を表す オブジェクト。

例

次の例では、 オブジェクトの プロパティをSiteDataDOMEventObject使用して、ノードの値をチェックします。 データ検証に失敗した場合は、ReportError メソッドを使用してカスタム エラーを作成します。

[InfoPathEventHandler(MatchPath="/my:myFields/my:field1", EventType=InfoPathEventType.OnValidate)]
public void field1_OnValidate(DataDOMEvent e)
{
 if (int.Parse(e.Site.text) > 50)
 {
  e.<span class="label">ReportError</span>(
   e.Site, 
   "Invalid quantity. The total number of each type of block cannot exceed 50.", 
   false,
   "",
   2,
   "modeless");
 }

 if (int.Parse(e.Site.text) &lt; 0)
 {
  e.ReportError(
   e.Site, 
   "Invalid quantity. The total number of each type of block cannot be less than 0.", 
   false,
   "",
   2,
   "modeless");
 }
}

注釈

ReportError メソッドが呼び出されると、Microsoft InfoPath によって Error オブジェクトが作成され、Errors コレクションに追加されます。 エラーは、入力規則の制約が有効でなくなると、コレクションから削除されます。 場合によっては、 メソッドまたは DeleteAll() メソッドを使用してDelete(Object, String)明示的に削除できます。

エラーは、 メソッドを使用して Add(Object, String, String, String, Int32, String) 作成することもできます。

注: サイトに依存しないエラーは、同じ種類のすべての XML DOM ノードにエラーを適用する場合に使用する必要があります。 特定の XML DOM ノードに対してのみエラーを適用する場合は、サイトに依存するエラーを使用します。

注: ReportError メソッドは、イベント中 OnValidate にのみ使用できます。

重要: このメンバーにアクセスできるのは、現在開いているフォームと同じドメインで実行されているフォーム、またはクロスドメインアクセス許可が付与されているフォームのみです。