DataDOMEvent.ReturnStatus-Eigenschaft

Článek
04/27/2010

Ruft einen Wert ab, der den Rückgabestatus des Datenüberprüfungsereignisses angibt, oder legt diesen Wert fest.

Diese Eigenschaft 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(101)> _
Property ReturnStatus As Boolean
'Usage
Dim instance As DataDOMEvent
Dim value As Boolean

value = instance.ReturnStatus

instance.ReturnStatus = value

[DispIdAttribute(101)] 
bool ReturnStatus { get; set; }

Hinweise

Für das OnBeforeChange-Ereignis gilt Folgendes: wenn die ReturnStatus-Eigenschaft auf false festgelegt ist, werden die Änderungen am XML-DOM-Knoten (Document Object Model) nicht angenommen, und das Datenüberprüfungsereignis ist fehlerhaft. Ist die Eigenschaft auf true festgelegt, ist kein Datenüberprüfungsfehler aufgetreten, und das Datenüberprüfungsereignis ist erfolgreich.

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 ReturnStatus-Eigenschaft des DataDOMEventObject-Objekts verwendet, um anzugeben, dass das Datenüberprüfungsereignis nicht erfolgreich war. Der Code verwendet zudem die ReturnMessage-Eigenschaft des DataDOMEventObject-Objekts, um eine Meldung für den Benutzer anzuzeigen.

[InfoPathEventHandler(MatchPath="/Customers/Customer/RepVisitDt", EventType=InfoPathEventType.OnBeforeChange)]
public void RepVisitDt_OnBeforeChange(DataDOMEvent e)
{
 if (e.NewValue.ToString() == "")
 {
  e.ReturnMessage = "You must supply a value for this field.";
  e.ReturnStatus = false;
 }
}

Siehe auch

Referenz

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

Sdílet prostřednictvím