Freigeben über


DataDOMEvent.NewValue Eigenschaft

Definition

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.

Gilt für: