通过

FormErrorCollection.Add 方法

  • 参考

定义

命名空间:
Microsoft.Office.InfoPath
程序集:
Microsoft.Office.InfoPath.dll

重载

Add(XPathNavigator, String, String)

创建并与当前窗体关联的 对象并添加一个新的 FormErrorFormErrorCollection 。
Add(XPathNavigator, String, String, String)

创建并与当前窗体关联的 对象并添加一个新的 FormErrorFormErrorCollection 。
Add(XPathNavigator, String, String, String, Int32)

创建并与当前窗体关联的 对象并添加一个新的 FormErrorFormErrorCollection 。
Add(XPathNavigator, String, String, String, Int32, ErrorMode)

创建并与当前窗体关联的 对象并添加一个新的 FormErrorFormErrorCollection 。

Add(XPathNavigator, String, String)

创建并与当前窗体关联的 对象并添加一个新的 FormErrorFormErrorCollection 。

public:
 abstract Microsoft::Office::InfoPath::FormError ^ Add(System::Xml::XPath::XPathNavigator ^ context, System::String ^ name, System::String ^ message);
public abstract Microsoft.Office.InfoPath.FormError Add (System.Xml.XPath.XPathNavigator context, string name, string message);
abstract member Add : System.Xml.XPath.XPathNavigator * string * string -> Microsoft.Office.InfoPath.FormError
Public MustOverride Function Add (context As XPathNavigator, name As String, message As String) As FormError

参数

context
XPathNavigator

一个 XPathNavigator 对象，该对象位于将与之关联的节点。

name
String

错误的名称（不能为空白）。

message
String

用于错误的简短消息。

返回

FormError

对添加到集合中的新 FormError 的引用。

例外

ArgumentNullException

传递给此方法的参数是 null 引用， (Visual Basic) 中没有。

ArgumentException

传递给此方法的参数无效。 例如，它们的类型或格式有误。

示例

在以下示例中，首先将 XPathNavigator 对象放置在将与错误关联的字段处。 然后，将 XPathNavigator、name 和 message 传递给 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.");

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.")

注解

FormErrorType新 FormError 的 将设置为 UserDefined。

注意：可以将具有相同 name 参数值的多个错误添加到不同的 context 节点。 但是，如果将同名错误添加到同 context 一节点两次，则添加的第二个错误将覆盖第一个错误。

此成员只能由与当前打开的表单在相同域中运行的表单访问，或者由已授予跨域权限的表单访问。

可以通过 Microsoft InfoPath Filler 或 Web 浏览器内打开的表单中运行的代码访问此类型或成员。

适用于

Add(XPathNavigator, String, String, String)

创建并与当前窗体关联的 对象并添加一个新的 FormErrorFormErrorCollection 。

public:
 abstract Microsoft::Office::InfoPath::FormError ^ Add(System::Xml::XPath::XPathNavigator ^ context, System::String ^ name, System::String ^ message, System::String ^ messageDetails);
public abstract Microsoft.Office.InfoPath.FormError Add (System.Xml.XPath.XPathNavigator context, string name, string message, string messageDetails);
abstract member Add : System.Xml.XPath.XPathNavigator * string * string * string -> Microsoft.Office.InfoPath.FormError
Public MustOverride Function Add (context As XPathNavigator, name As String, message As String, messageDetails As String) As FormError

参数

context
XPathNavigator

一个 XPathNavigator 对象，该对象位于将与之关联的节点。

name
String

错误的名称（不能为空白）。

message
String

用于错误的简短消息。

messageDetails
String

用于错误的详细消息。

返回

FormError

对添加到集合中的新 FormError 的引用。

例外

ArgumentException

传递给此方法的参数无效。 例如，它们的类型或格式有误。

ArgumentNullException

传递给此方法的参数是 null 引用， (Visual Basic) 中没有。

示例

在以下示例中，首先将 XPathNavigator 对象放置在将与错误关联的字段处。 然后，将 XPathNavigator、name、message 和详细消息传递给 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)

注解

FormErrorType新 FormError 的 将设置为 UserDefined。

注意：可以将具有相同 name 参数值的多个错误添加到不同的 context 节点。 但是，如果将同名错误添加到同 context 一节点两次，则添加的第二个错误将覆盖第一个错误。

此成员只能由与当前打开的表单在相同域中运行的表单访问，或者由已授予跨域权限的表单访问。

可以通过 Microsoft InfoPath Filler 或 Web 浏览器内打开的表单中运行的代码访问此类型或成员。

适用于

Add(XPathNavigator, String, String, String, Int32)

创建并与当前窗体关联的 对象并添加一个新的 FormErrorFormErrorCollection 。

public:
 abstract Microsoft::Office::InfoPath::FormError ^ Add(System::Xml::XPath::XPathNavigator ^ context, System::String ^ name, System::String ^ message, System::String ^ messageDetails, int errorCode);
public abstract Microsoft.Office.InfoPath.FormError Add (System.Xml.XPath.XPathNavigator context, string name, string message, string messageDetails, int errorCode);
abstract member Add : System.Xml.XPath.XPathNavigator * string * string * string * int -> Microsoft.Office.InfoPath.FormError
Public MustOverride Function Add (context As XPathNavigator, name As String, message As String, messageDetails As String, errorCode As Integer) As FormError

参数

context
XPathNavigator

一个 XPathNavigator 对象，该对象位于将与之关联的节点。

name
String

错误的名称（不能为空白）。

message
String

用于错误的简短消息。

messageDetails
String

用于错误的详细消息。

errorCode
Int32

错误的错误代码。

返回

FormError

对添加到集合中的新 FormError 的引用。

例外

ArgumentException

传递给此方法的参数无效。 例如，它们的类型或格式有误。

ArgumentNullException

传递给此方法的参数是 null 引用， (Visual Basic) 中没有。

示例

在以下示例中，首先将 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);

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)

注解

FormErrorType新 FormError 的 将设置为 UserDefined。

注意：可以将具有相同 name 参数值的多个错误添加到不同的 context 节点。 但是，如果将同名错误添加到同 context 一节点两次，则添加的第二个错误将覆盖第一个错误。

此成员只能由与当前打开的表单在相同域中运行的表单访问，或者由已授予跨域权限的表单访问。

可以通过 Microsoft InfoPath Filler 或 Web 浏览器内打开的表单中运行的代码访问此类型或成员。

适用于

Add(XPathNavigator, String, String, String, Int32, ErrorMode)

创建并与当前窗体关联的 对象并添加一个新的 FormErrorFormErrorCollection 。

public:
 abstract Microsoft::Office::InfoPath::FormError ^ Add(System::Xml::XPath::XPathNavigator ^ context, System::String ^ name, System::String ^ message, System::String ^ messageDetails, int errorCode, Microsoft::Office::InfoPath::ErrorMode errorMode);
public abstract Microsoft.Office.InfoPath.FormError Add (System.Xml.XPath.XPathNavigator context, string name, string message, string messageDetails, int errorCode, Microsoft.Office.InfoPath.ErrorMode errorMode);
abstract member Add : System.Xml.XPath.XPathNavigator * string * string * string * int * Microsoft.Office.InfoPath.ErrorMode -> Microsoft.Office.InfoPath.FormError

参数

context
XPathNavigator

一个 XPathNavigator 对象，该对象位于将与之关联的节点。

name
String

错误的名称（不能为空白）。

message
String

用于错误的简短消息。

messageDetails
String

用于错误的详细消息。

errorCode
Int32

错误的错误代码。

errorMode
ErrorMode

一个 ErrorMode ，指定用于显示错误消息的模式。

返回

FormError

对添加到集合中的新 FormError 的引用。

例外

ArgumentException

传递给此方法的参数无效。 例如，它们的类型或格式有误。

ArgumentNullException

传递给此方法的参数是 null 引用， (Visual Basic) 中没有。

示例

在以下示例中，首先将 XPathNavigator 对象放置在将与错误关联的字段处。 然后，将 XPathNavigator、name、message、详细消息、错误代码、错误编号和错误显示模式传递给 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)

注解

FormErrorType新 FormError 的 将设置为 UserDefined。

注意：可以将具有相同 name 参数值的多个错误添加到不同的 context 节点。 但是，如果将同名错误添加到同 context 一节点两次，则添加的第二个错误将覆盖第一个错误。

此成员只能由与当前打开的表单在相同域中运行的表单访问，或者由已授予跨域权限的表单访问。

可以通过 Microsoft InfoPath Filler 或 Web 浏览器内打开的表单中运行的代码访问此类型或成员。

适用于