DataDOMEvent.ReportError Método

Definición

Espacio de nombres:

Microsoft.Office.Interop.InfoPath.SemiTrust

Ensamblado:

Microsoft.Office.Interop.InfoPath.SemiTrust.dll

Crea un ErrorObject objeto y lo agrega a la ErrorsCollection colección.

public:
 Microsoft::Office::Interop::InfoPath::SemiTrust::ErrorObject ^ ReportError(System::Object ^ varNode, System::String ^ bstrShortErrorMessage, bool fSiteIndependent, System::String ^ bstrDetailedErrorMessage, int lErrorCode, System::String ^ bstrType);

public Microsoft.Office.Interop.InfoPath.SemiTrust.ErrorObject ReportError (object varNode, string bstrShortErrorMessage, bool fSiteIndependent, string bstrDetailedErrorMessage, int lErrorCode, string bstrType);

abstract member ReportError : obj * string * bool * string * int * string -> Microsoft.Office.Interop.InfoPath.SemiTrust.ErrorObject

Public Function ReportError (varNode As Object, bstrShortErrorMessage As String, fSiteIndependent As Boolean, bstrDetailedErrorMessage As String, lErrorCode As Integer, bstrType As String) As ErrorObject

Parámetros

varNode

Object

Nodo Modelo de objetos de documento (DOM) XML al que está asociado el error.

bstrShortErrorMessage

String

Texto utilizado para el mensaje de error breve.

fSiteIndependent

Boolean

Establece la condición para la supresión automática del objeto Error. Si es true, el objeto Error se eliminará al cambiar en todos los nodos que coincidan la expresión XPath correspondiente al objeto Error. Si es false, el objeto Error se eliminará cuando se haya cambiado el nodo devuelto por la Site propiedad de un objeto de evento determinado.

bstrDetailedErrorMessage

String

Texto utilizado para el mensaje de error detallado.

lErrorCode

Int32

Número utilizado como código de error.

bstrType

String

El valor predeterminado es "modeless". Determina si un cambio de valor se rechazará automáticamente o si se preguntará al usuario si desea aceptar o rechazar dicho cambio. El otro valor válido es "modal".

Devoluciones

ErrorObject

Objeto ErrorObject que representa el error recién creado.

Ejemplos

En el ejemplo siguiente, se usa la SiteDataDOMEventObject propiedad del objeto para comprobar el valor del nodo. Si la validación de datos no se realiza con éxito, se utilizará el método ReportError para crear un error personalizado.

[InfoPathEventHandler(MatchPath="/my:myFields/my:field1", EventType=InfoPathEventType.OnValidate)]
public void field1_OnValidate(DataDOMEvent e)
{
 if (int.Parse(e.Site.text) > 50)
 {
  e.<span class="label">ReportError</span>(
   e.Site, 
   "Invalid quantity. The total number of each type of block cannot exceed 50.", 
   false,
   "",
   2,
   "modeless");
 }

 if (int.Parse(e.Site.text) &lt; 0)
 {
  e.ReportError(
   e.Site, 
   "Invalid quantity. The total number of each type of block cannot be less than 0.", 
   false,
   "",
   2,
   "modeless");
 }
}

Comentarios

Cuando se llama al método ReportError , Microsoft InfoPath crea un objeto Error y lo agrega a la colección Errors . Los errores se quitan de la colección cuando la restricción de validación deja de ser no válida. En determinados casos, se pueden quitar explícitamente mediante los Delete(Object, String) métodos o DeleteAll() .

Los errores también se pueden crear mediante el Add(Object, String, String, String, Int32, String) método .

Nota: Los errores independientes del sitio deben usarse cuando desee que los errores se apliquen a todos los nodos DOM XML del mismo tipo. Si únicamente desea aplicar el error a un nodo XML DOM determinado, deberá utilizar errores independientes del sitio.

Nota: El método ReportError solo se puede usar durante el OnValidate evento.

Importante: Solo se puede acceder a este miembro mediante formularios que se ejecutan en el mismo dominio que el formulario abierto actualmente o mediante formularios a los que se han concedido permisos entre dominios.