XDocument-objektet

Microsoft Office InfoPath

Vis alt Vis alt

XDocument-objektet

XDocuments XDocument

Representerer det underliggende XML-dokumentet for et Microsoft Office InfoPath 2003-skjema.

Merknader

XDocument-objektet er et nøkkelobjekt i InfoPath-objektmodellen og inneholder egenskaper, metoder og hendelser som kan brukes programmatisk til å arbeide interaktivt med og behandle kilde-XML-dataene for et skjema.

Obs!  XDocument-objektet er bygd inn i skriptmotoren i InfoPath. Selv om XDocument-objektet er tilgjengelig via XDocuments-samlingen, vil du i de fleste tilfeller ønske direkte tilgang til objektet, uten å gå via samlingen.

Bruke XDocument-objektet

Kilde-XML-dataene for et skjema har form av en XML DOM (Document Object Model), som er tilgjengelig via DOM-egenskapen for XDocument-objektet. XDocument-objektet inneholder også en rekke egenskaper som kan brukes til å hente informasjon om skjemaet og det underliggende XML-dokumentet. Følgende kode kontrollerer for eksempel om data i skjemaet er endret, ved hjelp IsDirty-egenskapen:

    if (XDocument.IsDirty)
   XDocument.UI.Alert("Form has been changed.");
else
   XDocument.UI.Alert("Form has not been changed.");
  

I tillegg til informasjon om skjemaet og det underliggende XML-dokumentet, inneholder XDocument-objektet en rekke metoder som kan brukes i skjemaet, for eksempel til å skrive ut, lagre og sende skjemaet. Det inneholder også en rekke hendelser som kan brukes til å reagere på ulike handlinger på skjemanivå, for eksempel innlasting av skjema, bytting av visning eller en fletteoperasjon.

Få tilgang til XDocument-objektet

XDocument-objektet er tilgjengelig fra flere steder i InfoPath-objektmodellen. Tabellen nedenfor oppsummerer plasseringene der XDocument-objektet er tilgjengelig.

Navn Beskrivelse
XDocuments-samlingen Tilgjengelig fra Application-objektet. Inneholder Item-egenskapen for tilgang til XDocument-objektene.
DataDOMEvent-objektet Inneholder en XDocument-egenskap for tilgang til kilde-XML-dataene under en XML DOM-endring.
DocActionEvent-objektet Inneholder en XDocument-egenskap for tilgang til kilde-XML-dataene når en knapp klikkes i skjemaområdet.
DocEvent-objektet Inneholder en XDocument-egenskap for tilgang til kilde-XML-dataene under bytting av visning eller under en skjemaflettingsoperasjon.
DocReturnEvent-objektet Inneholder en XDocument-egenskap for tilgang til kilde-XMLen under innlasting eller sending av et skjema.
VersionUpgradeEvent-objektet Inneholder en XDocument-egenskap for tilgang til kilde-XMLen under en versjonsoppgraderingsoperasjon.
Window-objektet Inneholder en XDocument-egenskap for tilgang til XDocument-objektet som er knyttet til vinduet.

Obs!  Hvis du vil ha mer informasjon om bruk av XDocument-objektet, se Få tilgang til skjemadata.