Aracılığıyla paylaş


Web Hizmeti Proxy oluşturma

Bir istemci ile bir Web hizmet giriş ve çıkış parametreleri xml kapsüllemek için soap iletilerini kullanarak iletişim kurabilir.Bir proxy sınıf parametreleri xml öğeleriyle eşleşir ve soap iletilerini bir ağ üzerinden gönderir.Bu yolla, proxy sınıfını, soap Web hizmet ile iletişim kurmak zorunluluğunu düzey ve soap ve Web hizmet proxy sunucuları destekleyen herhangi bir geliştirme ortamında Web hizmet yöntemlerini çağırmak izin verir.

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.Aşağıdaki bölümlerde bu konu ayrıntılı olarak ele almaktadır.

Proxy wsdl aracı kullanılarak ekleme

The .NET Framework SDK includes the Web Services Description Language tool (Wsdl.exe), which enables you to generate a Web service proxy for use in the .NET Framework development environment.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.

Wsdl.exe kullanarak projenizi proxy sınıf eklemek için

  1. komut istemi isteminden Wsdl.exe (en azından) URL'sini belirten bir proxy sınıf oluşturmak için kullanın. Rapor Sunucusu Web hizmet.

    Örneğin, aşağıdaki komut istemi deyim rapor sunucusu Web hizmet Yönetimi bitiş noktası URL'sini belirtir:

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

    wsdl araç bir proxy oluşturmak için komut istemi bağımsız değişken sayısı kabul eder.Önceki örnekte, C# (birden fazla Web hizmet bitiş noktası kullanıyorsanız ad çakışmasıyla önlemek için) proxy kullanmak için önerilen bir ad alanı dilini belirtir ve ReportingService2010.cs adlı bir C# dosya oluşturur.Belirtilen örnek, Visual Basic, örnek üretilen bir proxy dosya adı ReportingService2010.vb.Bu dosya komutunu çalıştırırsanız dizinde oluşturulur.

  2. Bir derleme dosyaya (uzantısı .dll) proxy sınıfını derlemek ve projenizde başvuru ya da bir proje olarak add class öğe.

    Not

    Bir proxy sınıf projenize el ile eklediğiniz zaman, System.Web.Services.dll bir başvuru eklemeniz gerekir.Visual Studio'da Web Başvurusu kullanarak proxy eklerseniz.net, başvuru otomatik olarak oluşturulur.Daha fazla bilgi için bkz: "Ekleyerek Proxy kullanarak bir Web Başvurusu içinde Visual Studio" Bu konuda daha sonra.

    Projeniz için bir öğe proxy sınıfı ekledikten sonra ilişkili dosya Solution Explorer'da görünür.

  3. Hizmet program aracılığıyla çağırmak için oluşturma bir örnek proxy sınıfının.

    Aşağıdaki kod örnek örneğini oluşturmak için sözdizimi gösterilmiştir ReportingService2010 proxy sınıfında bir proje:

Dim service As New ReportingService2010()
ReportingService2010 service = new ReportingService2010();

Onun tam sözdizimi dahil Wsdl.exe araç hakkında daha fazla bilgi için "Web Hizmetleri Açıklama Dili araç" konusuna bakın. de .NET Framework sdk belgeleri.Web hizmet proxy'leri hakkında tam açıklama için bkz: "Oluşturma bir xml Web hizmet proxy'si" de .NET Framework sdk belgeleri.

Visual Studio'da Web Başvurusu kullanarak Proxy ekleme

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.

Bir projeye bir Web baþvurusu eklemek için

  1. De Solution Explorer, Web tüketen projeyi seçin hizmet.

  2. Üzerinde Proje menüsünde'i tıklatın Add Web Reference.

    The Add Web Reference dialog box opens.

  3. De url alanına, tam yol için rapor sunucusu Web hizmet.

    A url rapor yürütme nokta için Basitleştirilmiş Rapor Sunucusu Web hizmet şuna benzeyebilir:

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

    Etki alanında hangi URL'yi içeren Rapor Sunucusu Web hizmet dağıtılır, hizmet içeren klasörün adını ve hizmet bulma dosyasının adı.Farklı url öğelerinin eksiksiz bir açıklaması için bkz: soap API erişme.

    Soldaki tarayıcı bölmesinde yöntemlerini ve özelliklerini Web hizmet tarafından sağlanan bir açıklaması görünür.

    Not

    Rapor sunucusu Web hizmet ile ilişkili öğeler hakkında daha fazla bilgi için bkz: Rapor sunucusu Web hizmeti yöntemleri.

  4. Projenizi kullanabileceğini doğrulamak Rapor Sunucusu Web hizmet, ve rapor sunucusu erişmek için uygun izinlere sahip.

  5. De Web başvuru adı kodunuza erişmek için kullanacağı bir ad alanına, Rapor Sunucusu Web hizmet program aracılığıyla.

  6. Seçin Add Reference uygulamanızda Web hizmet için başvuru oluşturmak için düğme.

    Yeni başvuru görünür Solution Explorer adlı etkin projenin Web başvurular düğümü altında belirtildiği gibi Web başvuru adı alan.

  7. De Solution Explorer, projenizin içindeki öğeler için kullanılabilir olan Web Başvurusu sınıfları için ad alanını dikkat etmek Web References klasörünü genişletin.

    Bir Web baþvurusu projenize ekledikten sonra ilişkili dosyaları Web References klasörü içindeki bir klasöre görüntülenir Solution Explorer.

Web başvurusunu ekledikten sonra oluşturmak için aşağıdaki sözdizimini kullanın bir örnek proxy sınıfının:

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

De ekleyebilirsiniz bir kullanarak (Al , Visual Basic) yönergesi için rapor sunucusu Web hizmet başvuru.Bu yönerge kullanırsanız, tam olarak ad türleri nitelemek gerekmez.Bunu yapmak için aşağıdaki kodu dosyanıza ekleyin:

Import myNamespace.myReferenceName
using myNamespace.myReferenceName;