共用方式為

作法：在 ASP.NET AJAX 端點的 HTTP POST 和 HTTP GET 要求之間進行選擇

  • 發行項

Windows Communication Foundation (WCF) 可讓您建立服務以公開啟用 ASP.NET AJAX 的端點，並可在用戶端網站上透過 JavaScript 來呼叫此端點。 作法：使用設定新增 ASP.NET AJAX 端點和作法：不使用設定新增 ASP.NET AJAX 端點中將討論建置此類服務的基本程序。

ASP.NET AJAX 支援使用 HTTP POST 和 HTTP GET 動詞 (預設為 HTTP POST) 的作業。 若要建立沒有任何副作用並傳回不常或永不變更的資料時，請改用 HTTP GET。 您可以快取 GET 作業的結果，也就是說，對相同作業的多次呼叫可能只需要對服務提出一次要求。 快取並不是由 WCF 完成，而是可能發生在任何層級 (透過使用者的瀏覽器、Proxy 伺服器與其他層級)。如果您想要增加服務效能，使用快取是比較有利的方式，但是假如資料常常變更，或是作業會執行某些動作時，可能就不適合使用快取。

例如，如果您正在設計服務來管理使用者的音樂資料庫，負責依據專輯標題來查詢音樂創作者的作業就可以利用 GET 輕鬆得到想要的資料，但是將專輯新增至使用者個人收藏的作業則必須使用 POST 才行。

若要控制快取的存留期，請使用 OutgoingWebResponseContext 型別。 例如，在設計可傳回每小時更新的氣象預報服務時，可以使用 GET 並將快取範圍限制在一小時以內，以避免服務的使用者存取到過時資料。

當您使用來自 ASP.NET AJAX 頁面 (使用指令碼管理員控制項) 的服務時，不論作業是使用 GET 或 POST，指令碼管理員機制都會確保發出正確的要求類型。

HTTP GET 作業會使用 POST 作業支援的所有輸入參數，包括複雜資料合約型別。 但是，在大部分情況下，建議您不要在 GET 作業中使用太多或太複雜的參數，因為這樣會降低快取效率。

本主題說明如何藉由將 WebGetAttribute 或 WebInvokeAttribute 屬性新增至服務合約內的相關作業中，以便在 GET 和 POST 間進行選取。 讓服務順利執行所需的其他步驟 (實作、設定與裝載服務) 與 WCF 中任何 ASP.NET AJAX 服務所使用的步驟很類似。

加上 WebGetAttribute 標示的作業一律使用 GET 要求。 加上 WebInvokeAttribute 標示，或是未加上任何這兩個屬性的作業，則會使用 POST 要求。 WebInvokeAttribute 允許透過 Method 屬性使用 GET 和 POST 以外的其他 HTTP 動詞 (例如 PUT 和 DELETE 等等)。 但是，ASP.NET AJAX 並不支援這些動詞。 如果您想要透過指令碼管理員控制項使用來自 ASP.NET 頁面的服務，請勿使用 Method 屬性。

如需切換至 GET 的實用範例，請參閱基本 AJAX 服務範例。

如需使用 POST 的範例，請參閱使用 HTTP POST 的 AJAX 服務範例。

若要建立回應 HTTP GET 或 HTTP POST 要求的 WCF 服務

  1. 使用以 ServiceContractAttribute 屬性標記的介面來定義基本的 WCF 服務合約。 以 OperationContractAttribute 標記每項作業。 新增 WebGetAttribute 屬性，以指定回應 HTTP GET 要求的作業。 您也可以新增 WebInvokeAttribute 屬性，明確地指定 HTTP POST，或不指定屬性 (如此將預設為 HTTP POST)。

    [ServiceContract]  
public interface IMusicService  
{  
    //This operation uses a GET method.  
    [OperationContract]  
    [WebGet]  
    string LookUpArtist(string album);  

    //This operation will use a POST method.  
    [OperationContract]  
    [WebInvoke]  
    void AddAlbum(string user, string album);  

    //This operation will use POST method by default  
    //since nothing else is explicitly specified.  
    [OperationContract]  
    string[] GetAlbums(string user);  

    //Other operations omitted…  

}

  2. 使用 IMusicService 來實作 MusicService 服務合約。

    public class MusicService : IMusicService  
{  
    public void AddAlbum(string user, string album)  
    {  
        //Add implementation here.  
    }  

     //Other operations omitted…  
}

  3. 在應用程式中建立名為 service 且包含 .svc 副檔名的新檔案。 您可以為服務新增適當的 @ServiceHost 指示詞，來編輯這個檔案。 指定 WebScriptServiceHostFactory 將用在 @ServiceHost 指示詞中，以自動設定 ASP.NET AJAX 端點。

    <%@ServiceHost
    language=c#
    Debug="true"
    Service="Microsoft.Ajax.Samples.MusicService"  
    Factory=System.ServiceModel.Activation.WebScriptServiceHostFactory  
%>

若要呼叫服務

  1. 您可以透過瀏覽器，測試不包含任何用戶端程式碼的服務 GET 作業。 例如，如果您的服務是設定在 http://example.com/service.svc 位址上，則將 http://example.com/service.svc/LookUpArtist?album=SomeAlbum 輸入瀏覽器網址列中會叫用服務並導致下載或顯示回應。

  2. 您可以使用包含 GET 作業的服務，方法就像您使用其他任何 ASP.NET AJAX 服務一樣，亦即在 ASP.NET AJAX 指令碼管理員控制項的指令碼集合中輸入服務 URL。 如需範例，請參閱基本 AJAX 服務。

另請參閱