Parent-egenskapen

Microsoft Office InfoPath

En skrivebeskyttet egenskap som returnerer en referanse til XML DOM-noden (Document Object Model) for den overordnede noden for XML DOM-noden som endres under en datavalideringshendelse.

expression.Parent

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

Når du har angitt en referanse til XML DOM-noden som returneres av Parent-egenskapen, kan du bruke en hvilken som helst av egenskapene og metodene som støttes av XML DOMen. Dette kan være særlig nyttig under sletteoperasjoner fordi Parent-egenskapen tilordnes til plasseringen for XML DOM-noden som ble slettet.

Obs!  Hvis du vil lære mer om XML DOM og egenskapene og metodene den støtter, se dokumentasjonen for MSXML 5.0 SDK i hjelpesystemet for Microsoft Script Editor (MSE).

Eksempel

I deleksemplet fra eksempelskjemaet Data Validation nedenfor brukes Parent-egenskapen for DataDOMEvent-objektet til å kontrollere navnet på den overordnede noden. Hvis det stemmer overens med bestemte kriterier, vises en feilmelding.

function msoxd__shippingDates::OnBeforeChange(eventObj)
{
   var objOrderDate = new Date(XDocument.DOM.selectSingleNode
      ('/sampleData/shippingDates/orderDate')
      .text.replace(/(.*)-(.*)-(.*)/, "$2-$3-$1"));
   var objShipDate = new Date(XDocument.DOM.selectSingleNode
      ('/sampleData/shippingDates/shipDate')
      .text.replace(/(.*)-(.*)-(.*)/, "$2-$3-$1"));
   ...

   if (objShipDate.toString() != "NaN" && objOrderDate.toString() == "NaN")
   {
      eventObj.ReturnMessage = "The Ship Date is invalid without an order date.";

      if (eventObj.Parent.nodeName == "orderDate")
         eventObj.ReturnMessage += "  You must delete the Ship Date " +
            "before deleting the Order Date.";

      eventObj.ReturnStatus = false;
      return;
   }
   ...
}