DataDOMEvent.ReportError - Méthode

  • Article

Crée un objet ErrorObject et l'ajoute à la collection ErrorsCollection .

Espace de noms :  Microsoft.Office.Interop.InfoPath
Assembly :  Microsoft.Office.Interop.InfoPath (dans Microsoft.Office.Interop.InfoPath.dll)

Syntaxe

'Déclaration
Function ReportError ( _
    varNode As Object, _
    bstrShortErrorMessage As String, _
    fSiteIndependent As Boolean, _
    bstrDetailedErrorMessage As String, _
    lErrorCode As Integer, _
    bstrType As String _
) As ErrorObject
'Utilisation
Dim instance As DataDOMEvent
Dim varNode As Object
Dim bstrShortErrorMessage As String
Dim fSiteIndependent As Boolean
Dim bstrDetailedErrorMessage As String
Dim lErrorCode As Integer
Dim bstrType As String
Dim returnValue As ErrorObject

returnValue = instance.ReportError(varNode, _
    bstrShortErrorMessage, fSiteIndependent, _
    bstrDetailedErrorMessage, lErrorCode, _
    bstrType)

ErrorObject ReportError(
    Object varNode,
    string bstrShortErrorMessage,
    bool fSiteIndependent,
    string bstrDetailedErrorMessage,
    int lErrorCode,
    string bstrType
)

Paramètres

  • varNode
    Type : System.Object

    Nœud DOM (Document Object Model) XML auquel est associée l'erreur.

  • bstrShortErrorMessage
    Type : System.String

    Texte à utiliser pour le message d'erreur court.

  • fSiteIndependent
    Type : System.Boolean

    Définit la condition de suppression automatique de l'objet Error . Si true, l'objet Error sera supprimé des modifications pour tous les nœuds qui correspondent à l'expression XPath correspondant à l'objet Error . Si false, l'objet Error va être supprimée lorsque le nœud renvoyé par la propriété Site d'un objet event donné a été modifié.

  • bstrDetailedErrorMessage
    Type : System.String

    Texte à utiliser pour le message d'erreur détaillé.

  • lErrorCode
    Type : System.Int32

    Nombre à utiliser en tant que code d'erreur.

  • bstrType
    Type : System.String

    La valeur par défaut est « modeless » (non modal). Détermine si le changement de valeur est automatiquement rejeté ou si l'utilisateur est invité à accepter ou refuser le changement. L'autre valeur est « modal ».

Valeur renvoyée

Type : Microsoft.Office.Interop.InfoPath.ErrorObject
L'objet ErrorObject représentant le nouvellement créé Error.

Remarques

Lorsque la méthode ReportError est appelée, Microsoft Office InfoPath 2003 crée un objet Error et l'ajoute à la collection Errors . Erreurs sont supprimées de la collection lorsque la contrainte de validation n'est plus valide. Dans certains cas, ils peuvent être explicitement supprimés à l'aide des méthodes Delete ou DeleteAll .

Des erreurs peuvent également être créées à l'aide de la méthode Add .

Notes

Les erreurs indépendantes d'un site doivent être utilisées lorsque vous souhaitez que les erreurs s'appliquent à tous les nœuds DOM XML du même type. Si vous souhaitez que l'erreur s'applique à un nœud DOM XML spécifique, utilisez des erreurs dépendantes d'un site.

Notes

La méthode ReportError peut uniquement être utilisée lors de l'événement OnValidate .

Exemples

Dans l'exemple suivant, la propriété Site de l'objet DataDOMEventObject est utilisée pour vérifier la valeur du nœud. En cas d'échec de la validation des données, la méthode ReportError est utilisée pour créer une erreur personnalisée.

public void field1_OnValidate(DataDOMEvent e)
{
 if (int.Parse(e.Site.text) > 50)
 {
  e.ReportError(
   e.Site, 
   "Invalid quantity. The total number of each type of block cannot exceed 50.", 
   false,
   "",
   2,
   "modeless");
 }

 if (int.Parse(e.Site.text) < 0)
 {
  e.ReportError(
   e.Site, 
   "Invalid quantity. The total number of each type of block cannot be less than 0.", 
   false,
   "",
   2,
   "modeless");
 }
}

Voir aussi

Référence

DataDOMEvent interface

DataDOMEvent - Membres

Microsoft.Office.Interop.InfoPath - Espace de noms