Интерфейс DataDOMEventObject

Статья
04/27/2010

Объект события, используемый в событиях проверки данных Microsoft Office InfoPath 2007.

Пространство имен: Microsoft.Office.Interop.InfoPath
Сборка: Microsoft.Office.Interop.InfoPath (в microsoft.office.interop.infopath.dll)

Синтаксис

'Декларация
<CoClassAttribute(GetType(DataDOMEventObjectClass))> _
<GuidAttribute("096CD5E5-0786-11D1-95FA-0080C78EE3BB")> _
Public Interface DataDOMEventObject
    Inherits DataDOMEvent
'Применение
Dim instance As DataDOMEventObject

[CoClassAttribute(typeof(DataDOMEventObjectClass))] 
[GuidAttribute("096CD5E5-0786-11D1-95FA-0080C78EE3BB")] 
public interface DataDOMEventObject : DataDOMEvent

Заметки

Этот тип является программой-оболочкой для компонентного класса, которого требует управляемый программный код для COM-взаимодействия. Используйте этот тип для доступа к членам интерфейса COM, созданного этим компонентным классом. Дополнительные сведения об интерфейсе COM, включая ссылку на описания его членов, см. в статье DataDOMEvent.

Объект DataDOMEvent предоставляет несколько свойств и один метод, позволяющие программно взаимодействовать с проверяемыми данными в событии проверки данных и реагировать на ситуации с недопустимыми данными.

Объект DataDOMEvent передается в виде параметра событиям OnBeforeChange, OnValidate и OnAfterChange

Заметка
Событие OnValidate может возникнуть и в отсутствие изменений в основном XML-документе формы.

Объект DataDOMEvent используется для получения сведений об узле объектной модели документа XML DOM, в который вносятся изменения, а также предоставляет свойство для получения ссылки на основной XML-документ формы. Кроме того, этот объект также предоставляет свойства для обработки изменений, включая отмену изменений и создание сообщений об ошибке.

Заметка
Объект DataDOMEvent передается обработчикам событий проверки данных в качестве аргумента. Его свойства и методы доступны только в пределах события, которому он передан.

Пример

В следующем примере объект DataDOMEvent используется для проверки значения узла с помощью свойства Site. При непрохождении проверки данных генерируется системная ошибка с помощью метода ReportError.

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

См. также

Ссылка

Члены DataDOMEventObject
Пространство имен Microsoft.Office.Interop.InfoPath

Поделиться через