次の方法で共有


DataDOMEvent.ReportError メソッド

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

名前空間: Microsoft.Office.Interop.InfoPath
アセンブリ: Microsoft.Office.Interop.InfoPath (microsoft.office.interop.infopath.dll 内)

構文

'宣言
<DispIdAttribute(8)> _
Function ReportError ( _
    <InAttribute> varNode As Object, _
    <InAttribute> bstrShortErrorMessage As String, _
    <InAttribute> fSiteIndependent As Boolean, _
    <InAttribute> <OptionalAttribute> Optional bstrDetailedErrorMessage As String = "", _
    <InAttribute> <OptionalAttribute> Optional lErrorCode As Integer = 0, _
    <InAttribute> <OptionalAttribute> Optional bstrType As String = "modeless" _
) As ErrorObject
'使用
Dim instance As DataDOMEvent
Dim varNode As Object
Dim bstrShortErrorMessage As String
Dim fSiteIndependent As Boolean
Dim bstrDetailedErrorMessage As String
Dim lErrorCode As Integer
Dim bstrType As String
Dim returnValue As ErrorObject

returnValue = instance.ReportError(varNode, bstrShortErrorMessage, fSiteIndependent, bstrDetailedErrorMessage, lErrorCode, bstrType)
[DispIdAttribute(8)] 
ErrorObject ReportError (
    [InAttribute] Object varNode,
    [InAttribute] string bstrShortErrorMessage,
    [InAttribute] bool fSiteIndependent,
    [OptionalAttribute] [InAttribute] string bstrDetailedErrorMessage,
    [OptionalAttribute] [InAttribute] int lErrorCode,
    [OptionalAttribute] [InAttribute] string bstrType
)

パラメータ

  • varNode
    エラーが関連付けられる XML DOM (Document Object Model) ノード。
  • bstrShortErrorMessage
    短いエラー メッセージに使用するテキスト。
  • fSiteIndependent
    Error オブジェクトの自動削除の条件を設定します。true の場合は、Error オブジェクトに対応する XPath 式と一致したいずれかのノードが変更されると、Error オブジェクトが削除されます。false の場合は、特定のイベント オブジェクトの Site プロパティによって返されるノードが変更されると、Error オブジェクトが削除されます。
  • bstrDetailedErrorMessage
    詳細なエラー メッセージに使用するテキスト。
  • lErrorCode
    エラー コードとして使用する番号。
  • bstrType
    既定値は "modeless" です。値の変更を自動的に拒否するか、または変更を承認するか拒否するかの指定をユーザーに求めるかを決定します。もう 1 つの値は "modal" です。

戻り値

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

コメント

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

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

メモメモ :

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

メモメモ :

ReportError メソッドは、OnValidate イベントの間にだけ使用できます。

次の例では、DataDOMEventObject オブジェクトの Site プロパティを使用して、ノードの値を検査しています。データの入力規則エラーが発生した場合は、ReportError メソッドを使用してカスタム エラーを作成します。

public void field1_OnValidate(DataDOMEvent e)
{
 if (int.Parse(e.Site.text) > 50)
 {
  e.ReportError(
   e.Site, 
   "Invalid quantity. The total number of each type of block cannot exceed 50.", 
   false,
   "",
   2,
   "modeless");
 }

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

関連項目

参照

DataDOMEvent インターフェイス
DataDOMEvent のメンバ
Microsoft.Office.Interop.InfoPath 名前空間