Errors.Add - Méthode
Ajoute un ErrorObject à ErrorsCollection et renvoie une référence au nouvel objet Error .
Espace de noms : Microsoft.Office.Interop.InfoPath
Assembly : Microsoft.Office.Interop.InfoPath (dans Microsoft.Office.Interop.InfoPath.dll)
Syntaxe
'Déclaration
Function Add ( _
varNode As Object, _
bstrConditionName As String, _
bstrShortErrorMessage As String, _
bstrDetailedErrorMessage As String, _
lErrorCode As Integer, _
bstrType As String _
) As ErrorObject
'Utilisation
Dim instance As Errors
Dim varNode As Object
Dim bstrConditionName As String
Dim bstrShortErrorMessage As String
Dim bstrDetailedErrorMessage As String
Dim lErrorCode As Integer
Dim bstrType As String
Dim returnValue As ErrorObject
returnValue = instance.Add(varNode, bstrConditionName, _
bstrShortErrorMessage, bstrDetailedErrorMessage, _
lErrorCode, bstrType)
ErrorObject Add(
Object varNode,
string bstrConditionName,
string bstrShortErrorMessage,
string bstrDetailedErrorMessage,
int lErrorCode,
string bstrType
)
Paramètres
varNode
Type : System.ObjectNœud XML auquel l'erreur est associée.
bstrConditionName
Type : System.StringNom de l'erreur.
bstrShortErrorMessage
Type : System.StringMessage court de l'erreur.
bstrDetailedErrorMessage
Type : System.StringMessage détaillé de l'erreur.
lErrorCode
Type : System.Int32Code de l'erreur.
bstrType
Type : System.StringLa valeur par défaut est « modeless ». Type d'erreur de traitement. L'autre valeur prise en charge est « modal ».
Valeur renvoyée
Type : Microsoft.Office.Interop.InfoPath.ErrorObject
Objet ErrorObject qui représente la nouvellement créé Error.
Remarques
La méthode Add permet de 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 (non modal) |
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. |
modal |
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. |
Notes
Des erreurs personnalisées peuvent également être créées à l'aide de la méthode ReportError .
Exemples
//Add an error to the node
IXMLDOMDocument myDOM = thisXDocument.DOM;
IXMLDOMNode myNode = myDOM.selectSingleNode("my:myFields/my:aGroup/my:field1");
thisXDocument.Errors.Add(myNode,"condition","short","detail",102057,"modeless");