Vis alt

DataObject-objektet

DataObjects DataObject

Representerer en kobling til dataadapteren for en sekundær datakilde. DataObject-objektet fungerer som et mellomledd mellom et Microsoft Office InfoPath 2003-skjema og dataadapterobjektet som brukes til å få tilgang til data i en ekstern datakilde.

DataObject-objektet inneholder egenskaper og metoder som kan brukes programmatisk til å arbeide interaktivt med dataadapterobjekter, blant annet til å hente informasjon om dataadapterobjekter og få tilgang til dataene de er koblet til. DataObject-objektet er tilgjengelig via DataObjects-egenskapen for XDocument-objektet.

Merknader

En ekstern datakilde kan være en Microsoft Access- eller Microsoft SQL Server-database, en .xml-fil eller en XML-webtjeneste. Hva slags dataadapterobjekt som skal brukes til å få tilgang til den eksterne datakilden, avhenger av typen datakilde. DataObject-objektet inneholder vanlig brukte egenskaper og en metode som kan brukes for alle typer dataadapterobjekter, og hvert av dataadapterobjektene inneholder egne egenskaper og metoder.

Microsoft Office InfoPath 2003 støtter tre typer dataadaptere:

1. ActiveX Data Objects   Representeres av ADOAdapter-objektet.
2. Webtjenester   Representeres av WebServiceAdapter-objektet.
3. XML-fil   Representeres av XMLFileAdapter-objektet.

Bruke DataObject-objektet

I eksempelkoden nedenfor overføres navnet på den sekundære datakilden til Item-egenskapen for DataObjects-samlingen, som returnerer en referanse til DataObject-objektet, som i dette tilfellet er knyttet til et ADOAdapter-dataadapterobjekt. Ved hjelp av QueryAdapter-egenskapen for DataObject-objektet brukes ADOAdapter-dataadapterobjektets Connection-egenskap til å vise ADO-koblingsstrengen i en meldingsboks.

    function TestDataObjects()
{
   var objDataObject;
	
   // Set a reference to the specified data object.
   objDataObject = XDocument.DataObjects("CityList");
	
   // Display the connection information for the ADOAdapter object.
   XDocument.UI.Alert("Data Adapter: " + objDataObject.QueryAdapter.Connection);
	
   objDataObject = null;
}

  

Hvis du vil ha mer informasjon om bruk av DataObject-objektet, se Få tilgang til eksterne datakilder.