Класс FormErrorCollection

Статья
04/27/2010

Содержит объект FormError для каждой ошибки в текущей форме.

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

Синтаксис

'Декларация
<DefaultMemberAttribute("Item")> _
Public MustInherit Class FormErrorCollection
    Implements IEnumerable
'Применение
Dim instance As FormErrorCollection

[DefaultMemberAttribute("Item")] 
public abstract class FormErrorCollection : IEnumerable

Заметки

Объект FormErrorCollection содержит коллекцию объектов FormError, которые представляют все ошибки, возникающие в связанной форме. Коллекция ошибок включает ошибки проверки, ошибки, сгенерированные системой, и определенные пользователем (настраиваемые) ошибки. Класс FormErrorCollection предоставляет свойства и методы для добавления, удаления и доступа к объектам FormError, которые его содержат. Из этой коллекции невозможно удалить ошибки проверки и ошибки, сгенерированные системой.

Кроме управления ошибками, сгенерированными приложением InfoPath, класс FormErrorCollection также можно использовать для создания настраиваемых ошибок с помощью метода Add.

Заметка
Настраиваемые ошибки также можно создавать с помощью метода ReportError класса XmlValidatingEventArgs.

Для доступа к объекту FormErrorCollection, связанному с формой, используйте свойство Errors класса XmlForm.

FormErrorCollection myErrors = this.Errors;

Dim myErrors As FormErrorCollection = Me.Errors

Пример

В следующем примере первый объект XPathNavigator размещен в поле, с которым нужно связать ошибку. Затем XPathNavigator и подробные сведения об ошибке передаются методу Add класса FormErrorCollection, чтобы добавить ошибку к коллекции ошибок формы.

XPathNavigator root, txtbox;
// Create XPathNavigator for main data source.
root = this.MainDataSource.CreateNavigator();

// Create XPathNavigator positioned at field to associate with error.
txtbox = root.SelectSingleNode("//my:field1", this.NamespaceManager);

// Get form's collection of errors and add error.
this.Errors.Add(txtbox, "Field1Error", "Short error message.", 
   "Detailed error description.", 102057, ErrorMode.Modeless);

Dim root, txtbox As XPathNavigator
' Create XPathNavigator for main data source.
root = Me.MainDataSource.CreateNavigator()

' Create XPathNavigator positioned at field to add error.
txtbox = root.SelectSingleNode("//my:field1", Me.NamespaceManager)

' Get form's collection of errors and add error.
Me.Errors.Add(txtbox, "Field1Error", "Short error message.", 
   "Detailed error description.", 102057, ErrorMode.Modeless)

Иерархия наследования

System.Object
Microsoft.Office.InfoPath.FormErrorCollection

Безопасность потока

Все открытые статические (Общие в Visual Basic) члены этого типа потокобезопасны. Потокобезопасность членов экземпляров не гарантируется.

См. также

Ссылка

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

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