DataDOMEvent.ReportError 方法

定义

命名空间:

Microsoft.Office.Interop.InfoPath

程序集:

Microsoft.Office.Interop.InfoPath.dll

创建对象ErrorObject并将其添加到集合。ErrorsCollection

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

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

Public Function ReportError (varNode As Object, bstrShortErrorMessage As String, fSiteIndependent As Boolean, Optional bstrDetailedErrorMessage As String = "", Optional lErrorCode As Integer = 0, Optional bstrType As String = "modeless") As ErrorObject

参数

varNode

Object

与错误相关联的 XML 文档对象模型 (DOM) 节点。

bstrShortErrorMessage

String

用于短错误消息的文本。

fSiteIndependent

Boolean

设置 Error 对象的自动删除的条件。 如果该值为 true，只要对与 XPath 表达式（与 Error 对象相对应）匹配的任何节点进行了更改，就将删除 Error 对象。 如果为 false，则当给定事件对象的 属性返回Site的节点已更改时，将删除 Error 对象。

bstrDetailedErrorMessage

String

用于详细错误消息的文本。

lErrorCode

Int32

要用作错误代码的数字。

bstrType

String

默认值为“modeless”。 确定是否要自动拒绝值的更改，或者是否提示用户接受或拒绝该更改。 另一个值为“modal”。

返回

ErrorObject

表示 ErrorObject 新创建的 Error 的对象。

示例

在以下示例中Site， 对象的 属性DataDOMEventObject用于检查节点的值。 如果数据验证失败，则使用 ReportError 方法创建自定义错误。

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 Office InfoPath 2003 会创建 Error 对象并将其添加到 Errors 集合。 验证约束不再无效时，将从集合中删除错误。 在某些情况下，可以使用 或 DeleteAll() 方法显式删除Delete(Object, String)它们。

也可以使用 方法创建 Add(Object, String, String, String, Int32, String) 错误。

注意：如果希望将错误应用于同一类型的所有 XML DOM 节点，则应使用与站点无关的错误。 如果要将错误应用于特定的 XML DOM 节点，请使用与网站相关的错误。

注意：只能在事件期间OnValidate使用 ReportError 方法。