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.