DataDOMEventObject 接口

定义

命名空间:

Microsoft.Office.Interop.InfoPath.SemiTrust

程序集:

Microsoft.Office.Interop.InfoPath.SemiTrust.dll

在 Microsoft InfoPath 数据验证事件期间使用的事件对象。

public interface class DataDOMEventObject : Microsoft::Office::Interop::InfoPath::SemiTrust::DataDOMEvent

[System.Runtime.InteropServices.Guid("096cd5e5-0786-11d1-95fa-0080c78ee3bb")]
public interface DataDOMEventObject : Microsoft.Office.Interop.InfoPath.SemiTrust.DataDOMEvent

type DataDOMEventObject = interface
    interface DataDOMEvent
    interface DocActionEvent
    interface DocReturnEvent
    interface DocEvent

Public Interface DataDOMEventObject
Implements DataDOMEvent

属性

GuidAttribute

实现

DataDOMEvent

示例

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

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

注解

此类型是用于 Coclass（托管代码需要此 Coclass 来实现 COM 互操作性）的包装。 使用此类型来访问由此 Coclass 实现的 COM 接口。 有关 COM 接口的信息（包括指向其成员说明的链接），请参阅DataDOMEvent。

DataDOMEvent 对象提供了可以在数据验证事件中使用的多个属性和一个方法，以便以编程方式与正在验证的数据进行交互并在数据无效时提供响应。

DataDOMEvent 对象作为参数传递给 OnBeforeChange、 OnValidate和 OnAfterChange 事件

注意：在窗体的基础 XML 文档中不发生更改的情况下， 可能会发生 OnValidate 事件。

DataDOMEvent 对象用于获取有关正在被更改的 XML 文档对象模型 (DOM) 节点的信息，该对象还提供了用于获取对表单的基础 XML 文档的引用的属性。 此外，它还提供了用于处理数据更改的属性，包括拒绝更改和创建错误消息。

注意： DataDOMEvent 对象作为参数传递给其中一个数据验证事件处理程序。 该对象的属性和方法只在接受该对象的事件期间可用。

属性

IsUndoRedo	获取一个值，该值指明在撤消或恢复操作过程中是否发生数据验证事件。 (继承自 DataDOMEvent)
MatchExpression	获取 XML 文档对象模型 (DOM) 节点（当前正在为其处理事件）的 XPath 表达式。 (继承自 DataDOMEvent)
NewValue	获取 XML 文档对象模型 (DOM) 节点的值（该值在数据验证事件中被更新或插入）。 (继承自 DataDOMEvent)
OldValue	获取 XML 文档对象模型 (DOM) 节点的原始值（该值在数据验证事件中被更新或删除）。 (继承自 DataDOMEvent)
Operation	获取在数据验证事件中被应用于 XML 文档对象模型 (DOM) 节点的操作的类型。 (继承自 DataDOMEvent)
Parent	获取一个对 XML DOM 节点的父节点的 XML 文档对象模型 (DOM) 节点（该节点在数据验证事件中被更改）的引用。 (继承自 DataDOMEvent)
ReturnMessage	获取或设置在数据验证事件不成功的情况下返回的错误消息。 (继承自 DataDOMEvent)
ReturnStatus	获取或设置一个值，指示数据验证事件的返回状态。 (继承自 DataDOMEvent)
Site	获取一个对 XML 文档对象模型 (DOM) 节点的引用，该节点为当前处理数据验证事件所在的位置。 (继承自 DataDOMEvent)
Source	获取一个对 XML 文档对象模型 (DOM) 的引用，在该文档对象模型 (DOM) 处正在发生数据验证事件。 (继承自 DataDOMEvent)
XDocument	获取对在数据验证事件期间与 DataDOMEventObject 对象关联的 对象的引用XDocument。 (继承自 DataDOMEvent)

方法

ReportError(Object, String, Boolean, String, Int32, String)

创建对象ErrorObject并将其添加到集合。ErrorsCollection (继承自 DataDOMEvent)