Partager via

FormErrorCollection.Add Méthode

  • Référence

Définition

Espace de noms:
Microsoft.Office.InfoPath
Assembly:
Microsoft.Office.InfoPath.dll

Surcharges

Add(XPathNavigator, String, String)

Crée et ajoute un nouveau FormError à l’objet FormErrorCollection associé au formulaire actif.
Add(XPathNavigator, String, String, String)

Crée et ajoute un nouveau FormError à l’objet FormErrorCollection associé au formulaire actif.
Add(XPathNavigator, String, String, String, Int32)

Crée et ajoute un nouveau FormError à l’objet FormErrorCollection associé au formulaire actif.
Add(XPathNavigator, String, String, String, Int32, ErrorMode)

Crée et ajoute un nouveau FormError à l’objet FormErrorCollection associé au formulaire actif.

Add(XPathNavigator, String, String)

Crée et ajoute un nouveau FormError à l’objet FormErrorCollection associé au formulaire actif.

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

Paramètres

context
XPathNavigator

Objet XPathNavigator positionné au niveau du nœud auquel l’erreur sera associée.

name
String

Nom de l'erreur (ne peut pas rester vide).

message
String

Message court de l'erreur.

Retours

FormError

Référence au nouveau FormError qui a été ajouté à la collection.

Exceptions

ArgumentNullException

Les paramètres passés à cette méthode sont une référence null (Nothing en Visual Basic).

ArgumentException

Les paramètres transmis à cette méthode ne sont pas valides. Par exemple, ils sont d'un type ou format incorrect.

Exemples

Dans l'exemple suivant, un objet XPathNavigator est d'abord placé sur le champ auquel associer une erreur. Ensuite, le XPathNavigator, le nom et le message sont passés à la Add méthode de la classe FormErrorCollection pour ajouter l’erreur à la collection d’erreurs du formulaire.

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

Remarques

Le FormErrorType du nouveau FormError sera défini sur UserDefined.

Remarque : il est possible d’ajouter plusieurs erreurs avec la même name valeur de paramètre à différents context nœuds. Toutefois, si vous ajoutez deux fois une erreur portant le même nom au même context nœud, la deuxième erreur ajoutée remplace la première.

Seuls les formulaires qui s’exécutent dans le même domaine que le formulaire actuellement ouvert ou les formulaires disposant d’autorisations inter-domaines peuvent accéder à ce membre.

Vous pouvez accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler ou dans un navigateur web.

S’applique à

Add(XPathNavigator, String, String, String)

Crée et ajoute un nouveau FormError à l’objet FormErrorCollection associé au formulaire actif.

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

Paramètres

context
XPathNavigator

Objet XPathNavigator positionné au niveau du nœud auquel l’erreur sera associée.

name
String

Nom de l'erreur (ne peut pas rester vide).

message
String

Message court de l'erreur.

messageDetails
String

Message détaillé de l'erreur.

Retours

FormError

Référence au nouveau FormError qui a été ajouté à la collection.

Exceptions

ArgumentException

Les paramètres transmis à cette méthode ne sont pas valides. Par exemple, ils sont d'un type ou format incorrect.

ArgumentNullException

Les paramètres passés à cette méthode sont une référence null (Nothing en Visual Basic).

Exemples

Dans l'exemple suivant, un objet XPathNavigator est d'abord placé sur le champ auquel associer une erreur. Ensuite, le XPathNavigator, le nom, le message et le message détaillé sont passés à la Add méthode de la classe FormErrorCollection pour ajouter l’erreur à la collection d’erreurs du formulaire.

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)

Remarques

Le FormErrorType du nouveau FormError sera défini sur UserDefined.

Remarque : il est possible d’ajouter plusieurs erreurs avec la même name valeur de paramètre à différents context nœuds. Toutefois, si vous ajoutez deux fois une erreur portant le même nom au même context nœud, la deuxième erreur ajoutée remplace la première.

Seuls les formulaires qui s’exécutent dans le même domaine que le formulaire actuellement ouvert ou les formulaires disposant d’autorisations inter-domaines peuvent accéder à ce membre.

Vous pouvez accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler ou dans un navigateur web.

S’applique à

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

Crée et ajoute un nouveau FormError à l’objet FormErrorCollection associé au formulaire actif.

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

Paramètres

context
XPathNavigator

Objet XPathNavigator positionné au niveau du nœud auquel l’erreur sera associée.

name
String

Nom de l'erreur (ne peut pas rester vide).

message
String

Message court de l'erreur.

messageDetails
String

Message détaillé de l'erreur.

errorCode
Int32

Code de l'erreur.

Retours

FormError

Référence au nouveau FormError qui a été ajouté à la collection.

Exceptions

ArgumentException

Les paramètres transmis à cette méthode ne sont pas valides. Par exemple, ils sont d'un type ou format incorrect.

ArgumentNullException

Les paramètres passés à cette méthode sont une référence null (Nothing en Visual Basic).

Exemples

Dans l'exemple suivant, un objet XPathNavigator est d'abord placé sur le champ auquel associer une erreur. Ensuite, le XPathNavigator, le nom, le message, le message détaillé, le code d’erreur et le numéro d’erreur sont passés à la Add méthode de la classe FormErrorCollection pour ajouter l’erreur à la collection d’erreurs du formulaire.

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)

Remarques

Le FormErrorType du nouveau FormError sera défini sur UserDefined.

Remarque : il est possible d’ajouter plusieurs erreurs avec la même name valeur de paramètre à différents context nœuds. Toutefois, si vous ajoutez deux fois une erreur portant le même nom au même context nœud, la deuxième erreur ajoutée remplace la première.

Seuls les formulaires qui s’exécutent dans le même domaine que le formulaire actuellement ouvert ou les formulaires disposant d’autorisations inter-domaines peuvent accéder à ce membre.

Vous pouvez accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler ou dans un navigateur web.

S’applique à

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

Crée et ajoute un nouveau FormError à l’objet FormErrorCollection associé au formulaire actif.

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

Paramètres

context
XPathNavigator

Objet XPathNavigator positionné au niveau du nœud auquel l’erreur sera associée.

name
String

Nom de l'erreur (ne peut pas rester vide).

message
String

Message court de l'erreur.

messageDetails
String

Message détaillé de l'erreur.

errorCode
Int32

Code de l'erreur.

errorMode
ErrorMode

ErrorMode qui spécifie le mode d’affichage du message d’erreur.

Retours

FormError

Référence au nouveau FormError qui a été ajouté à la collection.

Exceptions

ArgumentException

Les paramètres transmis à cette méthode ne sont pasvalides. Par exemple, ils sont d'un type ou format incorrect.

ArgumentNullException

Les paramètres passés à cette méthode sont une référence null (Nothing en Visual Basic).

Exemples

Dans l'exemple suivant, un objet XPathNavigator est d'abord placé sur le champ auquel associer une erreur. Ensuite, le XPathNavigator, le nom, le message, le message détaillé, le code d’erreur, le numéro d’erreur et le mode d’affichage d’erreur sont passés à la Add méthode de la classe FormErrorCollection pour ajouter l’erreur à la collection d’erreurs du formulaire.

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)

Remarques

Le FormErrorType du nouveau FormError sera défini sur UserDefined.

Remarque : il est possible d’ajouter plusieurs erreurs avec la même name valeur de paramètre à différents context nœuds. Toutefois, si vous ajoutez deux fois une erreur portant le même nom au même context nœud, la deuxième erreur ajoutée remplace la première.

Seuls les formulaires qui s’exécutent dans le même domaine que le formulaire actuellement ouvert ou les formulaires disposant d’autorisations inter-domaines peuvent accéder à ce membre.

Vous pouvez accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler ou dans un navigateur web.

S’applique à