Clase FormError

Representa un error en la colección FormErrorCollection de un formulario.

Jerarquía de la herencia

System.Object
  Microsoft.Office.InfoPath.FormError

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

Sintaxis

'Declaración
Public MustInherit Class FormError
'Uso
Dim instance As FormError
public abstract class FormError

Comentarios

Cada objeto FormError de un formulario de InfoPath está asociado a un nodo del documento XML subyacente del formulario. Si se produce un error de validación en un nodo concreto, InfoPath crea un objeto FormError y lo pone en la colección FormErrorCollection asociada al formulario.

Hay tres tipos de errores de validación de datos que se pueden producir en un formulario de InfoPath. Se pueden determinar mediante la propiedad FormErrorType de la clase FormError:

  • FormErrorType.SchemaValidation   Error de validación de datos como consecuencia de una restricción definida en el esquema de XML.

  • FormErrorType.SystemGenerated   Error de validación de datos como consecuencia de restricciones definidas en el archivo de definición de formulario (.xsf) o de código de formulario que llama al método ReportError() de la clase XmlValidatingEventArgs.

  • FormErrorType.UserDefined   Error de validación de datos como consecuencia de un error personalizado definido mediante el método Add de la clase FormErrorsCollection.

Ejemplos

En el ejemplo siguiente, si se hace clic en el control Botón, se obtiene el primer error de la colección FormErrorCollection del formulario y, a continuación, se muestran los valores de todas las propiedades del objeto 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

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.

Vea también

Referencia

Miembros FormError

Espacio de nombres Microsoft.Office.InfoPath