FormErrorCollection (Clase)

Contiene un objeto FormError para cada error del formulario.

Espacio de nombres: Microsoft.Office.InfoPath
Ensamblado: Microsoft.Office.InfoPath (en microsoft.office.infopath.dll)

Sintaxis

<DefaultMemberAttribute("Item")> _
Public MustInherit Class FormErrorCollection
    Implements IEnumerable

Dim instance As FormErrorCollection

[DefaultMemberAttribute("Item")] 
public abstract class FormErrorCollection : IEnumerable

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 se puede usar también para crear errores personalizados con el método Add.

Nota:
También se pueden crear errores personalizados con el método ReportError de la clase XmlValidatingEventArgs.

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

FormErrorCollection myErrors = this.Errors;

Dim myErrors As FormErrorCollection = Me.Errors

Ejemplo

En el ejemplo siguiente, primero se pone un objeto XPathNavigator en el campo al que se va a asociar un error. A continuación, el objeto XPathNavigator y los datos del mensaje de error se pasan al método Add 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)

Jerarquía de herencia

System.Object
  Microsoft.Office.InfoPath.FormErrorCollection

Seguridad de subprocesos

Todos los miembros estáticos públicos (compartidos en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancia sean seguros para los subprocesos.

Vea también

Referencia

FormErrorCollection (Miembros)
Microsoft.Office.InfoPath (Espacio de nombres)