FormErrorCollection Класс

Определение

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

Microsoft.Office.InfoPath

Сборка:

Microsoft.Office.InfoPath.dll

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

public ref class FormErrorCollection abstract : System::Collections::IEnumerable

public abstract class FormErrorCollection : System.Collections.IEnumerable

type FormErrorCollection = class
    interface IEnumerable

Public MustInherit Class FormErrorCollection
Implements IEnumerable

Наследование

Object

FormErrorCollection

Реализации

IEnumerable

Примеры

В следующем примере первый объект 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)

Комментарии

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

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

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

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

FormErrorCollection myErrors = this.Errors; Dim myErrors As FormErrorCollection = Me.Errors

Конструкторы

FormErrorCollection()

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

Свойства

Count	Возвращает количество FormError объектов в объекте, связанном FormErrorCollection с текущей формой.
Item[Int32]	FormError Получает объект из объекта, связанного FormErrorCollection с текущей формой, по значению индекса.

Методы

Add(XPathNavigator, String, String, String, Int32, ErrorMode)	Создает и добавляет новый FormError объект, связанный FormErrorCollection с текущей формой.
Add(XPathNavigator, String, String, String, Int32)	Создает и добавляет новый FormError объект, связанный FormErrorCollection с текущей формой.
Add(XPathNavigator, String, String, String)	Создает и добавляет новый FormError объект, связанный FormErrorCollection с текущей формой.
Add(XPathNavigator, String, String)	Создает и добавляет новый FormError объект, связанный FormErrorCollection с текущей формой.
Delete(FormError)	Удаляет указанный FormError объект из объекта, связанного FormErrorCollection с текущей формой.
Delete(String)	Удаляет все FormError объекты с указанным именем из объекта, связанного FormErrorCollection с текущей формой.
DeleteAll()	Удаляет все объекты, FormError содержащиеся в объекте, связанном FormErrorCollection с текущей формой.
GetEnumerator()	IEnumerator Возвращает объект, который выполняет итерацию по всем записям в коллекции.
GetErrors(FormErrorType)	Возвращает все FormError объекты указанного типа из объекта, связанного FormErrorCollection с текущей формой.
GetErrors(String)	Возвращает все FormError объекты с указанным именем из объекта, связанного FormErrorCollection с текущей формой.