Share via

  • Makale

Istemci uygulamaları için SOAP üstbilgileri ekleme

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

SQL Server Yerel XML Web hizmetleri kullanırken SOAP uzantısı üstbilgileri için destek sağlar.Bu üstbilgileri genişletmek ve SOAP tabanlı uygulamalarınızı SQL seçenekleri ve SOAP oturumlarını ve Web Hizmetleri Güvenlik (WS-Security) gibi desteklediği diğer SOAP uzantısı üstbilgilerini kullanarak geliştirmek için kullanılabilir.Daha fazla bilgi için bkz:SOAP uzantısı üstbilgileri.

Bu konu, her isteğe bağlı SOAP uzantısı üstbilgileri tarafından desteklenen uygulayan örnek sınıf kitaplığı özellikleriSQL Server.Bu kitaplıkta varolan olarak eklenebilirVisual Studio 2005SOAP istemci projeleri.Örnek uygulamalar sağlanan de buna dahildirYerel XML Web Hizmetleri istekleri gönderme için örnek uygulamalar.

Ayrıca, öneririz aşağıdaki konular, başlıkları ya da güvenlik çözümü ile çalıştığınız veya oturum desteği kullanarak uygun SOAP uzantısı başlıklarını her biri bu özellikleri.

Not

Aşağıdaki yordam varsayar, oluşturduğunuz varolan bir SOAP istemci uygulaması kullanarakVisual Studio 2005ve bir Web başvurusu kullanarak oluşturulmuş HTTP SOAP son noktaSQL Server' de gösterildiği gibiVisual Studio 2005 istemcisi (C#) kullanarak SOAP isteği gönderme.

SOAP uzantısı başlığı örnek kitaplığı, Visual Studio projeye eklemek için

  1. Kullanarak bir not defteri, kopyalayıp içeriğiniC# kod listesi için SQL SOAP üstbilgisi örnek sınıf kitaplığı ve "SqlSoapHeader.cs" adıyla SOAP istemci içeren aynı klasöre kaydetmek proje dosyalarını.

  2. İstemci bilgisayarda, gelenMicrosoft Office 2010 Suite Visual Studio 2005program grubuna, Microsoft Office 2010 Suite Visual Studio 2005'i başlatın.

  3. ' I tıklatınAçık proje.

  4. Gidin ve SOAP istemci (.csproj) proje dosyası seçin.

  5. çözüm gezgini penceresinde aşağıdaki adımları izleyin:

    1. Proje adı seçin, sağ tıklatın ve işaretçiyiEklemeve seçin Add Existing öğe .

    2. ,Varolan öğeyi ekleme iletişim kutusuna gidin ve SqlSoapHeader.cs dosyasını kaydettiğiniz için 1. adımda konumu seçin.

    3. Seçin tüm dosyaları göster ve Web References düğümünü genişletin ve seçin Reference.cs dosyayı karşıdan yükle.

  6. Kod Düzenleyicisi penceresinde bitiş noktası tanımı sınıf için genel bir değişken eklemek için Reference.cs dosyasını güncelleştirin.Değişken aynı olmalıdırSqlSoapHeadersınıf türü SOAP isteğe bağlı üstbilgi.

    Örneğin, bir ortak özellik değişken adlı eklemek için "sqlSecurity"SqlSoapHeader.Securitysınıfı Reference.cs dosyası uç sınıf tanımı ("sql_endpoint") altında aşağıdaki kod satırını ekleyin:

    public class sql_endpoint : System.Web.Services.Protocols.SoapHttpClientProtocol {
     public SqlSoapHeader.Security  sqlSecurity

  7. Uygun EkleSoapHeaderAttributeSOAP üstbilgisi for. etkinleştirmek istediğiniz Web yönteminin özellik

    Security sınıfı uygulama, örneğin, aşağıdaki kod satırını ekleyin:

    [System.Web.Services.Protocols.SoapHeaderAttribute("sqlSecurity")]
public int UDFReturningAScalar() {...}

    Not

    Bu örnekte, bağımsız değişken değerisqlSecurity ile kullanılırSoapHeaderAttributeönceki adımda. kullanıldı değişken adına karşılık gerekir