Extension-egenskapen

Microsoft Office InfoPath

En skrivebeskyttet egenskap som returnerer en referanse til det globale skriptobjektet som viser funksjonene og de globale variablene i den primære skriptfilen for et Microsoft Office InfoPath 2003-skjema.

expression.Extension

expression    Obligatorisk. Et uttrykk som returnerer en referanse til et XDocument-objekt.

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

Extension-egenskapen gjør det lettere å bruke funksjonene og de globale variablene som er implementert i skriptfilen for et InfoPath-skjema. Vanligvis brukes den fra en egendefinert oppgaverute, fra en egendefinert dialogboks eller i XSL-transformeringen (XSLT) for en visning der direkte tilgang til funksjonene og variablene kan være påkrevd.

Ett eksempel er deklarasjon av en global variabel i en skriptfil:

var constCity = "Redmond";

Du kan få tilgang til denne verdien i koden for den egendefinerte oppgaveruten eller dialogboksen ved hjelp av Extension-egenskapen, som vist nedenfor:

XDocument.Extension.constCity;

Hvis du vil bruke Extension-egenskapen i en egendefinert oppgaverute, må du først angi en referanse til XDocument-objektet ved hjelp av DHTML-egenskapen (dynamisk HTML) external i DHTML-vindusobjektet, som vist i eksemplet nedenfor:

objXDocument = window.external.XDocument;

Eksempel

I eksemplet nedenfor brukes Extension-egenskapen for XDocument-objektet til å få tilgang til en egendefinert funksjon:

objXDocument = window.external.XDocument;
objXDocument.Extension.MyCustomFunction();