Udostępnij przez

Tworzenie serwera proxy usługa sieci Web

Klient i usługa sieci Web mogą komunikować się przy użyciu protokołu SOAP wiadomości.Parametry wejściowe i wyjściowe je umieszczać w formacie XML.Klasy proxy mapuje parametry na elementy XML, a następnie wysyła wiadomości protokołu SOAP w sieci.W ten sposób klasy proxy użytkownik zwalnia z konieczności komunikować się z usługa sieci Web poziom protokołu SOAP i pozwala wywołać metody usługa sieci Web w dowolnym środowiska programowania, obsługujący serwery proxy usługa sieci Web i protokołu SOAP.

Istnieją dwa sposoby dodawania klasy proxy do rozwoju projektu za pomocą .NET Framework: za pomocą narzędzie WSDL w .NET Frameworkoraz przez dodawanie odwołania sieci Web w Visual Studio. Ten temat w dalszej części można znaleźć w następujących częściach.

Dodawanie serwera proxy za pomocą narzędzie WSDL

The .NET Framework SDK includes the Web Services Description Language narzędzie (Wsdl.exe), which enables you to generate a Web usługa proxy for use in the .NET Framework development environment. Najczęstszym sposobem tworzenia proxy klient w językach, które obsługują usługi sieci Web (aktualnie C# i Visual Basic) jest użycie narzędzie WSDL.

Aby dodać do projektu przy użyciu wsdl.exe klasy serwera proxy

  1. W wiersz polecenia należy użyć wsdl.exe do utworzenia klasy proxy, określanie (co najmniej) adres URL, który usługa sieci Web Serwer raportów.

    Na przykład, następująca instrukcja w wiersz polecenia określa adres URL dla punktu końcowego zarządzania usługa sieci Web Serwer raportów:

    wsdl /language:CS /n:"Microsoft.SqlServer.ReportingServices2005" http://<Server Name>/reportserver/reportservice2005.asmx?wsdl

    Narzędzie WSDL nie akceptuje liczby argumentów wiersza polecenia do generowania serwer proxy.W poprzednim przykładzie określa język C#, sugerowane obszaru nazw w serwera proxy (w celu uniknięcia kolizji nazw, jeśli korzysta z więcej niż jeden punkt końcowy usługa sieci Web) i generuje plik języka C# o nazwie ReportingService2005.cs.Jeśli zostały określone w przykładzie Visual Basic, w przykładzie będzie wygenerowany plik serwera proxy o nazwie ReportingService2005.vb. Ten plik jest tworzony w katalogu, z którego zostanie uruchomione polecenie.

  2. Kompilowanie klasy serwera proxy w postaci pliku wirtualny plik dziennika (z rozszerzeniem .dll) i odwoływać w projekcie lub dodać klasę jako element projektu.

    Uwaga

    Podczas dodawania klasy proxy do projektu ręcznie, należy dodać odwołanie do System.Web.Services.dll.Po dodaniu serwera proxy za pomocą odwołań w sieci Web w programie Visual Studio .NET, odwołanie jest automatycznie tworzony.Aby uzyskać więcej informacji zobacz "Dodawanie serwera proxy za pomocą a Web odwołanie w Visual Studio" w dalszej części tego tematu.

    Po dodaniu klasy proxy jako element do projektu, skojarzony plik pojawia się w programie eksplorator rozwiązań.

  3. Do wywołania usługa programowo, należy utworzyć wystąpienie klasy serwera proxy.

    Poniższy przykład kodu pokazuje składnię utworzenie wystąpienie ReportingService2005 klasy serwera proxy w projekcie:

Dim service As New ReportingService2005()

ReportingService2005 service = new ReportingService2005();

Aby uzyskać więcej informacji na temat narzędzie wsdl.exe, łącznie z jego pełnej składni, zobacz "" narzędzie języka opis usług sieci Web"w .NET Framework Dokumentację zestawu SDK. Pełne wyjaśnienie serwery proxy usługa sieci Web, zobacz sekcję "Creating an XML sieci Web usługa proxy" w .NET Framework Dokumentację zestawu SDK.

Dodawanie serwera proxy za pomocą odwołanie sieci Web w programie Visual Studio

A Web reference enables a project to consume one or more Web services.Visual Studio enables users to add Web service references to projects by following a few simple steps.

Aby dodać odwołanie sieci Web do projektu

  1. W eksplorator rozwiązań, zaznacz projekt, który zajmie usługa sieci Web.

  2. Na Projekt menu kliknijDodaj odwołanie sieci Web.

    The Add Web Reference dialog box opens.

  3. W ADRES URL pole, wprowadź pełną ścieżka do usługi sieci Web programu Report Server.

    A uproszczone adres URL dla punktu końcowego wykonanie raportu z usługa sieci Web Serwer raportów może wyglądać w następujący sposób:

    http://<Server Name>/reportserver/reportexecution2005.asmx

    Adres URL zawiera domena, w którym usługa sieci Web Serwer raportów wdrożeniu, nazwę folderu zawierającego usługi i nazwę pliku odnajdywania usługi.Pełny opis różnych elementów adresu URL zobacz Uzyskiwanie dostępu do interfejsu API SOAP.

    Opis metod i właściwości udostępniane przez usługa sieci Web jest wyświetlany w okienku Przeglądarka po lewej stronie.

    Uwaga

    Aby uzyskać więcej informacji o zapasach związanych z usługa sieci Web Serwer raportów, zobacz Metody usługa sieci Web Server raportu.

  4. Sprawdź, czy projektu można użyć usługa sieci Web Serwer raportów, i czy masz odpowiednie uprawnienia dostępu do serwera raportów.

  5. W Nazwa odwołania sieci Web wprowadź nazwę, która będzie używana w kodzie programowo dostęp do usługa sieci Web programu serwer raportów.

  6. Wybierz Dodaj odwołanie przycisk, aby utworzyć odwołanie do aplikacji z usługa sieci Web.

    Nowe odwołanie znajduje się w eksplorator rozwiązań dla aktywnego projektu, o nazwie, jak określono w w węźle odwołań w sieci WebNazwa odwołania sieci Web pole.

  7. W eksplorator rozwiązań, rozwiń folder sieci Web materiały referencyjne zwrócić uwagę, w obszarze nazw klas odwołanie sieci Web, które są dostępne dla elementów w projekcie.

    Po dodaniu odwołanie sieci Web do projektu, skojarzone pliki są wyświetlane w folderze znajdującym się w folderze odwołań w sieci Web eksplorator rozwiązań.

Po dodaniu odwołania sieci Web, aby utworzyć wystąpienie klasy serwera proxy należy użyć następującej składni:

Dim rs As New myNamespace.myReferenceName.ReportExecutionService()
rs.Url = "http://<Server Name>/reportserver/reportexecution2005.asmx?wsdl"
rs.Credentials = System.Net.CredentialCache.DefaultCredentials

myNamespace.myReferenceName.ReportExecutionService rs = new myNamespace.myReferenceName.ReportExecutionService();
rs.Url = "http://<Server Name>/reportserver/reportexecution2005.asmx?wsdl"
rs.Credentials = System.Net.CredentialCache.DefaultCredentials

Można również dodawać za pomocą (Import in Visual Basic) w dyrektywie odwołania usługa sieci Web Serwer raportów. Jeśli używasz tej dyrektywie, nie ma potrzeby pełnej kwalifikacji typów w obszarze nazw.Aby to zrobić, Dodaj następujący kod do pliku:

Import myNamespace.myReferenceName

using myNamespace.myReferenceName;
  • Last updated on