共用方式為

HOW TO：定義 ASP.NET Web 服務的作業

  • 發行項

更新：2007 年 11 月

在 [應用程式設計工具] 和 [系統設計工具] 中，您可以定義 .NET Web 服務提供者端點的作業，並且使用 [Web 服務細節] 視窗執行這項工作。如需詳細資訊，請參閱應用程式圖表上的 ASP.NET 應用程式概觀。

秘訣

您可以指定 WSDL 或 .disco 檔案，以預先定義的作業簽章和類型建立 .NET Web 服務提供者端點。然後，您就可以在 [Web 服務細節] 視窗中編輯這些作業。如需詳細資訊，請參閱 HOW TO：在應用程式中加入端點。

定義 .NET Web 服務提供者端點的作業時，您可以定義該端點的所有使用行為。定義這些作業之後，您可以隨時使用 [Web 服務細節] 視窗進行編輯。在使用 .NET Web 服務提供者端點實作 ASP.NET 應用程式之後，您可以透過 [Web 服務細節] 視窗或程式碼 (這兩者會保持同步) 編輯端點的作業。如需詳細資訊，請參閱 HOW TO：編輯 ASP.NET Web 服務的作業。

注意事項：

ASP.NET 應用程式專案中會包含應用程式上每個 Web 服務提供者端點的 Web 服務類別檔案。每個 Web 服務類別檔案都包含對應 Web 服務提供者端點的作業簽章。每個作業簽章 (以及任何註解) 都會在 Web 服務類別檔案中顯示為具有 WebMethod 屬性的方法。您可以加入適當的方法主體程式碼，完成每項作業的實作。

若要定義 Web 服務作業

  1. 在圖表上，選取 Web 服務提供者端點。

  2. 在 [圖表] 功能表上，選擇 [定義作業]。

    秘訣

    您也可以滑鼠右鍵按一下端點並選擇 [定義作業]。

    [Web 服務細節] 視窗隨即出現。

  3. 在 [Web 服務細節] 視窗中的作業列上，按一下 [名稱] 下的 [<加入作業>] 並命名作業。

  4. 在 [型別] 底下的同一列上，視需要指定作業傳回型別。如果您不需要指定型別，請前往步驟 7。

    注意事項：

    根據預設，除非明確定義，否則作業不會傳回任何資料。不傳回任何資料之作業的表示方式，取決於為 Web 服務所指定的語言。使用 Visual Basic 時，不會指定任何的作業傳回型別。使用 Visual C# 時，作業的預設傳回型別是 void。建立任何與 Web 服務連接的 Web 參考時，會因為無法序列化介面型別 (Interface Type) 而產生錯誤。

  5. 若要選取型別，請開始進行輸入以便檢視型別清單。

    當您輸入的時候，會開啟一份清單並顯示可用的型別。

    秘訣

    如果您要的型別不在型別清單裡，請使用完整的型別名稱、指定其他專案或型別程式庫所定義的型別，或是指定要在實作 (Implementation) 之後定義的新型別。若要完成型別的指定，請繼續輸入您要的型別名稱。

  6. 按下 ENTER 鍵或按一下其他儲存格，離開這個儲存格。

    注意事項：

    按下 TAB 鍵會將您指定的型別替換為型別清單中最相符的型別。

  7. 在 [摘要] 下，加入任何與作業有關的註解。

    秘訣

    若要加入更多資訊，請按一下省略符號 (...) 按鈕，以開啟 [描述] 對話方塊。然後您可以指定 WSDL 描述的其他註解、作業傳回型別 (如果有的話)，以及其他備註。所指定的任何 WSDL 描述資訊都會出現在 WSDL 檔案裡。

在您實作 ASP.NET 應用程式之前，型別清單只會顯示 Microsoft 核心程式庫 (MSCorLib.dll) 和其他一些隱含參考之型別程式庫中所定義的型別。不過，您可以參考其他型別程式庫和專案中定義的型別，或者參考您打算在實作應用程式後，稍後在程式碼中或使用類別設計工具定義的型別。

如果您參考其他專案或型別程式庫中所定義的型別，則必須在實作應用程式後，加入這些專案或程式庫的參考。型別清單將會包含所有明確參考之專案和型別程式庫中所定義的全部型別。如需詳細資訊，請參閱 HOW TO：在 Visual Studio 中新增或移除參考 (C#)。

如果您參考打算稍後才定義的型別，則直到您將類別檔案或類別圖表加入至應用程式專案，以便在實作應用程式後定義型別，這些型別才會出現在型別清單中。如需詳細資訊，請參閱 HOW TO：定義 ASP.NET Web 服務的作業和參數型別。

定義好作業之後，您可以定義作業的參數，或在下一個作業列定義其他作業。

若要定義 Web 服務作業的參數

  1. 在 [Web 服務細節] 視窗中，展開作業節點。

  2. 在作業底下的參數列上，按一下 [名稱] 下方的 [<加入參數>] 並命名參數。

    秘訣

    請選擇作業內唯一的參數名稱。

  3. 視需要在 [型別] 下指定參數型別。

  4. 在 [修飾詞] 下，選取要如何傳遞參數。

  5. 在 [摘要] 下，加入任何與參數有關的註解。

    秘訣

    若要加入更多資訊，請按一下省略符號 (...) 按鈕，以開啟 [描述] 對話方塊。

定義好參數之後，您可以在下一個參數列上定義新的參數。您也可以在 [屬性] 視窗中，透過參數的屬性來定義參數。

請參閱

工作

HOW TO：指定 ASP.NET Web 服務的單向或要求-回應作業

HOW TO：編輯 ASP.NET Web 服務的作業

HOW TO：從 ASP.NET Web 服務刪除作業和參數

參考

Web 服務細節視窗的鍵盤快速鍵

其他資源

定義 ASP.NET Web 服務的作業