XmlValidatingEventArgs.ReportError Methode

Referenz

Definition

Namespace:: Microsoft.Office.InfoPath

Assembly:: Microsoft.Office.InfoPath.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Überlädt

ReportError(XPathNavigator, Boolean, String)	Erstellt ein FormError -Objekt, das benutzerdefinierte Fehlerinformationen mit den angegebenen Werten enthält, und fügt es dem FormErrorCollection -Objekt des Formulars hinzu.
ReportError(XPathNavigator, Boolean, String, String)	Erstellt ein FormError -Objekt, das benutzerdefinierte Fehlerinformationen mit den angegebenen Werten enthält, und fügt es dem FormErrorCollection -Objekt des Formulars hinzu.
ReportError(XPathNavigator, Boolean, String, String, Int32)	Erstellt ein FormError -Objekt, das benutzerdefinierte Fehlerinformationen mit den angegebenen Werten enthält, und fügt es dem FormErrorCollection -Objekt des Formulars hinzu.
ReportError(XPathNavigator, Boolean, String, String, Int32, ErrorMode)	Erstellt ein FormError -Objekt, das benutzerdefinierte Fehlerinformationen mit den angegebenen Werten enthält, und fügt es dem FormErrorCollection -Objekt des Formulars hinzu.

ReportError(XPathNavigator, Boolean, String)

Erstellt ein FormError -Objekt, das benutzerdefinierte Fehlerinformationen mit den angegebenen Werten enthält, und fügt es dem FormErrorCollection -Objekt des Formulars hinzu.

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)

Parameter

node: XPathNavigator

Eine XPathNavigator , die auf dem Knoten positioniert ist, der die Daten enthält, denen der Fehler zugeordnet ist.

siteIndependent: Boolean

Legt die Bedingung für die automatische Löschung des FormError-Objekts fest. Wenn dieser Wert auf true festgelegt ist, wird das FormError-Objekt für Änderungen an allen Knoten gelöscht, die dem von der Match -Eigenschaft dieses Ereignisobjekts zurückgegebenen XPath-Ausdruck entsprechen. Wenn der Wert auf false festgelegt ist, wird das FormError-Objekt nur dann gelöscht, wenn das Formular das nächste Mal überprüft wird, wenn der von der Site -Eigenschaft dieses Ereignisobjekts zurückgegebene Knoten geändert wurde.

message: String

Der Text, der für die kurze Fehlermeldung verwendet werden soll.

Ausnahmen

ArgumentException

Die an diese Methode übergebenen Parameter sind nicht gültig.

ArgumentNullException

Die an diese Methode übergebenen Parameter sind ein NULL-Verweis (Nothing in Visual Basic).

Beispiele

Im folgenden Beispiel wird die Site Eigenschaft, die die XmlValidatingEventArgs Klasse von der XmlEventArgs -Klasse erbt, verwendet, um den Wert des Knotens zu überprüfen, der das Validating-Ereignis ausgelöst hat. Wenn die Datenüberprüfung fehlerhaft ist, wird die ReportError-Methode verwendet, um einen benutzerdefinierten Fehler zu erstellen:

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

Hinweise

Die ReportError-Methode wird verwendet, um einen benutzerdefinierten Fehler für einen Fehler zu erstellen, der während des Validating Ereignisses aufgetreten ist.

Wenn die ReportError-Methode aufgerufen wird, erstellt InfoPath ein FormError-Objekt und fügt es der FormErrorCollection-Auflistung des aktuellen Formulars hinzu. FormError-Objekte werden aus der Auflistung entfernt, wenn die Gültigkeitsbeschränkung nicht mehr ungültig ist. In bestimmten Fällen können sie explizit mit den Delete(FormError) Methoden oder DeleteAll() entfernt werden.

FormError-Objekte können auch mit der Add(XPathNavigator, String, String, String) -Methode der FormErrorCollection-Klasse erstellt werden.

Hinweis: Standortunabhängige Fehler sollten verwendet werden, wenn die Fehler auf alle Knoten desselben Typs angewendet werden sollen. Wenn der Fehler nur auf einen bestimmten Knoten angewendet werden soll, müssen Sie siteabhängige Fehler verwenden.

Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.

Auf diesen Typ oder dieses Mitglied kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler oder in einem Webbrowser geöffnet wurden.

Gilt für:

ReportError(XPathNavigator, Boolean, String, String)

Erstellt ein FormError -Objekt, das benutzerdefinierte Fehlerinformationen mit den angegebenen Werten enthält, und fügt es dem FormErrorCollection -Objekt des Formulars hinzu.

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)

Parameter

node: XPathNavigator

Eine XPathNavigator , die auf dem Knoten positioniert ist, der die Daten enthält, denen der Fehler zugeordnet ist.

siteIndependent: Boolean

message: String

Der Text, der für die kurze Fehlermeldung verwendet werden soll.

messageDetails: String

Der Text, der für die ausführliche Fehlermeldung verwendet werden soll.

Ausnahmen

ArgumentException

Die an diese Methode übergebenen Parameter sind nicht gültig.

ArgumentNullException

Die an diese Methode übergebenen Parameter sind ein NULL-Verweis (Nothing in Visual Basic).

Beispiele

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

Hinweise

Die ReportError-Methode wird verwendet, um einen benutzerdefinierten Fehler für einen Fehler zu erstellen, der während des Validating Ereignisses aufgetreten ist.

FormError-Objekte können auch mit der Add(XPathNavigator, String, String, String) -Methode der FormErrorCollection-Klasse erstellt werden.

Auf diesen Typ oder dieses Mitglied kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler oder in einem Webbrowser geöffnet wurden.

Gilt für:

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

Erstellt ein FormError -Objekt, das benutzerdefinierte Fehlerinformationen mit den angegebenen Werten enthält, und fügt es dem FormErrorCollection -Objekt des Formulars hinzu.

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)

Parameter

node: XPathNavigator

Eine XPathNavigator , die auf dem Knoten positioniert ist, der die Daten enthält, denen der Fehler zugeordnet ist.

siteIndependent: Boolean

message: String

Der Text, der für die kurze Fehlermeldung verwendet werden soll.

messageDetails: String

Der Text, der für die ausführliche Fehlermeldung verwendet werden soll.

errorCode: Int32

Die Zahl, die als Fehlercode verwendet werden soll.

Ausnahmen

ArgumentException

Die an diese Methode übergebenen Parameter sind nicht gültig.

ArgumentNullException

Die an diese Methode übergebenen Parameter sind ein NULL-Verweis (Nothing in Visual Basic).

Beispiele

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

Hinweise

Die ReportError-Methode wird verwendet, um einen benutzerdefinierten Fehler für einen Fehler zu erstellen, der während des Validating Ereignisses aufgetreten ist.

FormError-Objekte können auch mit der Add(XPathNavigator, String, String, String) -Methode der FormErrorCollection-Klasse erstellt werden.

Auf diesen Typ oder dieses Mitglied kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler oder in einem Webbrowser geöffnet wurden.

Gilt für:

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

Erstellt ein FormError -Objekt, das benutzerdefinierte Fehlerinformationen mit den angegebenen Werten enthält, und fügt es dem FormErrorCollection -Objekt des Formulars hinzu.

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

Parameter

node: XPathNavigator

Eine XPathNavigator , die auf dem Knoten positioniert ist, der die Daten enthält, denen der Fehler zugeordnet ist.

siteIndependent: Boolean

message: String

Der Text, der für die kurze Fehlermeldung verwendet werden soll.

messageDetails: String

Der Text, der für die ausführliche Fehlermeldung verwendet werden soll.

errorCode: Int32

Die Zahl, die als Fehlercode verwendet werden soll.

errorMode: ErrorMode

Ein ErrorMode , der angibt, ob der Fehler in einem modalem Dialogfeld oder modelos mit einer wellenförmigen Unterstreichung im betroffenen Steuerelement angezeigt wird.

Ausnahmen

ArgumentException

Die an diese Methode übergebenen Parameter sind nicht gültig.

ArgumentNullException

Die an diese Methode übergebenen Parameter sind ein NULL-Verweis (Nothing in Visual Basic).

Beispiele

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

Hinweise

Die ReportError-Methode wird verwendet, um einen benutzerdefinierten Fehler für einen Fehler zu erstellen, der während des Validating Ereignisses aufgetreten ist.

FormError-Objekte können auch mit der Add(XPathNavigator, String, String, String) -Methode der FormErrorCollection-Klasse erstellt werden.

Auf diesen Typ oder dieses Mitglied kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler geöffnet wurden.

Gilt für:

Freigeben über

XmlValidatingEventArgs.ReportError Methode

Definition

Überlädt

ReportError(XPathNavigator, Boolean, String)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

ReportError(XPathNavigator, Boolean, String, String)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

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

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

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

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

Feedback

Zusätzliche Ressourcen