Tworzenie serwera Proxy usługi sieci Web
klient i usługa sieci Web mogą komunikować się przy użyciu protokołu SOAP wiadomości, które hermetyzują parametry wejściowe i wyjściowe 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 uwalnia użytkownika od konieczności komunikowania się z usługa sieci Web poziom SOAP i pozwala wywoływać metody usługa sieci Web w dowolnym środowisku projektowania, obsługujący serwery proxy usługa sieci Web i SOAP.
There are two ways to add a proxy class to your development project using the Microsoft .NET Framework: with the WSDL tool in the .NET Framework, and by adding a Web reference in Microsoft Visual Studio.Ten temat szczegółowo w następujących częściach.
Dodawanie serwera Proxy za pomocą narzędzia WSDL
.NET Framework Zestaw SDK zawiera narzędzie Web Services Description Language (Wsdl.exe), który umożliwia generowanie serwera proxy usługa sieci Web do użytku w .NET Framework rozwoju środowiska.The most common way to create a client proxy in languages that support Web services (currently C# and Microsoft Visual Basic) is to use the WSDL tool.
Aby dodać klasę proxy do projektu przy użyciu Wsdl.exe
W wiersz polecenia należy użyć Wsdl.exe utworzyć klasę proxy, określanie (co najmniej) adres URL do usługa sieci Web serwera raportów.
Na przykład, następująca instrukcja wiersz polecenia określa adres URL punktu końcowego zarządzanie usługa sieci Web serwera raportów:
wsdl /language:CS /n:"Microsoft.SqlServer.ReportingServices2010" http://<Server Name>/reportserver/reportservice2010.asmx?wsdlNarzędzie WSDL nie akceptuje liczby argumentów wiersza polecenia do generowania serwer proxy.Powyższy przykład określa język C# sugerowanych nazw w proxy (w celu uniknięcia kolizji nazw, jeśli za pomocą więcej niż jednego punktu końcowego usługa sieci Web) i generuje plik C# o nazwie ReportingService2010.cs.Jeśli podał przykładzie Visual Basic, na przykład czy wygenerowany plik serwera proxy o nazwie ReportingService2010.vb.Ten plik jest tworzony w katalogu, z którego uruchamiane jest polecenie.
Skompilować klasy proxy do pliku wirtualny plik dziennika (z rozszerzeniem .dll) i odwołać się w projekcie lub dodać klasę jako element projektu.
Ostrzeżenie
Ręcznie dodać klasę proxy do projektu, należy dodać odwołanie do System.Web.Services.dll.Po dodaniu serwera proxy przy użyciu odwołania sieci Web programu Visual Studio.NET, odwołanie jest automatycznie tworzony.Aby uzyskać więcej informacji zobacz "Dodawanie serwera Proxy za pomocą sieci Web odniesienia w Visual Studio" w dalszej części tego tematu.
Po dodaniu klasy proxy jako element projektu, skojarzony plik pojawia się w oknie Solution Explorer.
Wywołanie usługa programowo, należy utworzyć wystąpienie klasy proxy.
Poniższy przykład kodu pokazuje składnię utworzenie wystąpienie ReportingService2010 klasy proxy w projekcie:
Dim service As New ReportingService2010()
ReportingService2010 service = new ReportingService2010();
Aby uzyskać więcej informacji dotyczących narzędzia Wsdl.exe, łącznie z jego pełnej składni zobacz "Narzędzie języka opisu usługi sieci Web" w .NET Framework dokumentacji zestawu SDK.Pełne wyjaśnienie serwerów proxy usługa sieci Web Zobacz "Tworzenie XML sieci Web usługa Proxy" w .NET Framework dokumentacji zestawu SDK.
Dodawanie serwera Proxy przy użyciu odwołania sieci Web programu 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 do projektu sieci Web
W Solution Explorer, zaznacz projekt, który będzie korzystał z usługa sieci Web.
Na projektu menu, kliknij Dodawanie odwołania sieci Web.
Dodawanie odwołania sieci Web zostanie otwarte okno dialogowe.
W adres URL wprowadź pełną ścieżka do usługa sieci Web serwera raportów.
A uproszczony adres URL dla raport końcowy wykonanie usługa sieci Web serwera raportów może wyglądać następująco:
http://<Server Name>/reportserver/reportexecution2005.asmxAdres URL zawiera domena, w której usługa sieci Web serwera raportów jest rozmieszczana nazwę folderu zawierającego usługi i nazwa pliku odnajdowania dla usługi.Pełny opis różnych elementów adresu URL, zobacz Dostęp 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.
Ostrzeżenie
Aby uzyskać więcej informacji o zapasach związanych z usługa sieci Web serwera raportów, zobacz Metody usługi sieci Web serwera raportów.
Zweryfikuj, że projektu można użyć usługa sieci Web serwer raportów, i że masz odpowiednie uprawnienia dostępu do serwer raportów.
W Web nazwę odwołania wprowadź nazwę, która będzie używać kodu dostępu do usługa sieci Web serwera raportów programowo.
Wybierz Dodaj odwołanie przycisk, aby utworzyć odwołanie do aplikacji z usługa sieci Web.
Nowe odwołanie pojawia się w Solution Explorer na węźle odwołania sieci Web dla aktywnego projektu o nazwie określone w Web nazwę odwołania pole.
W Solution Explorer, rozwiń folder sieci Web odwołania pamiętać obszar nazw dla klas odwołania sieci Web dostępne dla elementów w projekcie.
Po dodaniu odwołania sieci Web do projektu, skojarzone pliki są wyświetlane w folderze w folderze sieci Web odwołania Solution Explorer.
Po dodaniu odwołania sieci Web, aby utworzyć wystąpienie klasy 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ż dodać za pomocą (importu w Visual Basic) w dyrektywie do usługa sieci Web serwera raportów odwołanie.Użyj tej dyrektywy, nie trzeba pełnej kwalifikacji typów w obszarze nazw.Aby to zrobić, Dodaj następujący kod do pliku:
Import myNamespace.myReferenceName
using myNamespace.myReferenceName;
Zobacz także