DataDOMEvent.ReportError - Méthode

  • Article

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

Espace de noms :  Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly :  Microsoft.Office.Interop.InfoPath.SemiTrust (dans Microsoft.Office.Interop.InfoPath.SemiTrust.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 relative à la suppression automatique de l'objet Error. Si la valeur est true, l'objet Error est supprimé lorsqu'une modification survient sur l'un des nœuds correspondant à l'expression XPath associée à l'objet Error. Si la valeur est false, l'objet Error est supprimé lorsqu'une modification survient sur le nœud renvoyé par la propriété Site d'un objet Event donné.

  • 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.SemiTrust.ErrorObject
Objet ErrorObject représentant la nouvelle Error créée.

Remarques

Lorsque la méthode ReportError est appelée, Microsoft InfoPath crée un objet Error et l'ajoute à la collection Errors. Les erreurs sont supprimées de la collection lorsque la contrainte de validation n'est plus non valide. Dans certains cas, elles peuvent être explicitement supprimées à 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 ne peut être utilisée que pendant l'événement OnValidate.

Important

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.

Exemples

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

[InfoPathEventHandler(MatchPath="/my:myFields/my:field1", EventType=InfoPathEventType.OnValidate)]
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.SemiTrust - Espace de noms