DataDOMEvent.NewValue Eigenschaft
Definition
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.
Ruft den Wert eines XML-DOM-Knotens (Document Object Model) ab, der während eines Datenüberprüfungsereignisses aktualisiert oder eingefügt wird.
public:
property System::Object ^ NewValue { System::Object ^ get(); };
public object NewValue { get; }
member this.NewValue : obj
Public ReadOnly Property NewValue As Object
Eigenschaftswert
Beispiele
Im folgenden Beispiel wird die OldValue -Eigenschaft des DataDOMEventObject -Objekts verwendet, um den ursprünglichen Wert eines XML-DOM-Knotens zusammen mit seinem NewValue anzuzeigen:
thisXDocument.UI.Alert("Original value: " + e.OldValue.ToString() + "\nNew value: " + e.<span class="label">NewValue</span>.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.<span class="label">NewValue</span>.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 = "";
Hinweise
Die NewValue-Eigenschaft enthält den Wert des XML-DOM-Knotens, der den vorhandenen Wert ersetzt. Verwenden Sie die -Eigenschaft, um den OldValue ursprünglichen Wert des XML-DOM-Knotens abzurufen.
Wichtig: Auf dieses Mitglied kann nur über Formulare zugegriffen werden, die in derselben Domäne wie das aktuell geöffnete Formular ausgeführt werden, oder über Formulare, denen domänenübergreifende Berechtigungen erteilt wurden.