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 和错误消息详细信息传递到 AddFormErrorCollection 类的 方法，以将错误添加到窗体的错误集合中。

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 方法创建自定义错误。

注意：也可以使用 类的 XmlValidatingEventArgs 方法创建自定义ReportError错误。

若要访问与 窗体关联的 FormErrorCollection 对象，请使用 Errors 类的 XmlForm 属性。

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

构造函数

FormErrorCollection()

包含 FormError 当前窗体中每个错误的 对象。

属性

Count	获取对象中FormErrorCollection与当前窗体关联的对象数FormError。
Item[Int32]	FormError按索引值从FormErrorCollection与当前表单关联的 对象中获取对象。

方法

Add(XPathNavigator, String, String, String, Int32, ErrorMode)	创建并与当前窗体关联的 对象并添加一个新的 FormErrorFormErrorCollection 。
Add(XPathNavigator, String, String, String, Int32)	创建并与当前窗体关联的 对象并添加一个新的 FormErrorFormErrorCollection 。
Add(XPathNavigator, String, String, String)	创建并与当前窗体关联的 对象并添加一个新的 FormErrorFormErrorCollection 。
Add(XPathNavigator, String, String)	创建并与当前窗体关联的 对象并添加一个新的 FormErrorFormErrorCollection 。
Delete(FormError)	从FormErrorCollection与当前窗体关联的 对象中删除指定的 FormError 。
Delete(String)	从与当前窗体关联的 对象中删除FormErrorCollection指定名称的所有FormError对象。
DeleteAll()	删除与当前窗体关联的 对象中包含的FormErrorCollection所有FormError对象。
GetEnumerator()	获取一个 IEnumerator 对象，该对象循环访问集合中的所有条目。
GetErrors(FormErrorType)	从与当前窗体关联的 对象中FormErrorCollection返回指定类型的所有FormError对象。
GetErrors(String)	从与当前窗体关联的 对象中FormErrorCollection返回指定名称的所有FormError对象。