XmlEvent.Validating Событие

Определение

Пространство имен:

Microsoft.Office.InfoPath

Сборка:

Microsoft.Office.InfoPath.dll

Происходит после принятия изменений в базовом XML-документе формы, но до Changed возникновения события.

public:
 abstract event Microsoft::Office::InfoPath::XmlValidatingEventHandler ^ Validating;

public abstract event Microsoft.Office.InfoPath.XmlValidatingEventHandler Validating;

member this.Validating : Microsoft.Office.InfoPath.XmlValidatingEventHandler 

Public MustOverride Custom Event Validating As XmlValidatingEventHandler 

Тип события

XmlValidatingEventHandler

Исключения

InvalidOperationException

Попытка разработчика привязать событие к узлу в дополнительном источнике данных. Это событие не поддерживается для дополнительного источника данных.

Примеры

В следующем примере после принятия изменения для field9 возникает событие Validating и объект, связанный FormError с field6 , добавляется в FormErrorCollection формы с помощью Add(XPathNavigator, String, String, String) метода .

Это связывает сообщение об ошибке со значением field6. Строка, переданная в message качестве параметра метода Add , отображается в подсказке экрана, когда пользователь наводит указатель мыши на поле 6. Когда пользователь щелкает правой кнопкой мыши поле 6 и щелкает полное описание ошибки, InfoPath отображает полное сообщение об ошибке, включая строку, переданную в messageDetails качестве параметра метода Add .

public void field9_Validating(object sender, XmlValidatingEventArgs e)
{
   XPathNavigator errNode = 
      this.CreateNavigator().SelectSingleNode("/my:myFields/my:field6", 
      NamespaceManager);

   this.Errors.Add(errNode, "Field9Validating", 
      "Field9 was validated.", 
      "Field9 was validated and an error was assocated with Field6.");
}

Public Sub field9_Validating(ByVal sender As Object, _
   ByVal e As XmlValidatingEventArgs )
   Dim errNode As XPathNavigator = _
      Me.CreateNavigator().SelectSingleNode("/my:myFields/my:field6", _
      NamespaceManager)

   Me.Errors.Add(errNode, "Field9Validating", _
      "Field9 was validated.", _
      "Field9 was validated and an error was associated with Field6.")
End Sub

Комментарии

Важно! Событие проверки не предназначено для создания экземпляра разработчиком в коде формы. При добавлении обработчика событий в шаблон формы из пользовательского интерфейса режима конструктора Microsoft InfoPath создает код в методе InternalStartup файла кода формы с помощью EventManager класса и члена класса для привязки XmlEvent событий уровня документа к обработчикам событий. Сведения о порядке добавления обработчиков событий в режиме конструктора InfoPath см. в разделе How to: Add an Event Handler.

Событие Проверки привязано с помощью делегата XmlValidatingEventHandler .

Этот обработчик событий не разрешает пользователям отменять операцию.

Во время события Validate связанный XML-документ формы переводится в режим только для чтения.

Событие Validate обычно используется для обработки ошибок и работы с FormErrorCollection коллекцией, например для добавления новых ошибок или удаления существующих.

Доступ к этому типу или элементу предоставляется только из кода, выполняющегося в формах, открытых в Microsoft InfoPath Filler или браузере.