FormErrorCollection Clase

Definición

Espacio de nombres:

Microsoft.Office.InfoPath

Ensamblado:

Microsoft.Office.InfoPath.dll

Contiene un FormError objeto para cada error del formulario actual.

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

Herencia

Object

FormErrorCollection

Implementaciones

IEnumerable

Ejemplos

En el ejemplo siguiente, primero se pone un objeto XPathNavigator en el campo al que se va a asociar un error. A continuación, los detalles de XPathNavigator y del mensaje de error se pasan al Add método de la clase FormErrorCollection para agregar el error a la colección de errores del formulario.

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)

Comentarios

Un objeto FormErrorCollection contiene una colección de objetos FormError que representan todos los errores que se producen en el formulario asociado. La colección contiene los errores de validación, los generados por el sistema y los definidos por el usuario (personalizados). La clase FormErrorCollection proporciona propiedades y métodos para agregar y eliminar los objetos FormError que contiene, así como para tener acceso a ellos. Los errores de validación y los generados por el sistema no se pueden eliminar de esta colección.

Además de administrar los errores generados por InfoPath, la clase FormErrorCollection también se puede usar para crear errores personalizados mediante el Add método .

Nota: Los errores personalizados también se pueden crear mediante el ReportError método de la XmlValidatingEventArgs clase .

Para obtener acceso al objeto FormErrorCollection asociado a un formulario, use la Errors propiedad de la XmlForm clase .

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

Constructores

FormErrorCollection()

Contiene un FormError objeto para cada error del formulario actual.

Propiedades

Count	Obtiene el número de FormError objetos del FormErrorCollection objeto asociado al formulario actual.
Item[Int32]	Obtiene un FormError objeto del FormErrorCollection objeto asociado al formulario actual por valor de índice.

Métodos

Add(XPathNavigator, String, String, String, Int32, ErrorMode)	Crea y agrega un nuevo FormError al FormErrorCollection objeto asociado al formulario actual.
Add(XPathNavigator, String, String, String, Int32)	Crea y agrega un nuevo FormError al FormErrorCollection objeto asociado al formulario actual.
Add(XPathNavigator, String, String, String)	Crea y agrega un nuevo FormError al FormErrorCollection objeto asociado al formulario actual.
Add(XPathNavigator, String, String)	Crea y agrega un nuevo FormError al FormErrorCollection objeto asociado al formulario actual.
Delete(FormError)	Elimina el objeto especificado FormError del FormErrorCollection objeto asociado al formulario actual.
Delete(String)	Elimina todos los FormError objetos del nombre especificado del FormErrorCollection objeto asociado al formulario actual.
DeleteAll()	Elimina todos los FormError objetos contenidos en el FormErrorCollection objeto asociado al formulario actual.
GetEnumerator()	Obtiene un IEnumerator objeto que recorre en iteración todas las entradas de la colección.
GetErrors(FormErrorType)	Devuelve todos los FormError objetos del tipo especificado del FormErrorCollection objeto asociado al formulario actual.
GetErrors(String)	Devuelve todos los FormError objetos del nombre especificado del FormErrorCollection objeto asociado al formulario actual.