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. |