Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

DataDOMEvent.ReportError - Méthode

Office 2013 et versions ultérieures

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)

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.

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.

RemarqueRemarque

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.

RemarqueRemarque

La méthode ReportError ne peut être utilisée que pendant l'événement OnValidate.

Remarque importanteImportante

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.

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");
 }
}
Afficher: