將 SOAP 標頭加入用戶端應用程式
SQL Server 2005 提供在使用原生 XML Web Service 時對於 SOAP 擴充標頭的支援。透過使用 SQL 選項和其他支援的 SOAP 擴充標頭，例如 SOAP 工作階段以及「Web 服務安全性」(WS-Security)，這些標頭就可用以擴充和增強以 SOAP 為基礎的應用程式。如需詳細資訊，請參閱＜SOAP 延伸模組標頭＞。
此主題提供範例類別庫，以實作 SQL Server 2005 所支援的每個選擇性的 SOAP 擴充標題。可以將此類別庫加入現有的 Visual Studio 2005 SOAP 用戶端專案。包括 傳送原生 XML Web Service 要求的範例應用程式 中提供的範例應用程式。
- 我們建議您能夠熟悉＜設定伺服器接聽原生 XML Web Service 要求＞與＜撰寫用戶端應用程式＞中提供的概念和程序資訊。
除此之外，如果您正在針對以下每一個功能使用適當的 SOAP 擴充標題，來實作安全性或工作階段，我們建議您閱讀下列主題。
.gif "ms189619.note(zh-tw,SQL.90).gif") 附註： |
|---|
| 下列程序是假設您已使用 Visual Studio 2005 來建立現有的 SOAP 用戶端應用程式，而且已經將 Web 參考加入使用 SQL Server 2005 所建立的 HTTP SOAP 結束點，如＜使用 Visual Studio 2005 用戶端 (C#) 傳送 SOAP 要求＞所示。 |
若要將 SOAP 擴充標題範例庫加入 Visual Studio 專案
使用「記事本」複製和貼上＜SQL SOAP 標頭範例類別庫的 C# 程式碼清單＞的內容，並以 "SqlSoapHeader.cs" 的名稱將它儲存在含有 SOAP 用戶端專案檔的相同資料夾中。
在用戶端電腦上，從 [Microsoft Visual Studio 2005] 程式群組，啟動 Microsoft Visual Studio 2005。
按一下 [開啟專案]。
瀏覽和選取 SOAP 用戶端專案 (.csproj) 檔案。
在 [方案總管] 視窗中，請依照下列步驟進行：
- 依名稱選取專案，以滑鼠右鍵按一下專案後指向 [加入]，然後選取 [加入現有項目]。
- 在 [加入現有項目] 對話方塊中，從您在步驟 1 儲存 SqlSoapHeader.cs 檔案的位置選取該檔案。
- 選取 [顯示所有檔案]，然後展開 [Web 參考] 節點並選取 Reference.cs 檔案。
在 [程式碼編輯器] 視窗中，在 Reference.cs 檔案中將公用變數加入至結束點定義類別。變數必須與 SOAP 選擇性標頭的類型一樣都是 SqlSoapHeader 類別。
例如，若要將 SqlSoapHeader.Security 類別的 "sqlSecurity" 公用屬性變數加入至結束點類別定義 ("sql_endpoint") 下的 Reference.cs 檔案，您將加入下列程式碼行：
public class sql_endpoint : System.Web.Services.Protocols.SoapHttpClientProtocol { public SqlSoapHeader.Security sqlSecurity將適當的 SoapHeaderAttribute 屬性加入您要啟用 SOAP 標頭的 Web 方法中。
例如，如果您要實作 Security 類別，您將加入下列程式碼行。
[System.Web.Services.Protocols.SoapHeaderAttribute("sqlSecurity")] public int UDFReturningAScalar() {...}附註：在此範例中，與 SoapHeaderAttribute搭配使用的sqlSecurity引數值必須與前面步驟所使用的變數名稱一致。