DataDOMEvent.NewValue-Eigenschaft

Ruft den Wert eines XML-DOM-Knotens (Document Object Model) ab, der während eines Datenüberprüfungsereignisses aktualisiert oder eingefügt wird.

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(7)> _
ReadOnly Property NewValue As Object
'Usage
Dim instance As DataDOMEvent
Dim value As Object

value = instance.NewValue

[DispIdAttribute(7)] 
Object NewValue { get; }

Hinweise

Die NewValue-Eigenschaft enthält den Wert des XML-DOM-Knotens, der den vorhandenen Wert ersetzt. Um den ursprünglichen Wert des XML-DOM-Knotens abzurufen, verwenden Sie die OldValue-Eigenschaft.

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 OldValue-Eigenschaft des DataDOMEventObject-Objekts verwendet, um den ursprünglichen Wert eines XML-DOM-Knotens zusammen mit seinem NewValue-Wert anzuzeigen.

thisXDocument.UI.Alert("Original value: " + e.OldValue.ToString() + "\nNew value: " + e.NewValue.ToString());

Im folgenden Beispiel wird die NewValue-Eigenschaft des DataDOMEvent-Ereignisses auf einen leeren Wert überprüft. Wenn er nicht leer ist, wird der Inhalt der Felder "FirstName" und "LastName" gelöscht:

 if (e.IsUndoRedo)
 {
  // An undo or redo operation has occurred and the DOM is read-only.
  return;
 }

 // A field change has occurred and the DOM is writable. Write code here to respond
 // to the changes.
 if (e.NewValue.ToString() == "")
 return;

 if (thisXDocument.DOM.selectSingleNode("/dfs:myFields/dfs:queryFields/q:Employees/@FirstName").text != "")
thisXDocument.DOM.selectSingleNode("/dfs:myFields/dfs:queryFields/q:Employees/@FirstName").text = "";

 if (thisXDocument.DOM.selectSingleNode("/dfs:myFields/dfs:queryFields/q:Employees/@LastName").text != "")
thisXDocument.DOM.selectSingleNode("/dfs:myFields/dfs:queryFields/q:Employees/@LastName").text = "";

Siehe auch

Referenz

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