使用 ASP.NET 建立之 XML Web Service 的組態選項
本主題專門說明舊有技術。 應該使用下列建立 XML Web Service 及 XML Web Service 用戶端： Windows Communication Foundation.
Web 服務的組態遵循所有 ASP.NET Web 應用程式使用的同一個模型。ASP.NET 組態是一種 XML 文字檔組態架構，這種架構不但功能強大，而且具有擴充性。組態檔只是一組表示 Microsoft .NET Framework 特定技術功能之組態選項的 XML 項目。如果是 Web 服務，組態選項會出現在組態檔的 webServices XML 項目中。如需可供 Web 服務使用之組態選項的完整清單，請參閱 <webServices> 項目。
設定傳訊通訊協定和服務說明網頁
在組態檔 <webServices> 項目 底下的 <protocols> 項目 XML 項目中，可以設定 Web 服務的傳訊通訊協定和服務說明網頁。完成組態的方式是為每個設定新增 <protocols> 的 <add> 項目和 <protocols> 的 <remove> 項目，藉以指定該設定是否適用於組態檔的範圍。add 項目會針對組態檔的範圍明確地新增該設定的支援，而 remove 項目則會移除已在組態階層架構更高層級中加入的支援。例如，您可以透過 Machine.config 檔案中的 add 項目，在電腦層級新增通訊協定設定，然後使用 Web.config 檔案中的 remove 項目，移除 Web 應用程式的通訊協定設定。下列是 add 和 remove 項目的語法：
<{add|remove} name="protocol name" />
add 和 remove 項目的 name 屬性具有下列選項：
| 設定 | 描述 |
|---|---|
HttpSoap |
控制 Web 服務的 SOAP over HTTP 通訊協定支援。安裝在預設下會新增支援。 |
HttpGet |
控制 Web 服務的 HTTP-GET 通訊協定支援。安裝在預設下不會新增支援。 |
HttpPost |
控制 Web 服務的 HTTP-POST 通訊協定支援，不論要求的起源為何。安裝在預設下不會新增支援。 |
HttpPostLocalhost |
在要求是源自本機電腦時，控制 Web 服務的 HTTP-POST 通訊協定支援。如果 HttpPost 已新增至目前組態，則這個設定沒有任何作用。安裝在預設下會新增支援。 |
Documentation |
指定當使用者未在瀏覽器中使用任何參數直接瀏覽至 Web 服務 URL 時，是否顯示服務說明網頁。安裝在預設下會新增支援。本主題稍後會進一步說明如何設定 Documentation 通訊協定。 |
.gif "b2c0ew36.note(zh-tw,VS.100).gif") 注意： |
|---|
| .NET Framework 1.0 版支援 HttpSoap、HttpGet、HttpPost 和 Documentation 設定，而且預設會在電腦層級啟用這些設定。 |
設定 Documentation 通訊協定
未在網頁瀏覽器中使用任何參數而直接瀏覽至 Web 服務 URL 時，如果服務已設定為允許檢視 Web 服務的服務說明網頁，用戶端就可以進行檢視。根據預設，服務說明網頁會包含人們可讀取的 (Human-Readable) 資訊，這有關如何與 Web 服務及其公開的 Web 服務方法進行通訊。
因為服務說明網頁只是 ASP.NET Web Form，所以可加以取代或修改來包含一些項目，例如公司標誌。服務說明網頁的檔案名稱是在組態檔的 <wsdlHelpGenerator> 項目 中，以 Machine.config 檔案內指定的 DefaultWsdlHelpGenerator.aspx 預設設定來指定。
一般只針對已在 <protocols> 項目 中指定 Documentation 通訊協定的組態檔，顯示其範圍內的 Web 服務的服務說明網頁。根據預設，Documentation 通訊協定是在 Machine.config 檔案中指定。請參閱＜HOW TO：停用 Web 服務的服務說明頁面＞。
安全性
在啟用 Web 服務的 HTTP-GET 或 HTTP-POST 通訊協定之前，您必須注意，這麼做可能會讓它公開在不當的引動過程中。例如，毫無戒備的使用者可能收到內含連結的電子郵件，當他按一下這個連結時，這封電子郵件便會使用其中提供的參數，代表使用者叫用 Web 服務。在啟用 HTTP-GET 或 HTTP-POST 通訊協定之前，您應該先考慮這樣的引動過程是否可能有害。
另請參閱
工作
HOW TO：停用 Web 服務的通訊協定支援
HOW TO：停用 Web 服務的服務說明頁面
HOW TO：啟用 XML Web 服務的探索