NewValue-egenskapen

Microsoft Office InfoPath

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 = "";
}