Partager via


DataDOMEvent.ReportError Méthode

Définition

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

public:
 Microsoft::Office::Interop::InfoPath::SemiTrust::ErrorObject ^ ReportError(System::Object ^ varNode, System::String ^ bstrShortErrorMessage, bool fSiteIndependent, System::String ^ bstrDetailedErrorMessage, int lErrorCode, System::String ^ bstrType);
public Microsoft.Office.Interop.InfoPath.SemiTrust.ErrorObject ReportError (object varNode, string bstrShortErrorMessage, bool fSiteIndependent, string bstrDetailedErrorMessage, int lErrorCode, string bstrType);
abstract member ReportError : obj * string * bool * string * int * string -> Microsoft.Office.Interop.InfoPath.SemiTrust.ErrorObject
Public Function ReportError (varNode As Object, bstrShortErrorMessage As String, fSiteIndependent As Boolean, bstrDetailedErrorMessage As String, lErrorCode As Integer, bstrType As String) As ErrorObject

Paramètres

varNode
Object

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

bstrShortErrorMessage
String

Texte à utiliser pour le message d'erreur court.

fSiteIndependent
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é lorsque le nœud retourné par la Site propriété d’un objet événement donné a été modifié.

bstrDetailedErrorMessage
String

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

lErrorCode
Int32

Nombre à utiliser en tant que code d'erreur.

bstrType
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 ».

Retours

Objet ErrorObject représentant l’erreur nouvellement créée.

Exemples

Dans l’exemple suivant, la Site propriété de l’objet DataDOMEventObject est utilisée pour case activée 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.<span class="label">ReportError</span>(
   e.Site, 
   "Invalid quantity. The total number of each type of block cannot exceed 50.", 
   false,
   "",
   2,
   "modeless");
 }

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

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, ils peuvent être supprimés explicitement à l’aide des Delete(Object, String) méthodes ou DeleteAll() .

Des erreurs peuvent également être créées à l’aide de la Add(Object, String, String, String, Int32, String) méthode .

Remarque : les erreurs indépendantes du 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.

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

Important : ce membre est accessible uniquement par les formulaires s’exécutant dans le même domaine que le formulaire actuellement ouvert, ou par les formulaires auxquels des autorisations inter-domaines ont été accordées.

S’applique à