DataDOMEvent.ReportError-Methode

Článek
04/27/2010

Erstellt ein ErrorObject-Objekt und fügt es der ErrorsCollection-Auflistung hinzu.

Diese Methode ist nicht CLS-kompatibel.

Namespace: Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly: Microsoft.Office.Interop.InfoPath.SemiTrust (in microsoft.office.interop.infopath.semitrust.dll)

Syntax

'Declaration
<DispIdAttribute(8)> _
Function ReportError ( _
    varNode As Object, _
    bstrShortErrorMessage As String, _
    fSiteIndependent As Boolean, _
    bstrDetailedErrorMessage As String, _
    lErrorCode As Integer, _
    bstrType As String _
) As ErrorObject
'Usage
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)

[DispIdAttribute(8)] 
ErrorObject ReportError (
    Object varNode,
    string bstrShortErrorMessage,
    bool fSiteIndependent,
    string bstrDetailedErrorMessage,
    int lErrorCode,
    string bstrType
)

Parameter

varNode
Der XML-DOM-Knoten (Document Object Model), dem der Fehler zugeordnet ist.

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

fSiteIndependent
Legt die Bedingung für das automatische Löschen des Error-Objekts fest. Wird true festgelegt, wird das Error-Objekt bei Änderungen aller Knoten, die mit dem XPath-Ausdruck für das Error-Objekt übereinstimmten, gelöscht. Wird der false-Wert festgelegt, wird das Error-Objekt gelöscht, wenn der von der Site-Eigenschaft eines bestimmten Ereignisobjekts zurückgegebene Knoten geändert wird.

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

lErrorCode
Die Zahl, die als Fehlercode verwendet werden soll.

bstrType
Der Standardwert ist "modeless". Bestimmt, ob die Änderung des Werts automatisch abgelehnt wird oder ob der Benutzer aufgefordert wird, die Änderung anzunehmen oder abzulehnen. Der andere Wert ist "modal".

Rückgabewert

Das ErrorObject-Objekt, das das neu erstellte Error-Objekt darstellt.

Hinweise

Wenn die ReportError-Methode aufgerufen wird, erstellt Microsoft Office InfoPath 2007 ein Error-Objekt und fügt es der Errors-Auflistung hinzu. Fehler werden aus der Auflistung entfernt, wenn die Überprüfungseinschränkung nicht mehr ungültig ist oder wenn sie explizit mithilfe der Methoden Delete oder DeleteAll entfernt werden.

Fehler können auch mit der Add-Methode erstellt werden.

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

Hinweis:
Die ReportError-Methode kann nur während des OnValidate-Ereignisses verwendet werden.

Wichtig:
Auf den Member kann nur über Formulare zugegriffen werden, die in derselben Domäne wie das zurzeit geöffnete Formular ausgeführt werden, oder über Formulare, denen domänenübergreifende Berechtigungen erteilt wurden.

Beispiel

Im folgenden Beispiel wird die Site-Eigenschaft des DataDOMEventObject-Objekts zum Überprüfen des Werts des Knotens verwendet. Falls bei der Datenüberprüfung ein Fehler auftritt, wird die ReportError-Methode verwendet, um einen benutzerdefinierten Fehler zu erstellen.

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

Siehe auch

Referenz

DataDOMEvent-Schnittstelle
DataDOMEvent-Member
Microsoft.Office.Interop.InfoPath.SemiTrust-Namespace

Sdílet prostřednictvím