FormErrorCollection.Add Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.
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.