共用方式為


HOW TO:控制 ASP.NET Web 服務的 WSDL 檔案產生

更新:2007 年 11 月

在 Visual Studio Team System Architecture 版中使用 [應用程式設計工具] 時,您可以針對 ASP.NET 應用程式中所有 Web 服務停用或啟用 WSDL 檔案。根據預設,Visual Studio 會啟用 WSDL 檔案產生。如需詳細資訊,請參閱 ASP.NET Web 服務的 WSDL 檔案產生

注意事項:

WSDL 檔案產生的停用或啟用,會套用至 ASP.NET 應用程式上所有的 Web 服務。停用 WSDL 檔案產生,但不指定另一個 WSDL 檔案位置,會導致無法產生 Web 參考,並造成在指定的位置找不到 WSDL 檔案的錯誤。停用 WSDL 檔案產生,還會停用從瀏覽器存取 Web 服務 URL 時所產生的預設 ASP.NET 測試頁。如需詳細資訊,請參閱 HOW TO:覆寫 WSDL 檔案中的 WSDL 繫結定義

您可以使用 [設定和條件約束編輯器],在進行實作 (Implementation) 之前先完成這項工作。一旦實作 ASP.NET 應用程式後,視您需要的範圍而定,也可以在位於應用程式專案中的 Web.config 檔內,或是在要部署應用程式之 Web 伺服器的 Machine.config 檔中移除或加入適當的設定。

若要停用 ASP.NET 應用程式的 WSDL 檔案產生

  1. 在應用程式圖表上,按一下您需要的 ASP.NET 應用程式。

  2. 在 [圖表] 功能表上,選擇 [設定和條件約束]。

  3. 在 [設定和條件約束編輯器] 中的 [設定] 下,展開 [目錄] 節點,然後展開 [組態] 節點。

  4. 以滑鼠右鍵按一下 [組態] 節點,指向 [加入資源] 並選擇 [SystemWebSectionGroup]。

  5. 以滑鼠右鍵按一下 [SystemWebSectionGroup] 節點,指向 [加入資源] 並選擇 [WebServicesSection]。

  6. 在 [設定和條件約束編輯器] 的右窗格中,展開 [設定] 節點。

  7. 在 [通訊協定] 列上,按一下 [值] 欄,然後按一下省略符號 (...) 按鈕。

    [ComplexSetting 集合編輯器] 隨即出現。

  8. 在 [成員] 清單中,選取 [Documentation],按一下 [移除],然後按一下 [確定]。

    實作應用程式之後,所產生之應用程式 Web.config 組態檔的 <System.Web> 區段中就會省略下列項目:

    <add name="Documentation" />
    

    您也可以將這個項目自 Web 伺服器的 Machine.config 檔移除,為該伺服器上所有的 ASP.NET 應用程式停用 WSDL 檔案產生。

若要啟用 ASP.NET 應用程式的 WSDL 檔案產生

  1. 在圖表上選取您要的 ASP.NET 應用程式。

  2. 在 [圖表] 功能表上,選擇 [設定和條件約束]。

  3. 在 [設定和條件約束編輯器] 中的 [設定] 下,展開 [目錄] 節點,然後展開 [組態] 節點。

  4. 展開 [SystemWebSectionGroup] 節點,並選取 [WebServicesSection] 資源。

  5. 在 [設定和條件約束編輯器] 的右窗格中,展開 [設定] 節點。

  6. 在 [通訊協定] 列上,按一下 [值] 欄,然後按一下省略符號 (...) 按鈕。

    [ComplexSetting 集合編輯器] 隨即出現。

  7. 在 [ComplexSetting 集合編輯器] 中,按一下 [加入]。

    [成員] 清單中會出現新的設定。

  8. 在設定屬性清單中,將設定命名為 "Documentation",並按一下 [確定]。

    實作應用程式之後,所產生之應用程式 Web.config 組態檔的 <System.Web> 區段中就會加入下列項目:

    <add name="Documentation" />
    

    您也可以將這個項目加入至 Web 伺服器的 Machine.config 檔,為該伺服器上所有的 ASP.NET 應用程式啟用 WSDL 檔案產生。

請參閱

其他資源

設定 ASP.NET Web 服務的 WSDL 檔案產生