Udostępnij za pośrednictwem

  • Artykuł

Dodawanie nagłówków protokołu SOAP do aplikacji klient

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 zapewnia obsługę nagłówków rozszerzeń SOAP, przy użyciu programu macierzystego usług XML sieci Web.Nagłówki te mogą być używane do rozszerzania i zwiększenia aplikacji SOAP za pomocą opcji programu SQL i innych nagłówków rozszerzeń SOAP, które są obsługiwane, takich jak sesje protokołu SOAP i zabezpieczenia usług sieci Web (WS-Security).Aby uzyskać więcej informacji zobaczNagłówki rozszerzeń SOAP.

Ten temat zawiera przykładowy Biblioteka klas, które implementuje każdego opcjonalne nagłówków rozszerzeń SOAP, które są obsługiwane przez SQL Server. Ta biblioteka można dodawać do istniejących Visual Studio 2005 Projekty klient protokołu SOAP. Dotyczy to także przykładowych aplikacji w Przykładowe aplikacje wysyłania żądań usług sieci Web XML macierzysty.

Ponadto firma Microsoft zaleca następujące tematy, jeśli użytkownik pracuje z nagłówków, które implementują albo zabezpieczeń lub sesji pomocy technicznej przy użyciu odpowiednich nagłówków rozszerzeń SOAP dla każdego z tych funkcji.

Uwaga

W poniższej procedurze zakłada się, że istniejącą aplikację klient protokołu SOAP został utworzony za pomocą Visual Studio 2005 i dodano odwołanie do punktu końcowego SOAP protokołu HTTP, który został utworzony za pomocą sieci Web SQL Server, jak pokazano na Wysyłanie żądania protokołu SOAP za pomocą programu Visual Studio 2005 klient (C#).

Aby dodać biblioteki przykładowy nagłówek rozszerzenia SOAP w projekcie programu Visual Studio

  1. Za pomocą programu Notatnik, skopiuj i Wklej zawartość Wyświetlanie listy dla Biblioteka klas przykładowy nagłówek protokołu SOAP SQL kod C# i zapisać go pod nazwą "SqlSoapHeader.cs" w tym samym folderze, w którym znajduje się klient protokołu SOAP plików projektów.

  2. Na komputerze klienckim z Program Microsoft Visual Studio 2005 program grupy, uruchom program Microsoft Visual Studio 2005.

  3. Kliknij przycisk Otwórz projekt.

  4. Odszukaj i zaznacz plik projektu (.csproj) klient protokołu SOAP.

  5. W oknie eksplorator rozwiązań wykonaj następujące kroki:

    1. Zaznacz projekt, według nazwy, kliknij prawym przyciskiem myszy i wskaż Dodawanie, a następnie wybierz opcję Dodaj istniejący element.

    2. W Dodaj istniejący element -okno dialogowe, odszukaj i zaznacz plik SqlSoapHeader.cs z lokalizacji będzie zapisany w kroku 1.

    3. Wybierz 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ć publiczną zmiennej do punktu końcowego definicji klasy.Zmienna musi być taka sama SqlSoapHeader Klasa typu opcjonalne nagłówek protokołu SOAP.

    Na przykład, aby dodać zmienną właściwość publicznej o nazwie "sqlSecurity" z SqlSoapHeader.SecurityKlasa w pliku Reference.cs zgodnie z definicją 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. Dodaj odpowiednie SoapHeaderAttribute Właściwość, aby metoda sieci Web, które chcesz włączyć nagłówek protokołu SOAP.

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

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

    Uwaga

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