Интерфейс DataDOMEventObject

Статья
04/27/2010

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

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

Синтаксис

'Декларация
<GuidAttribute("096cd5e5-0786-11d1-95fa-0080c78ee3bb")> _
<CoClassAttribute(GetType(DataDOMEventObjectWrapper))> _
<CLSCompliantAttribute(False)> _
Public Interface DataDOMEventObject
    Inherits DataDOMEvent, DocActionEvent, DocReturnEvent, DocEvent
'Применение
Dim instance As DataDOMEventObject

[GuidAttribute("096cd5e5-0786-11d1-95fa-0080c78ee3bb")] 
[CoClassAttribute(typeof(DataDOMEventObjectWrapper))] 
[CLSCompliantAttribute(false)] 
public interface DataDOMEventObject : DataDOMEvent, DocActionEvent, DocReturnEvent, 
    DocEvent

Заметки

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

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

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

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

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

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

Пример

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

[InfoPathEventHandler(MatchPath="/my:myFields/my:field1", EventType=InfoPathEventType.OnValidate)]
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.SemiTrust

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