XmlValidatingEventArgs.ReportError Méthode

Référence

Définition

Espace de noms:: Microsoft.Office.InfoPath

Assembly:: Microsoft.Office.InfoPath.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Surcharges

ReportError(XPathNavigator, Boolean, String)	Crée un objet qui contient des FormError informations d’erreur personnalisées avec les valeurs spécifiées et l’ajoute à l’objet FormErrorCollection du formulaire.
ReportError(XPathNavigator, Boolean, String, String)	Crée un objet qui contient des FormError informations d’erreur personnalisées avec les valeurs spécifiées et l’ajoute à l’objet FormErrorCollection du formulaire.
ReportError(XPathNavigator, Boolean, String, String, Int32)	Crée un objet qui contient des FormError informations d’erreur personnalisées avec les valeurs spécifiées et l’ajoute à l’objet FormErrorCollection du formulaire.
ReportError(XPathNavigator, Boolean, String, String, Int32, ErrorMode)	Crée un objet qui contient des FormError informations d’erreur personnalisées avec les valeurs spécifiées et l’ajoute à l’objet FormErrorCollection du formulaire.

ReportError(XPathNavigator, Boolean, String)

Crée un objet qui contient des FormError informations d’erreur personnalisées avec les valeurs spécifiées et l’ajoute à l’objet FormErrorCollection du formulaire.

public:
 abstract void ReportError(System::Xml::XPath::XPathNavigator ^ node, bool siteIndependent, System::String ^ message);

public abstract void ReportError (System.Xml.XPath.XPathNavigator node, bool siteIndependent, string message);

abstract member ReportError : System.Xml.XPath.XPathNavigator * bool * string -> unit

Public MustOverride Sub ReportError (node As XPathNavigator, siteIndependent As Boolean, message As String)

Paramètres

node: XPathNavigator

XPathNavigator positionné sur le nœud qui contient les données auxquelles l’erreur est associée.

siteIndependent: Boolean

Définit la condition relative à la suppression automatique de l'objet FormError. Si la valeur est true, l’objet FormError est supprimé pour les modifications apportées aux nœuds qui correspondent à l’expression XPath retournée par la Match propriété de cet objet d’événement. Si la valeur est false, l’objet FormError est supprimé la prochaine fois que le formulaire est validé uniquement lorsque le nœud retourné par la Site propriété de cet objet événement a été modifié.

message: String

Texte à utiliser pour le message d'erreur court.

Exceptions

ArgumentException

Les paramètres transmis à cette méthode ne sont pas valides.

ArgumentNullException

Les paramètres passés à cette méthode sont une référence null (Nothing en Visual Basic).

Exemples

Dans l’exemple suivant, la Site propriété que la XmlValidatingEventArgs classe hérite de la XmlEventArgs classe est utilisée pour case activée la valeur du nœud qui a déclenché l’événement Validateing. Si la validation des données échoue, la méthode ReportError est utilisée pour créer une erreur personnalisée.

public void field1_Validating(object sender, XmlValidatingEventArgs e)
{
   if (e.Site.InnerXml != String.Empty)
   {
      int fieldValue = int.Parse((e.Site.InnerXml));

      if (fieldValue &gt; 50)
      {
         e.ReportError(e.Site,
            false,
            "Quantity cannot exceed 50.");
      }

      if (fieldValue &lt; 0)
      {
         e.ReportError(e.Site,
            false,
            "Quantity cannot be less than 0.");
      }
   }
}

Public Sub field1_Validating(ByVal sender As Object , _
   ByVal e As XmlValidatingEventArgs)
   If (e.Site.InnerXml &lt;&gt; String.Empty) Then
      Integer fieldValue = Integer.Parse((e.Site.InnerXml))

      If (fieldValue &gt; 50) Then
         e.ReportError(e.Site,
            false,
            "Quantity cannot exceed 50.")
      End If

      If (fieldValue &lt; 0) Then
         e.ReportError(e.Site,
            false,
            "Quantity cannot be less than 0.")
      End If
   End If
End Sub

Remarques

La méthode ReportError est utilisée pour créer une erreur personnalisée pour une erreur qui s’est produite pendant l’événement Validating .

Lorsque la méthode ReportError est appelée, InfoPath crée un objet FormError et l'ajoute à la collection FormErrorCollection du formulaire actif. Les objets FormError sont supprimés de la collection lorsque la contrainte de validation redevient valide. Dans certains cas, ils peuvent être supprimés explicitement à l’aide des Delete(FormError) méthodes ou DeleteAll() .

Les objets FormError peuvent également être créés à l’aide de la Add(XPathNavigator, String, String, String) méthode de la classe FormErrorCollection .

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

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.

Vous pouvez accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler ou dans un navigateur web.

S’applique à

ReportError(XPathNavigator, Boolean, String, String)

Crée un objet qui contient des FormError informations d’erreur personnalisées avec les valeurs spécifiées et l’ajoute à l’objet FormErrorCollection du formulaire.

public:
 abstract void ReportError(System::Xml::XPath::XPathNavigator ^ node, bool siteIndependent, System::String ^ message, System::String ^ messageDetails);

public abstract void ReportError (System.Xml.XPath.XPathNavigator node, bool siteIndependent, string message, string messageDetails);

abstract member ReportError : System.Xml.XPath.XPathNavigator * bool * string * string -> unit

Public MustOverride Sub ReportError (node As XPathNavigator, siteIndependent As Boolean, message As String, messageDetails As String)

Paramètres

node: XPathNavigator

XPathNavigator positionné sur le nœud qui contient les données auxquelles l’erreur est associée.

siteIndependent: Boolean

message: String

Texte à utiliser pour le message d'erreur court.

messageDetails: String

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

Exceptions

ArgumentException

Les paramètres transmis à cette méthode ne sont pas valides.

ArgumentNullException

Les paramètres passés à cette méthode sont une référence null (Nothing en Visual Basic).

Exemples

public void field1_Validating(object sender, XmlValidatingEventArgs e)
{
   if (e.Site.InnerXml != String.Empty)
   {
      int fieldValue = int.Parse((e.Site.InnerXml));

      if (fieldValue &gt; 50)
      {
         e.ReportError(e.Site,
            false,
            "Invalid quantity",
            "The total number cannot exceed 50.");
      }

      if (fieldValue &lt; 0)
      {
         e.ReportError(e.Site,
            false,
            "Invalid quantity",
            "The total number cannot be less than 0.");
      }
   }
}

Public Sub field1_Validating(ByVal sender As Object , _
   ByVal e As XmlValidatingEventArgs)
   If (e.Site.InnerXml &lt;&gt; String.Empty) Then
      Integer fieldValue = Integer.Parse((e.Site.InnerXml))

      If (fieldValue &gt; 50) Then
         e.ReportError(e.Site,
            false,
            "Invalid quantity",
            "The total number cannot exceed 50.")
      End If

      If (fieldValue &lt; 0) Then
         e.ReportError(e.Site,
            false,
            "Invalid quantity",
            "The total number cannot be less than 0.")
      End If
   End If
End Sub

Remarques

La méthode ReportError est utilisée pour créer une erreur personnalisée pour une erreur qui s’est produite pendant l’événement Validating .

Les objets FormError peuvent également être créés à l’aide de la Add(XPathNavigator, String, String, String) méthode de la classe FormErrorCollection .

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.

Vous pouvez accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler ou dans un navigateur web.

S’applique à

ReportError(XPathNavigator, Boolean, String, String, Int32)

Crée un objet qui contient des FormError informations d’erreur personnalisées avec les valeurs spécifiées et l’ajoute à l’objet FormErrorCollection du formulaire.

public:
 abstract void ReportError(System::Xml::XPath::XPathNavigator ^ node, bool siteIndependent, System::String ^ message, System::String ^ messageDetails, int errorCode);

public abstract void ReportError (System.Xml.XPath.XPathNavigator node, bool siteIndependent, string message, string messageDetails, int errorCode);

abstract member ReportError : System.Xml.XPath.XPathNavigator * bool * string * string * int -> unit

Public MustOverride Sub ReportError (node As XPathNavigator, siteIndependent As Boolean, message As String, messageDetails As String, errorCode As Integer)

Paramètres

node: XPathNavigator

XPathNavigator positionné sur le nœud qui contient les données auxquelles l’erreur est associée.

siteIndependent: Boolean

message: String

Texte à utiliser pour le message d'erreur court.

messageDetails: String

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

errorCode: Int32

Nombre à utiliser en tant que code d'erreur.

Exceptions

ArgumentException

Les paramètres transmis à cette méthode ne sont pas valides.

ArgumentNullException

Les paramètres passés à cette méthode sont une référence null (Nothing en Visual Basic).

Exemples

public void field1_Validating(object sender, XmlValidatingEventArgs e)
{
   if (e.Site.InnerXml != String.Empty)
   {
      int fieldValue = int.Parse((e.Site.InnerXml));

      if (fieldValue &gt; 50)
      {
         e.ReportError(e.Site,
            false,
            "Invalid quantity",
            "The total number cannot exceed 50.",
            12345);

      }

      if (fieldValue &lt; 0)
      {
         e.ReportError(e.Site,
            false,
            "Invalid quantity",
            "The total number cannot be less than 0.",
            12346);
      }
   }
}

Public Sub field1_Validating(ByVal sender As Object , _
   ByVal e As XmlValidatingEventArgs)
   If (e.Site.InnerXml &lt;&gt; String.Empty) Then
      Integer fieldValue = Integer.Parse((e.Site.InnerXml))

      If (fieldValue &gt; 50) Then
         e.ReportError(e.Site,
            false,
            "Invalid quantity",
            "The total number cannot exceed 50.",
            12345)
      End If

      If (fieldValue &lt; 0) Then
         e.ReportError(e.Site,
            false,
            "Invalid quantity",
            "The total number cannot be less than 0.",
            12346)
      End If
   End If
End Sub

Remarques

La méthode ReportError est utilisée pour créer une erreur personnalisée pour une erreur qui s’est produite pendant l’événement Validating .

Les objets FormError peuvent également être créés à l’aide de la Add(XPathNavigator, String, String, String) méthode de la classe FormErrorCollection .

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.

Vous pouvez accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler ou dans un navigateur web.

S’applique à

ReportError(XPathNavigator, Boolean, String, String, Int32, ErrorMode)

Crée un objet qui contient des FormError informations d’erreur personnalisées avec les valeurs spécifiées et l’ajoute à l’objet FormErrorCollection du formulaire.

public:
 abstract void ReportError(System::Xml::XPath::XPathNavigator ^ node, bool siteIndependent, System::String ^ message, System::String ^ messageDetails, int errorCode, Microsoft::Office::InfoPath::ErrorMode errorMode);

public abstract void ReportError (System.Xml.XPath.XPathNavigator node, bool siteIndependent, string message, string messageDetails, int errorCode, Microsoft.Office.InfoPath.ErrorMode errorMode);

abstract member ReportError : System.Xml.XPath.XPathNavigator * bool * string * string * int * Microsoft.Office.InfoPath.ErrorMode -> unit

Paramètres

node: XPathNavigator

XPathNavigator positionné sur le nœud qui contient les données auxquelles l’erreur est associée.

siteIndependent: Boolean

message: String

Texte à utiliser pour le message d'erreur court.

messageDetails: String

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

errorCode: Int32

Nombre à utiliser en tant que code d'erreur.

errorMode: ErrorMode

ErrorMode qui spécifie si l’erreur sera affichée dans une boîte de dialogue modale ou sans mode avec un soulignement ondulé dans le contrôle affecté.

Exceptions

ArgumentException

Les paramètres transmis à cette méthode ne sont pas valides.

ArgumentNullException

Les paramètres passés à cette méthode sont une référence null (Nothing en Visual Basic).

Exemples

public void field1_Validating(object sender, XmlValidatingEventArgs e)
{
   if (e.Site.InnerXml != String.Empty)
   {
      int fieldValue = int.Parse((e.Site.InnerXml));

      if (fieldValue &gt; 50)
      {
         e.ReportError(e.Site,
            false,
            "Invalid quantity",
            "The total number cannot exceed 50.",
            12345,
            ErrorMode.Modeless);
      }

      if (fieldValue &lt; 0)
      {
         e.ReportError(e.Site,
            false,
            "Invalid quantity",
            "The total number cannot be less than 0.",
            12346,
            ErrorMode.Modeless);
      }
   }
}

Public Sub field1_Validating(ByVal sender As Object , _
   ByVal e As XmlValidatingEventArgs)
   If (e.Site.InnerXml &lt;&gt; String.Empty) Then
      Integer fieldValue = Integer.Parse((e.Site.InnerXml))

      If (fieldValue &gt; 50) Then
         e.ReportError(e.Site,
            false,
            "Invalid quantity",
            "The total number cannot exceed 50.",
            12345,
            ErrorMode.Modeless)
      End If

      If (fieldValue &lt; 0) Then
         e.ReportError(e.Site,
            false,
            "Invalid quantity",
            "The total number cannot be less than 0.",
            12346,
            ErrorMode.Modeless)
      End If
   End If
End Sub

Remarques

La méthode ReportError est utilisée pour créer une erreur personnalisée pour une erreur qui s’est produite pendant l’événement Validating .

Les objets FormError peuvent également être créés à l’aide de la Add(XPathNavigator, String, String, String) méthode de la classe FormErrorCollection .

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.

Vous pouvez uniquement accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler.

S’applique à

Partager via

XmlValidatingEventArgs.ReportError Méthode

Définition

Surcharges

ReportError(XPathNavigator, Boolean, String)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

ReportError(XPathNavigator, Boolean, String, String)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

ReportError(XPathNavigator, Boolean, String, String, Int32)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

ReportError(XPathNavigator, Boolean, String, String, Int32, ErrorMode)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

Commentaires

Ressources supplémentaires