Errors.Add(Object, String, String, String, Int32, String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Ajoute un ErrorObject à ErrorsCollection et retourne une référence au nouvel objet Error .
public Microsoft.Office.Interop.InfoPath.ErrorObject Add (object varNode, string bstrConditionName, string bstrShortErrorMessage, string bstrDetailedErrorMessage = "", int lErrorCode = 0, string bstrType = "modeless");
abstract member Add : obj * string * string * string * int * string -> Microsoft.Office.Interop.InfoPath.ErrorObject
Public Function Add (varNode As Object, bstrConditionName As String, bstrShortErrorMessage As String, Optional bstrDetailedErrorMessage As String = "", Optional lErrorCode As Integer = 0, Optional bstrType As String = "modeless") As ErrorObject
Paramètres
- varNode
- Object
Nœud XML auquel l'erreur est associée.
- bstrConditionName
- String
Nom de l'erreur.
- bstrShortErrorMessage
- String
Message court de l'erreur.
- bstrDetailedErrorMessage
- String
Message détaillé de l'erreur.
- lErrorCode
- Int32
Code de l'erreur.
- bstrType
- String
La valeur par défaut est « modeless ». Type d'erreur de traitement. L'autre valeur prise en charge est « modal ».
Retours
Objet ErrorObject qui représente l’erreur nouvellement créée.
Exemples
//Add an error to the node
IXMLDOMDocument myDOM = thisXDocument.DOM;
IXMLDOMNode myNode = myDOM.selectSingleNode("my:myFields/my:aGroup/my:field1");
thisXDocument.Errors.<span class="label">Add</span>(myNode,"condition","short","detail",102057,"modeless");
Remarques
La méthode Add est utilisée pour créer des messages d’erreur personnalisés dans un formulaire Microsoft InfoPath. Deux types d'erreurs peuvent être créés à l'aide de la méthode Add :
modeless | L'utilisateur est prévenu de l'erreur à l'aide d'une alerte insérée et peut choisir de rétablir la valeur précédente avec une opération d'annulation. |
Modale | L'utilisateur est prévenu de l'erreur à l'aide d'une alerte sous forme de boîte de dialogue. Après avoir cliqué sur OK dans l'alerte sous forme de boîte de dialogue, l'erreur s'affiche sous forme d'alerte insérée et l'utilisateur peut choisir de rétablir la valeur précédente avec une opération d'annulation. |
Remarque : des erreurs personnalisées peuvent également être créées à l’aide de la ReportError(Object, String, Boolean, String, Int32, String) méthode .