Compartir a través de

FormErrorCollection.Add (Método) (XPathNavigator, String, String)

  • Artículo

Crea un objeto FormError y lo agrega al objeto FormErrorCollection asociado al formulario.

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

Sintaxis

'Declaración
Public MustOverride Function Add ( _
    context As XPathNavigator, _
    name As String, _
    message As String _
) As FormError
'Uso
Dim instance As FormErrorCollection
Dim context As XPathNavigator
Dim name As String
Dim message As String
Dim returnValue As FormError

returnValue = instance.Add(context, name, message)

public abstract FormError Add (
    XPathNavigator context,
    string name,
    string message
)

Parámetros

  • context
    Objeto XPathNavigator situado en el nodo al que se va a asociar el error
  • name
    Nombre del error (no puede estar en blanco).
  • message
    Mensaje breve del error.

Valor devuelto

Se ha agregado a la colección una referencia al nuevo objeto FormError.

Excepciones

Tipo de excepción Condición

ArgumentNullException

Los parámetros que se han pasado a este método son null.

ArgumentException

Los parámetros que se han pasado a este método no son válidos. Por ejemplo, son de un tipo o formato no válido.

Comentarios

La propiedad FormErrorType del nuevo objeto FormError se establecerá en UserDefined.

Nota

Se pueden agregar varios errores con el mismo nombre valor del parámetro name a diferentes nodos de context. Sin embargo, si se agrega un error con el mismo nombre al mismo nodo de context dos veces, el error agregado en segundo lugar anula el primero.

Sólo pueden tener acceso a este miembro los formularios que se ejecuten en el mismo dominio que el formulario abierto actualmente o los formularios a los que se hayan concedido permisos entre dominios.

Se puede tener acceso a este tipo o miembro desde un código ejecutado en formularios abiertos en Microsoft Office InfoPath 2007 o en un explorador Web.

Ejemplo

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, el nombre y el mensaje 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.");

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.")

Vea también

Referencia

FormErrorCollection (Clase)
FormErrorCollection (Miembros)
Microsoft.Office.InfoPath (Espacio de nombres)