Compartir a través de


FormErrorCollection.Add Método

Definición

Sobrecargas

Add(XPathNavigator, String, String)

Crea y agrega un nuevo FormError al FormErrorCollection objeto asociado al formulario actual.

Add(XPathNavigator, String, String, String)

Crea y agrega un nuevo FormError al FormErrorCollection objeto asociado al formulario actual.

Add(XPathNavigator, String, String, String, Int32)

Crea y agrega un nuevo FormError al FormErrorCollection objeto asociado al formulario actual.

Add(XPathNavigator, String, String, String, Int32, ErrorMode)

Crea y agrega un nuevo FormError al FormErrorCollection objeto asociado al formulario actual.

Add(XPathNavigator, String, String)

Crea y agrega un nuevo FormError al FormErrorCollection objeto asociado al formulario actual.

public:
 abstract Microsoft::Office::InfoPath::FormError ^ Add(System::Xml::XPath::XPathNavigator ^ context, System::String ^ name, System::String ^ message);
public abstract Microsoft.Office.InfoPath.FormError Add(System.Xml.XPath.XPathNavigator context, string name, string message);
abstract member Add : System.Xml.XPath.XPathNavigator * string * string -> Microsoft.Office.InfoPath.FormError
Public MustOverride Function Add (context As XPathNavigator, name As String, message As String) As FormError

Parámetros

context
XPathNavigator

Objeto XPathNavigator situado en el nodo al que se asociará el error.

name
String

Nombre del error (no puede estar en blanco).

message
String

Mensaje breve del error.

Devoluciones

Referencia a la nueva FormError que se agregó a la colección.

Excepciones

Los parámetros pasados a este método son una referencia nula (Nothing en Visual Basic).

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.

Ejemplos

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 XPathNavigator, el nombre y el Add mensaje se pasan al método 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.")

Comentarios

Del FormErrorType nuevo FormError se establecerá en UserDefined.

Nota: Es posible agregar varios errores con el mismo name valor de parámetro a distintos context nodos. Sin embargo, si agrega dos veces un error con el mismo nombre al mismo context nodo, el segundo error agregado sobrescribe el primero.

Únicamente se puede acceder a este miembro con formularios que se ejecuten en el mismo dominio que el formulario que está actualmente abierto o con formularios a los que se hayan concedido permisos entre dominios.

Se puede acceder a este tipo o miembro desde el código que se ejecuta en los formularios abiertos en Microsoft InfoPath Filler o en un explorador web.

Se aplica a

Add(XPathNavigator, String, String, String)

Crea y agrega un nuevo FormError al FormErrorCollection objeto asociado al formulario actual.

public:
 abstract Microsoft::Office::InfoPath::FormError ^ Add(System::Xml::XPath::XPathNavigator ^ context, System::String ^ name, System::String ^ message, System::String ^ messageDetails);
public abstract Microsoft.Office.InfoPath.FormError Add(System.Xml.XPath.XPathNavigator context, string name, string message, string messageDetails);
abstract member Add : System.Xml.XPath.XPathNavigator * string * string * string -> Microsoft.Office.InfoPath.FormError
Public MustOverride Function Add (context As XPathNavigator, name As String, message As String, messageDetails As String) As FormError

Parámetros

context
XPathNavigator

Objeto XPathNavigator situado en el nodo al que se asociará el error.

name
String

Nombre del error (no puede estar en blanco).

message
String

Mensaje breve del error.

messageDetails
String

Mensaje detallado del error.

Devoluciones

Referencia a la nueva FormError que se agregó a la colección.

Excepciones

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.

Los parámetros pasados a este método son una referencia nula (Nothing en Visual Basic).

Ejemplos

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 XPathNavigator, el nombre, el mensaje y el Add mensaje detallado se pasan al método 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.", 
   "Detailed error description.", 102057, ErrorMode.Modeless);
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.", 
   "Detailed error description.", 102057, ErrorMode.Modeless)

Comentarios

Del FormErrorType nuevo FormError se establecerá en UserDefined.

Nota: Es posible agregar varios errores con el mismo name valor de parámetro a distintos context nodos. Sin embargo, si agrega dos veces un error con el mismo nombre al mismo context nodo, el segundo error agregado sobrescribe el primero.

Únicamente se puede acceder a este miembro con formularios que se ejecuten en el mismo dominio que el formulario que está actualmente abierto o con formularios a los que se hayan concedido permisos entre dominios.

Se puede acceder a este tipo o miembro desde el código que se ejecuta en los formularios abiertos en Microsoft InfoPath Filler o en un explorador web.

Se aplica a

Add(XPathNavigator, String, String, String, Int32)

Crea y agrega un nuevo FormError al FormErrorCollection objeto asociado al formulario actual.

public:
 abstract Microsoft::Office::InfoPath::FormError ^ Add(System::Xml::XPath::XPathNavigator ^ context, System::String ^ name, System::String ^ message, System::String ^ messageDetails, int errorCode);
public abstract Microsoft.Office.InfoPath.FormError Add(System.Xml.XPath.XPathNavigator context, string name, string message, string messageDetails, int errorCode);
abstract member Add : System.Xml.XPath.XPathNavigator * string * string * string * int -> Microsoft.Office.InfoPath.FormError
Public MustOverride Function Add (context As XPathNavigator, name As String, message As String, messageDetails As String, errorCode As Integer) As FormError

Parámetros

context
XPathNavigator

Objeto XPathNavigator situado en el nodo al que se asociará el error.

name
String

Nombre del error (no puede estar en blanco).

message
String

Mensaje breve del error.

messageDetails
String

Mensaje detallado del error.

errorCode
Int32

Código del error.

Devoluciones

Referencia a la nueva FormError que se agregó a la colección.

Excepciones

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.

Los parámetros pasados a este método son una referencia nula (Nothing en Visual Basic).

Ejemplos

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 XPathNavigator, el nombre, el mensaje, el mensaje detallado, el código de error y el Add número de error se pasan al método 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.", 
   "Detailed error description.", 102057);
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.", 
   "Detailed error description.", 102057)

Comentarios

Del FormErrorType nuevo FormError se establecerá en UserDefined.

Nota: Es posible agregar varios errores con el mismo name valor de parámetro a distintos context nodos. Sin embargo, si agrega dos veces un error con el mismo nombre al mismo context nodo, el segundo error agregado sobrescribe el primero.

Únicamente se puede acceder a este miembro con formularios que se ejecuten en el mismo dominio que el formulario que está actualmente abierto o con formularios a los que se hayan concedido permisos entre dominios.

Se puede acceder a este tipo o miembro desde el código que se ejecuta en los formularios abiertos en Microsoft InfoPath Filler o en un explorador web.

Se aplica a

Add(XPathNavigator, String, String, String, Int32, ErrorMode)

Crea y agrega un nuevo FormError al FormErrorCollection objeto asociado al formulario actual.

public:
 abstract Microsoft::Office::InfoPath::FormError ^ Add(System::Xml::XPath::XPathNavigator ^ context, System::String ^ name, System::String ^ message, System::String ^ messageDetails, int errorCode, Microsoft::Office::InfoPath::ErrorMode errorMode);
public abstract Microsoft.Office.InfoPath.FormError Add(System.Xml.XPath.XPathNavigator context, string name, string message, string messageDetails, int errorCode, Microsoft.Office.InfoPath.ErrorMode errorMode);
abstract member Add : System.Xml.XPath.XPathNavigator * string * string * string * int * Microsoft.Office.InfoPath.ErrorMode -> Microsoft.Office.InfoPath.FormError

Parámetros

context
XPathNavigator

Objeto XPathNavigator situado en el nodo al que se asociará el error.

name
String

Nombre del error (no puede estar en blanco).

message
String

Mensaje breve del error.

messageDetails
String

Mensaje detallado del error.

errorCode
Int32

Código del error.

errorMode
ErrorMode

que ErrorMode especifica el modo para mostrar el mensaje de error.

Devoluciones

Referencia a la nueva FormError que se agregó a la colección.

Excepciones

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.

Los parámetros pasados a este método son una referencia nula (Nothing en Visual Basic).

Ejemplos

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 XPathNavigator, el nombre, el mensaje, el mensaje detallado, el código de error, el número de error y el Add modo de visualización de errores se pasan al método 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.", 
   "Detailed error description.", 102057, ErrorMode.Modeless);
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.", 
   "Detailed error description.", 102057, ErrorMode.Modeless)

Comentarios

Del FormErrorType nuevo FormError se establecerá en UserDefined.

Nota: Es posible agregar varios errores con el mismo name valor de parámetro a distintos context nodos. Sin embargo, si agrega dos veces un error con el mismo nombre al mismo context nodo, el segundo error agregado sobrescribe el primero.

Únicamente se puede acceder a este miembro con formularios que se ejecuten en el mismo dominio que el formulario que está actualmente abierto o con formularios a los que se hayan concedido permisos entre dominios.

Se puede acceder a este tipo o miembro desde el código que se ejecuta en los formularios abiertos en Microsoft InfoPath Filler o en un explorador web.

Se aplica a