Vis alt

WebServiceAdapter-objektet

WebServiceAdapter

Representerer en kobling til en XML-webtjeneste. WebServiceAdapter-objektet er en type Microsoft Office InfoPath 2003-dataadapter som inneholder all informasjon som er nødvendig for å hente data fra og sende data til en ekstern datakilde.

Merknader

WebServiceAdapter-objektet inneholder egenskaper som kan brukes til å hente og angi informasjon om dataadapterens inndata- og operasjonsstrenger. Det inneholder også en egenskap for henting av URL-adressen (Uniform Resource Locator) til WSDL-filen (Web Services Description Language) for XML-webtjenesten.

Bruke WebServiceAdapter-objektet

For sekundære datakilder er WebServiceAdapter-objektet tilgjengelig via QueryAdapter-egenskapen for DataObject-objektet, og DataObject-objekter er tilgjengelige via DataObjects-egenskapen for XDocument-objektet.

Hvis en webtjeneste brukes som primær datakilde for et skjema, er WebServiceAdapter-objektet tilgjengelig via QueryAdapter-egenskapen for XDocument-objektet.

I eksemplet nedenfor angis en referanse til WebServiceAdapter-objektet ved hjelp av QueryAdapter-egenskapen for DataObject-objektet. Dette gjøres ved å overføre navnet på DataObject-objektet til Item-egenskapen for DataObjects-samlingen:

    var objWSAdapter;

objWSAdapter = XDocument.DataObjects("GetCityList").QueryAdapter;
  

Når referansen er angitt, kan du bruke egenskapene for WebServiceAdapter-objektet som vist i eksemplet nedenfor, der det angis en referanse til XML-noden som returneres av Input-egenskapen:

    var objInputNode;

objInputNode = XDocument.DataObjects("GetCityList").QueryAdapter.Input;
  

Legg merke til at i dette tilfellet ble QueryAdapter-egenskapen brukt til å få tilgang til Input-egenskapen for WebServiceAdapter-objektet.

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

 

WebServiceAdapter-objektet inneholder følgende egenskaper:

Egenskap	Beskrivelse
ErrorsLocation	En egenskap av typen IXMLDOMNode som angir eller henter feilnoden WebServiceAdapter-objektet skal skrive feilopplysningene under som returneres av webtjenesten. Startverdien er null.
Input	Angir eller henter en streng som inneholder XML-kilden for inndataelementet i skjemadefinisjonsfilen (XSF).
Name	En skrivebeskyttet egenskap av typen String som returnerer navnet på WebServiceAdapter-objektet.
Operation	Angir eller henter en streng som inneholder XML-kilden for operasjonselementet i skjemadefinisjonsfilen (XSF).
OutputLocation	En egenskap av typen IXMLDOMNode som angir eller henter utdatanoden som WebServiceAdapter-objektet kopierer inn de returnerte XML-dataene under.
QueryAllowed	En boolsk, skrivebeskyttet egenskap som tilsvarer queryAllowed-attributtet i skjemadefinisjonsfilen (XSF).
SubmitAllowed	En boolsk, skrivebeskyttet egenskap som tilsvarer submitAllowed-attributtet i skjemadefinisjonsfilen (XSF).
Timeout	En egenskap av typen Long som angir eller henter hvor lang tid som skal gå, i sekunder, før WebServiceAdapter-objektet tidsavbrytes på etterfølgende forespørsler. Standardverdien er 30 sekunder.
WSDLURL	En skrivebeskyttet egenskap som returnerer en streng som inneholder URL-adressen (Uniform Resource Locator) til WSDL-filen (Web Services Description Language) for webtjenesten som er tilknyttet WebServiceAdapter-objektet.

WebServiceAdapter-objektet inneholder følgende metoder:

Metode	Egenskap
GenerateDataSetDiffGram	Returnerer et ADO.Net-datasett som innholder et innebygd skjema som beskriver dataene og datasettets DiffGram. DiffGram for den angitte dataDom genereres ved å bruke originaldataene for den sideordnede noden til å beregne forskjellen mellom originaldataene og den angitte dataDom.
Query	Utfører Query-metoden på WebServiceAdapter-objektet. Mislykkes hvis QueryAllowed-egenskapen er Usann.
Submit	Utfører Submit-metoden på WebServiceAdapter-objektet. Mislykkes hvis SubmitAllowed-egenskapen er Usann.