En skrivebeskyttet egenskap som returnerer en strengverdi som angir verdien til en XML DOM-node (Document Object Model) som vil bli oppdatert eller satt inn under en datavalideringshendelse.
expression.NewValue
expression Obligatorisk. Returnerer en referanse til DataDOMEvent-objektet.
Sikkerhetsnivå
2: Kan åpnes bare av skjemaer som kjører på samme domene som skjemaet som i øyeblikket er åpent, eller av skjemaer som har fått tillatelser på tvers av domener.
Merknader
NewValue-egenskapen inneholder verdien til XML DOM-noden som vil erstatte den eksisterende verdien. Hvis du vil hente den opprinnelige verdien til XML DOM-noden, bruker du OldValue-egenskapen for DataDOMEvent-objektet.
Eksempel
I eksemplet fra ADO-eksempelskjemaet (ActiveX Data Objects) nedenfor brukes NewValue-egenskapen for DataDOMEvent-objektet til å finne ut om den nye verdien til XML DOM-noden er en tom streng. Hvis verdien ikke er en tom streng, angir koden at andre felt skal være tomme strenger.
function msoxd__Employees_EmployeeID_attr::OnAfterChange(eventObj)
{
if (eventObj.IsUndoRedo)
{
// An undo or redo operation has occurred and the DOM is read-only.
return;
}
if (eventObj.NewValue == "")
return;
if (XDocument.DOM.selectSingleNode
('/dfs:myFields/dfs:queryFields/q:Employees/@FirstName').text != "")
XDocument.DOM.selectSingleNode
('/dfs:myFields/dfs:queryFields/q:Employees/@FirstName').text = "";
if (XDocument.DOM.selectSingleNode
('/dfs:myFields/dfs:queryFields/q:Employees/@LastName').text != "")
XDocument.DOM.selectSingleNode
('/dfs:myFields/dfs:queryFields/q:Employees/@LastName').text = "";
}