Hozzon létre egy proxy osztály xml-webszolgáltatás

Ez a rész elkötelezett örökölt technológiával. XML webszolgáltatások és az ügyfelek XML webszolgáltatások kell létrehozni a Windows Communication Foundation.

Alapértelmezésben a kölcsönhatás webes szolgáltatások a hálózaton az iparág szabványos protokollokat, beleértve a SOAP protokoll. Nevezetesen, az ügyfél és a webes szolgáltatás segítségével kommunikálnak SOAP üzeneteket, amelyekben a bemeneti és kimeneti paramétereket zárt XML-ben. Szerencsére abban az esetben, webes szolgáltatás ügyfelek egy összehasonlító paramétert az XML elemek és az azt követő átadása SOAP üzeneteket a hálózat proxy osztály.

Ha van egy service description létrehozásának proxy osztályt is lehetséges, ha a leírás a szolgáltatás megfelel a Web Services Description Language (WSDL). Szolgáltatás leírása határozza meg oly módon, hogy befolyásolja a webes szolgáltatás. Jelenlétében a szolgáltatás proxy osztály leírások segítségével lehet létrehozni a Wsdl.exe eszköz. Másfelől, a webszolgáltatás kliens metódusokat a proxy osztály, amely kommunikál egy webes szolgáltatás a hálózaton keresztül feldolgozásával a SOAP üzenetet küldött és fogadott a szolgáltatás is. Mivel a proxy osztály kommunikál a webes szolgáltatás az interneten, azt javasoljuk, hogy ellenőrizze, hogy az ingatlan URL-proxy osztály hivatkozik egy megbízható helyre.

Alapértelmezésben, hogy befolyásolja a webszolgáltatás proxy osztály használ SOAP protokoll HTTP-n keresztül. Azonban a Wsdl.exe eszköz lehet generálni proxy osztályt, hogy befolyásolja a webes szolgáltatás a HTTP-protokoll GET vagy POST HTTP-. Annak jelzésére, hogy a proxy osztályt kell használni a HTTP-GET vagy POST HTTP-, adja meg a program kapcsoló Wsdl.exe / protokoll. ahogy az a következő táblázatban.

Segítségével Wsdl.exe eszköz létrehozása a proxy osztály, az XML webszolgáltatások

Ahhoz, hogy hozzon létre egy proxy osztály, akkor a Web Services Description Language szerszám (Wsdl.exe) a parancssorból megadásával (legalább) URL webszolgáltatás vagy szolgáltatás leírása vagy az útvonal egy tárolt szolgáltatás leírását.

A következő gyakran használt Wsdl.exe érveket. Teljes Wsdl.exe programot szintaxis látni. Az Eszközök Web Services Description Language (Wsdl.exe).

Ha megad egy fájlt, hogy egy fájl, amely a szolgáltatás leírását. Példa.

A nyelv, amelyen hogy hozzon létre egy proxy osztály. Vannak olyan értékek, CS, VB és JS, amely megfelel a C #, Visual Basic .NET és JScript .NET. Alapértelmezésben a C # nyelvet. (Nem kötelező)

Az alkalmazott protokoll kommunikálni a webszolgáltatás módszereket. SOAP biztosítja az értékeket, HTTP-GET és POST HTTP-. Alapértelmezésben a SOAP protokoll. (Opcionális).

Névtér a proxy osztály. Az alapértelmezett érték - a globális névteret. (Nem kötelező)

A fájl neve tartalmazza a proxy osztály. Az alapértelmezett név alapul nevét az osztály, amely megvalósítja a webszolgáltatás. (Nem kötelező)

Felhasználónév csatlakozáshoz használt webkiszolgáló, amely hitelesítést igényel. (Opcionális).

A tartomány csatlakozáshoz használt webkiszolgáló, amely hitelesítést igényel. (Opcionális).

Információ a generált proxy osztály

Ha létrehoz egy proxy osztály segítségével Wsdl.exe eszköz létrehoz egy forrás fájlt egy adott nyelvet. Ez a fájl tartalmazza a proxy osztályt, amely hozzáférést biztosít a szinkron és aszinkron módszerek minden webszolgáltatás módszer. Például, ha a webes szolgáltatás tartalmazza módszerrel úgynevezett Add. a proxy osztály tartalmazza az alábbi módszerekkel hívja az Add eljárás a webszolgáltatás: Add. BeginAdd és EndAdd. Adjuk hozzá a proxy osztály módszert alkalmazzák szinkron kommunikációt az Add módszerrel a web szolgáltatást, és a módszerek és BeginAdd EndAdd használt aszinkron kommunikáció egy webes szolgáltatás módszer. További információk az aszinkron kommunikáció egy webes szolgáltatás módszer cm. Az aszinkron kommunikáció XML-webszolgáltatások.

Mindegyik módszer létrehoz egy proxy osztály tartalmazza a megfelelő kódot, hogy befolyásolja a webszolgáltatás módszer. Ha során a kommunikációs hiba lép fel a webszolgáltatás proxy osztály, majd egy kivételt dob. További információ a kivételkezelés, lásd. A gépek és dobás Kivételek az XML-webszolgáltatások.

Az, hogy a megadott paraméterek a webszolgáltatás módszer és a megfelelő módszer a proxy osztályt, eltérhet. A legtöbb esetben a sorrendben az azonos paraméterekkel. Azonban, ha a webes szolgáltatás elvárja, hogy a SOAP üzeneteket a dokumentum formátumban. lehetőség áll fenn, ha a rendelés nem azonos paraméterekkel. Ha egy webes szolgáltatás módszer kimeneti paramétereket egy bemeneti paramétere a proxy osztály kimeneti paraméterek kerülnek, miután a bemeneti paramétereket. Például a következő példakód egy webes szolgáltatás módszer MyWebMethod outStr kimeneti paraméter a bemeneti paramétere bejelentett instr. Azonban a proxy osztály instr opció bejelentett mielőtt outStr.

Bizonyos esetekben a proxy osztály által létrehozott Wsdl.exe program módszerét alkalmazza, a legkisebb közös nevező, hogy az objektumot a típusát a szolgáltatás leírását. Ennek eredményeként a típus létre a proxy osztályt eltérhet a kívánt vagy várt a fejlesztő. Például, ha a program észleli a Wsdl.exe service description típusú ArrayList. a generált proxy osztályt, egy tömbben. Ezen kívül a megfelelő objektum típus vet, nyissa meg a fájlt, amely tartalmazza a generált proxy osztályt, majd módosítsa a megfelelő objektum típusokat várható típusairól.

Lapjai generált Wsdl.exe szerszám

Ha Wsdl.exe eszköz át több szolgáltatás leírását, a következő két hibaüzenet is megjelenik.

• Figyelem! Ismétlődő service leírást TargetNamespace =<пространство_имен_схемы> -tól hiányzik.

Azt jelzi, hogy számos ilyen szolgáltatás leírások azonos paraméterekkel TargetNamespace. Mivel feltételezzük, hogy TargetNamespace paraméter egy egyedi azonosítót adott XML-dokumentum, amely ebben az esetben van egy leírás a szolgáltatást, a Wsdl.exe program feltételezi, hogy ez a két leírások ugyanazt a szolgáltatást. Ennek megfelelően a Wsdl.exe eszköz által létrehozott csak egy proxy osztály egyik üzemi leírások. Ha a várt teljesítményt más tevékenységek, ez lehet változtatni. Leírását képviselő webes szolgáltatások által létrehozott ASP.NET, akkor lehet alkalmazni a WebService attribútumot. Meghatározza egy egyedi névtér ingatlan egy osztály, amelyben a webszolgáltatások végrehajtását. Ezután névtér tulajdonság használják TargetNamespace a szolgáltatás leírása, amely egyedileg azonosítja a webszolgáltatás.