Udostępnij za pośrednictwem

  • Artykuł

Dodawanie nagłówki SOAP do aplikacji klienckich

Ta funkcja zostanie usunięta z przyszłej wersji programu Microsoft SQL Server. Należy unikać stosowania tej funkcji w nowych projektach oraz zaplanować modyfikację aplikacji, w których obecnie jest używana ta funkcja.

SQL Server zapewnia obsługę nagłówków rozszerzeń SOAP podczas korzystania z trybu macierzystego usług XML sieci Web.Nagłówki te mogą być używane do rozszerzania i zwiększenia aplikacji opartych na standardzie SOAP za pomocą opcji SQL i innych nagłówków rozszerzeń SOAP, które są obsługiwane, takich jak sesje SOAP i zabezpieczenia usług sieci Web (WS-Security).Aby uzyskać więcej informacji, zobacz Nagłówki SOAP rozszerzenie.

W tym temacie Funkcje biblioteki klas próbki, która implementuje każdego opcjonalne nagłówki rozszerzenia SOAP, które są obsługiwane przez SQL Server.Ta biblioteka można dodawać do istniejących Visual Studio 2005 projektów klient protokołu SOAP.Obejmuje to przykładowe aplikacje w Przykładowe aplikacje do wysyłania żądań usług sieci Web XML macierzystego.

Ponadto firma Microsoft zaleca następujące tematy, jeśli pracujesz z nagłówkami, które implementują albo zabezpieczeń lub obsługi sesji za pomocą odpowiednich nagłówków rozszerzeń SOAP dla każdego z tych funkcji.

Ostrzeżenie

W poniższej procedurze przyjęto, że utworzono istniejącej aplikacji klient protokołu SOAP za pomocą Visual Studio 2005 i dodano Web odwołanie do punktu końcowego HTTP SOAP, który został utworzony za pomocą SQL Server, jak pokazano w Wysyłanie żądań protokołu SOAP za pomocą programu Visual Studio 2005 klient (C#).

Aby dodać biblioteki przykładowy nagłówek rozszerzenia SOAP do projektu programu Visual Studio

  1. Za pomocą programu Notatnik, skopiuj i wklej zawartość C# kod aukcji biblioteki klasy przykładowy nagłówek SOAP SQL i zapisz go pod nazwą "SqlSoapHeader.cs" w tym samym folderze, który zawiera pliki programu project klient protokołu SOAP.

  2. Na klient komputer, z Microsoft Visual Studio 2005 grupy programów, uruchomienie programu Microsoft Visual Studio 2005.

  3. Kliknij Otwórz projekt.

  4. Przeglądaj i zaznacz plik projektu (.csproj) klient protokołu SOAP.

  5. W oknie Solution Explorer wykonaj następujące kroki:

    1. Wybierz nazwę projektu, kliknij prawym przyciskiem myszy i wskaż Dodaj, a następnie wybierz Dodać istniejący element.

    2. W Dodać istniejący element okno dialogowe, Przeglądaj i wybierz SqlSoapHeader.cs plik z lokalizacji został zapisany w kroku 1.

    3. Zaznacz opcję Pokaż wszystkie pliki i rozwiń węzeł odwołania sieci Web i wybierz plik Reference.cs.

  6. W oknie edytora kodu zaktualizować plik Reference.cs, aby dodać zmiennej publicznej do punktu końcowego definicji klasy.Zmienna musi być tego samego SqlSoapHeader klasy jako typ protokołu SOAP opcjonalny nagłówka.

    Na przykład aby dodać zmiennej publicznej właściwość o nazwie "sqlSecurity" z SqlSoapHeader.Security klasy do pliku Reference.cs w definicji klasy punktu końcowego ("sql_endpoint"), należy dodać następujący wiersz kodu:

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

  7. Dodać odpowiednią SoapHeaderAttribute właściwość, aby metoda sieci Web, którą chcesz włączyć for. nagłówek protokołu SOAP

    Na przykład zostały Implementująca klasa zabezpieczeń, należy dodać następujący wiersz kodu:

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

    Ostrzeżenie

    W tym przykładzie wartość argumentu sqlSecurity używany z SoapHeaderAttribute musi odpowiadać nazwę zmiennej, która została użyta w poprzednim kroku.