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");
   }
}
}

Комментарии

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

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

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

Примечание. Событие OnValidate может произойти без изменения в базовом XML-документе формы.

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

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

Свойства

IsUndoRedo	Получает значение, указывающее, происходит ли событие проверки данных во время операции отмена или повтора. (Унаследовано от DataDOMEvent)
MatchExpression	Получает выражение XPath для узла модели объектов документа XML (DOM), для которого в настоящий момент обрабатывается событие. (Унаследовано от 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), где происходит проверка данных. (Унаследовано от DataDOMEvent)
XDocument	Возвращает ссылку на XDocument объект, связанный DataDOMEventObject с объектом во время события проверки данных. (Унаследовано от DataDOMEvent)

Методы

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

Создает ErrorObject объект и добавляет его в коллекцию ErrorsCollection . (Унаследовано от DataDOMEvent)