FormError 类

定义

命名空间:

Microsoft.Office.InfoPath

程序集:

Microsoft.Office.InfoPath.dll

表示窗体的 中的 FormErrorCollection 错误。

public ref class FormError abstract

public abstract class FormError

type FormError = class

Public MustInherit Class FormError

继承

Object

FormError

示例

在下面的示例中，单击“按钮”控件将获得表单的 FormErrorCollection 中的第一个错误，然后显示 FormError 对象的所有属性的值。

public void ErrorBtn_Clicked(object sender, ClickedEventArgs e)
{
   FormError er = this.Errors[0];
   MessageBox.Show("Short message: " + er.Message);
   MessageBox.Show("Detailed message: " + er.DetailedMessage); 
   MessageBox.Show("Error code: " + er.ErrorCode);
   MessageBox.Show("Error name: " + er.Name);
   MessageBox.Show("Error type: " + er.FormErrorType.ToString());
   MessageBox.Show("Error site XML: " + er.Site.OuterXml.ToString());
}

Public Sub ErrorBtn_Clicked(ByVal sender As Object, _
   ByVal e As ClickedEventArgs)
   FormError er = Me.Errors(0)
   MessageBox.Show("Short message: " & er.Message)
   MessageBox.Show("Detailed message: " & er.DetailedMessage) 
   MessageBox.Show("Error code: " & er.ErrorCode)
   MessageBox.Show("Error name: " & er.Name);
   MessageBox.Show("Error type: " & er.FormErrorType.ToString())
   MessageBox.Show("Error site XML: " & er.Site.OuterXml.ToString())
End Sub

注解

InfoPath 表单中的每个 FormError 对象都与表单的基础 XML 文档中的一个节点相关联。 当某个特定节点的数据验证失败时，InfoPath 会创建一个 FormError 对象，并将其放在与表单关联的 FormErrorCollection 中。

在 InfoPath 表单中可能发生下列三种数据验证错误。 可以使用 FormError 类的 属性确定FormErrorType它们：

• FormErrorType.SchemaValidation 由于 XML 架构定义的约束条件而导致数据验证失败。
• FormErrorType.SystemGenerated 数据验证失败，因为表单定义 (.xsf) 文件中定义了约束，或者由于表单代码调用 Microsoft.Office.InfoPath.XmlValidatingEventArgs.ReportError 类的 XmlValidatingEventArgs 方法。
• 由于使用 AddFormErrorsCollection 类的 方法定义的自定义错误，FormErrorType.UserDefined 数据验证失败。

构造函数

FormError()

表示窗体的 中的 FormErrorCollection 错误。

属性

DetailedMessage	获取或设置为 FormError 对象显示的详细消息。
ErrorCode	获取或设置 对象的数字错误代码值 FormError 。
FormErrorType	获取 对象的类型 FormError 。
Message	获取或设置为 FormError 对象显示的短消息。
Name	获取对象的名称 FormError 。
Site	获取一个 XPathNavigator ，该文档位于与 对象关联的 FormError 窗体的基础 XML 文档的节点处。