Clase FormErrorCollection
Contiene un objeto FormError para cada error del formulario.
Jerarquía de la herencia
System.Object
Microsoft.Office.InfoPath.FormErrorCollection
Espacio de nombres: Microsoft.Office.InfoPath
Ensamblado: Microsoft.Office.InfoPath (en Microsoft.Office.InfoPath.dll)
Sintaxis
'Declaración
Public MustInherit Class FormErrorCollection _
Implements IEnumerable
'Uso
Dim instance As FormErrorCollection
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
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, 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)
Seguridad para subprocesos
Los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancias sean seguros para los subprocesos.