Този раздел е посветен на наследството технология. XML Web услуги и клиенти уеб услуга XML трябва да бъде създаден с помощта на Фондация Windows Communication.

По подразбиране, взаимодействието с уеб услуги в мрежата с стандартни за индустрията протоколи, включително SOAP протокол. А именно, клиента и уеб услуга общуват със сапун съобщения, в които параметрите на вход и изход са капсуловани в XML. За щастие, в случая на клиенти на уеб услуги с едно сравнение на параметрите на XML елементи и вследствие на прехвърлянето на SOAP съобщения чрез мрежовия клас пълномощник.

Ако има описание на услуги създава прокси клас е възможно, ако описанието на услугата отговаря на изискванията на Web Services Description Language (WSDL). Описание на услугата се определя по начин, за да взаимодействат с уеб услугата. В присъствието на описанията прокси клас на услуги могат да бъдат създадени с помощта на функцията Wsdl.exe. На свой ред, клиентът уеб услуга може да се позове на методите на класа прокси, че комуникира с уеб услуга, чрез мрежа от обработката на съобщението за SOAP и изпратени или получени от услугата от него. Тъй като класът на прокси комуникира с уеб услугата в интернет, се препоръчва да се провери, че класът на URL адрес на собствеността прокси референцията е доверен дестинация.

По подразбиране, за да взаимодействат с прокси клас уеб услуга използва SOAP протокол по HTTP. Инструментът обаче Wsdl.exe могат да генерират прокси класове, за да си взаимодействат с уеб услугата, използвайки протокола HTTP-GET или HTTP-POST. За да покаже, че класът на прокси трябва да използвате HTTP-GET или HTTP-POST, влиза в програмата за превключване Wsdl.exe / протокол. както е описано в следващата таблица.

Използването Wsdl.exe инструмент за създаване на класа пълномощник, електронното обслужване на XML

За да създадете прокси клас, можете да използвате Web Services Description Language инструмент (Wsdl.exe) от командния ред, като се посочва (най-малко) URL уеб услуга или описание на услуги или по пътя към една съхранена описание на услуги.

По-долу са често използвани Wsdl.exe аргументи. Пълен Wsdl.exe програма синтаксис види. Под Инструменти, Web Services Description Language (Wsdl.exe).

Ако посочите файл, да се представи досие, което съдържа описание на услугата. Пример.

Езикът, на който да се създаде прокси клас. Има стойности CS, VB и JS, което отговаря на C #, Visual Basic .NET и JScript .NET. По подразбиране, C # език за. (Незадължително)

Протоколът се използва за комуникация с методите на уеб услуги. SOAP предоставя стойностите, HTTP-GET и HTTP-POST. По подразбиране, протокол SOAP. (По избор).

Именно пространство на класа на пълномощник. Стойността по подразбиране - глобалното пространство. (Незадължително)

Име на файл, съдържащ класа прокси. По подразбиране името се основава на името на класа, който реализира уеб услугата. (Незадължително)

Потребител използва, за да се свържете с уеб сървър, който изисква удостоверяване. (По избор).

Домейнът се използва за свързване на уеб сървър, който изисква удостоверяване. (По избор).

Информация за генерирания прокси клас

Ако създадете прокси клас използване Wsdl.exe инструмент създава един файл с изходен код на даден език. Този файл съдържа класа пълномощник, който осигурява достъп до синхронни и асинхронни методи за всеки метод уеб услуга. Например, ако на уеб услугата съдържа метод, наречен Add. Класът на прокси съдържа следните методи, за да извикате метода за добавяне на уеб услугата: Добави. BeginAdd и EndAdd. Добави метода на прокси клас се използва за синхронна комуникация с метода за добавяне на уеб услугата, както и методите и BeginAdd EndAdd използва за асинхронна комуникация с метод уеб услуга. За повече информация за асинхронна комуникация с методите на уеб услуги см. Под асинхронна комуникация с XML-Web услуги.

Всеки метод създава прокси клас съдържа съответния код, за да си взаимодействат с метода на уеб услугата. Ако по време на грешката при комуникацията се случва между прокси клас уеб услуга и след това изключение е хвърлен. За повече информация относно обработката на изключения, вижте. При работа и хвърляне Изключения в XML-Web услуги.

Редът на параметрите, определени в метода на уеб услуги и най-подходящия метод на класа на пълномощник, може да се различава. В повечето случаи, редът на същите параметри. Въпреки това, ако уеб услугата очаква SOAP съобщения във формат на документа. опция е налице, когато поръчката не е със същите параметри. Ако уеб услуга метод изходните параметри са зададени на входен параметър в прокси клас изходни параметри са поставени след входните параметри. Например, следния пример кодът за метод уеб услуга MyWebMethod outStr изходен параметър на входната величина е обявен инстр. Въпреки това, в класа на прокси инстр опция е обявен преди да outStr.

В някои случаи, прокси клас създаден от програмата Wsdl.exe, използва методът на най-малко общ знаменател за привеждане на обекта на типа, посочен в описанието на услугата. В резултат на вида създадени в класа на прокси може да се различава от желаното или очаквани от строителя. Например, когато програмата открие в описанието услуга тип ArrayList на Wsdl.exe. в генерирания прокси клас, обект масив. За да се осигури правилни отливки тип обект, отворете файла, който съдържа генерирания прокси класа и променяте никакви неправилни типове обекти за очакваните видове.

Карти, генерирани Wsdl.exe инструмент

Ако Wsdl.exe инструмент, за да подам няколко описания на услуги, могат да бъдат показани на следните две съобщения за грешка.

• Внимание! Повтарящо описание услуга с TargetNamespace =<пространство_имен_схемы> от липсва.

Това показва, че броят на тези описания на услуги са едно и също параметри TargetNamespace. Тъй като се предполага, че параметър TargetNamespace трябва да бъде уникален идентификатор за специфична XML-документ, който в този случай е описание на услугата, програмата Wsdl.exe предполага, че тези две описания на същите услуги. Съответно, инструментът Wsdl.exe създава само едно прокси клас за един от описанията на услугите. Ако се очаква извършването на други дейности, това може да се промени. За описания на представляващ уеб услуги, създадени от ASP.NET, можете да приложите WebService атрибут. Задава уникален Namespace имот за един клас, в който се изпълнява на уеб услугата. След това пространство от имена имот се използва като TargetNamespace в описанието на услугата за уникална идентификация на уеб услугата.