衍生自 WebResponse
WebResponse 類別是一種抽象基底類別,可提供基本的方法和屬性,建立適合 .NET Framework 可外掛式通訊協定 (Protocol) 模型的特定通訊協定回應。使用 WebRequest 類別向資源要求資料的應用程式,接收到 WebResponse 中的回應。特定通訊協定的 WebResponse 子代 (Descendant) 必須實作 WebResponse 類別的抽象成員。
相關的 WebRequest 類別必須建立 WebResponse 子代。例如,所建立的 HttpWebResponse 執行個體 (Instance) 僅作為呼叫 HttpWebRequest.GetResponse 或 HttpWebRequest.EndGetResponse 的結果。每個 WebResponse 都包含向資源要求的結果,且將不會重複使用。
ContentLength 屬性
ContentLength 屬性指示從 GetResponseStream 方法傳回的資料流中所具有的資料位元組數。ContentLength 屬性不指示伺服器傳回的頁首或中繼資料 (Metadata) 資訊的位元組數;它只指示所要求資源本身的資料位元組數。
ContentType 屬性
ContentType 屬性提供您的通訊協定要求您傳送至用戶端的任何特殊資訊,以識別伺服器所傳送的內容型別。通常,這是所傳回任何資料的 MIME 內容型別。
Headers 屬性
Headers 屬性包含與回應有關的中繼資料名稱值配對的任意集合。能夠表示為名稱值配對的通訊協定所需的中繼資料,都可以包含在 Headers 屬性之內。
您不需要使用 Headers 屬性就可以使用頁首中繼資料。特定通訊協定的中繼資料可公開為屬性;例如 HttpWebResponse.LastModified 屬性就會公開 Last-Modified HTTP 標頭。當您將標頭中繼資料公開為屬性時,您就不能再使用 Header 屬性來設定相同的屬性。
ResponseUri 屬性
ResponseUri 屬性包含實際提供回應的資源 URI。對於不支援重新導向的通訊協定而言,ResponseUri 將和建立回應之 WebRequest 的 RequestUri 屬性一樣。如果通訊協定支援重新導向要求,ResponseUri 將包含回應的 URI。
Close 方法
Close 方法關閉要求和回應所產生的任何連接,並清除回應所使用的資源。Close 方法會關閉回應所使用的所有資料流執行個體,但如果之前回應資料流是由對 Stream.Close 方法的呼叫所關閉的,它將不會擲回例外狀況 (Exception)。
GetResponseStream 方法
GetResponseStream 方法會傳回包含所要求資源之回應的資料流。回應資料流僅包含由資源傳回的資料;包含在回應中的頁首或中繼資料,都應該透過特定通訊協定屬性或 Headers 屬性,從回應中除去並對應用程式公開。
GetResponseStream 方法傳回的資料流執行個體,由應用程式所擁有,並可在不關閉 WebResponse 的情況下加以關閉。按照慣例,呼叫 WebResponse.Close 方法也會關閉由 GetResponse 傳回的資料流。
請參閱
設計可外掛式通訊協定程式 | 衍生自 WebRequest | WebResponse 類別 | HttpWebResponse 類別 | FileWebResponse 類別