Clase XmlFormCancelEventArgs

Proporciona los datos para el mensaje personalizado que se muestra al cancelar eventos desencadenados por el formulario y su documento XML subyacente.

Jerarquía de la herencia

System.Object
  System.EventArgs
    System.ComponentModel.CancelEventArgs
      Microsoft.Office.InfoPath.XmlFormCancelEventArgs
        Microsoft.Office.InfoPath.SaveCancelEventArgs

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

Sintaxis

'Declaración
Public MustInherit Class XmlFormCancelEventArgs _
    Inherits CancelEventArgs
'Uso
Dim instance As XmlFormCancelEventArgs
public abstract class XmlFormCancelEventArgs : CancelEventArgs

Comentarios

El objeto XmlFormCancelEvent proporciona las propiedades Message y MessageDetails para especificar o recuperar un mensaje personalizado al cancelar los eventos Changing, Validating, Save, Merge, Submit, VersionUpgrade y Loading.

De manera predeterminada, las propiedades Message y MessageDetails tienen un valor una referencia null (Nothing en Visual Basic).

  • Si los dos valores son una referencia null (Nothing en Visual Basic), el mensaje de error predeterminado se muestra cuando se cancela un evento.

  • Si los dos valores no son null, los valores especificados para las propiedades Message y MessageDetails se muestran en el cuadro de diálogo del mensaje de error.

  • Si las dos propiedades se establecen en una cadena vacía, no se muestra ningún texto en el cuadro de diálogo del mensaje de error.

  • La propiedad Message puede ser una referencia null (Nothing en Visual Basic) y la propiedad MessageDetails puede no ser null y viceversa. Si uno de los dos valores no es null, InfoPath mostrará el valor especificado. Por ejemplo, si Message es una referencia null (Nothing en Visual Basic), pero MessageDetails tiene un valor especificado, InfoPath muestra un cuadro de diálogo de mensaje de error sólo con la sección de información y sin texto de nivel superior.

  • En la interfaz de usuario de modo de diseño de InfoPath, puede especificar un mensaje personalizado que se muestra al enviar resultados satisfactorios o errores con el comando Opciones de envío de formularios del menú Herramientas. Si las propiedades Message o MessageDetails están definidas en código, estos valores anulan el texto especificado en la interfaz de usuario de InfoPath.

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 XmlFormCancelEventArgs

Espacio de nombres Microsoft.Office.InfoPath