HttpWebResponse HttpWebResponse HttpWebResponse HttpWebResponse Class

定義

WebResponse クラスの HTTP 固有の実装を提供します。Provides an HTTP-specific implementation of the WebResponse class.

public ref class HttpWebResponse : System::Net::WebResponse, IDisposable, System::Runtime::Serialization::ISerializable
[System.Serializable]
public class HttpWebResponse : System.Net.WebResponse, IDisposable, System.Runtime.Serialization.ISerializable
type HttpWebResponse = class
    inherit WebResponse
    interface ISerializable
    interface IDisposable
Public Class HttpWebResponse
Inherits WebResponse
Implements IDisposable, ISerializable
継承
属性
実装

次の例ではHttpWebResponseHttpWebRequestからを返します。The following example returns an HttpWebResponse from an HttpWebRequest.

HttpWebRequest^ HttpWReq = dynamic_cast<HttpWebRequest^>(WebRequest::Create( "http://www.contoso.com" ));
HttpWebResponse^ HttpWResp = dynamic_cast<HttpWebResponse^>(HttpWReq->GetResponse());

// Insert code that uses the response object.
HttpWResp->Close();
HttpWebRequest HttpWReq = 
(HttpWebRequest)WebRequest.Create("http://www.contoso.com");

HttpWebResponse HttpWResp = (HttpWebResponse)HttpWReq.GetResponse();
// Insert code that uses the response object.
HttpWResp.Close();
Dim HttpWReq As HttpWebRequest = _
   CType(WebRequest.Create("http://www.contoso.com"), HttpWebRequest)
       
Dim HttpWResp As HttpWebResponse = _
   CType(HttpWReq.GetResponse(), HttpWebResponse)
' Insert code that uses the response object.
HttpWResp.Close()

注釈

このクラスには、 WebResponseクラスのプロパティおよびメソッドの HTTP 固有の使用がサポートされています。This class contains support for HTTP-specific uses of the properties and methods of the WebResponse class. クラスHttpWebResponseは、http 要求を送信して http 応答を受信する、http スタンドアロンクライアントアプリケーションを構築するために使用されます。The HttpWebResponse class is used to build HTTP stand-alone client applications that send HTTP requests and receive HTTP responses.

注意

ASP.NET アプリケーションでHttpWebResponse使用さHttpResponseれるクラスと混同しないでください。このクラスのメソッドとプロパティは、ASP を通じて公開されます。NET の組み込みResponseオブジェクト。Do not confuse HttpWebResponse with the HttpResponse class that is used in ASP.NET applications and whose methods and properties are exposed through ASP.NET's intrinsic Response object.

クラスのインスタンスを直接作成することはHttpWebResponse避けてください。You should never directly create an instance of the HttpWebResponse class. 代わりに、の呼び出しHttpWebRequest.GetResponseによって返されたインスタンスを使用します。Instead, use the instance returned by a call to HttpWebRequest.GetResponse. 応答を終了し、 Stream.Close再利用HttpWebResponse.Closeするために接続を解放するには、メソッドまたはメソッドのいずれかを呼び出す必要があります。You must call either the Stream.Close or the HttpWebResponse.Close method to close the response and release the connection for reuse. Stream.CloseHttpWebResponse.Closeの両方を呼び出す必要はありませんが、この操作を行ってもエラーは発生しません。It is not necessary to call both Stream.Close and HttpWebResponse.Close, but doing so does not cause an error.

インターネットリソースから返される共通ヘッダー情報は、クラスのプロパティとして公開されます。Common header information returned from the Internet resource is exposed as properties of the class. 完全な一覧については、次の表を参照してください。See the following table for a complete list. その他のヘッダーは、 Headers名前と値のペアとしてプロパティから読み取ることができます。Other headers can be read from the Headers property as name/value pairs.

次の表は、 HttpWebResponseクラスのプロパティを通じて使用できる共通の HTTP ヘッダーを示しています。The following table shows the common HTTP headers that are available through properties of the HttpWebResponse class.

HeaderHeader プロパティProperty
コンテンツエンコードContent-Encoding ContentEncoding
ContentLengthContent-Length ContentLength
Content-TypeContent-Type ContentType
Last-ModifiedLast-Modified LastModified
サーバーServer Server

インターネットリソースからの応答の内容は、 Stream GetResponseStreamメソッドを呼び出すことによってとして返されます。The contents of the response from the Internet resource are returned as a Stream by calling the GetResponseStream method.

コンストラクター

HttpWebResponse() HttpWebResponse() HttpWebResponse() HttpWebResponse()

HttpWebResponse クラスの新しいインスタンスを初期化します。Initializes a new instance of the HttpWebResponse class.

HttpWebResponse(SerializationInfo, StreamingContext) HttpWebResponse(SerializationInfo, StreamingContext) HttpWebResponse(SerializationInfo, StreamingContext) HttpWebResponse(SerializationInfo, StreamingContext)

指定した HttpWebResponse インスタンスと SerializationInfo インスタンスから、StreamingContext クラスの新しいインスタンスを初期化します。Initializes a new instance of the HttpWebResponse class from the specified SerializationInfo and StreamingContext instances.

プロパティ

CharacterSet CharacterSet CharacterSet CharacterSet

応答の文字セットを取得します。Gets the character set of the response.

ContentEncoding ContentEncoding ContentEncoding ContentEncoding

応答の本体をエンコードするために使用するメソッドを取得します。Gets the method that is used to encode the body of the response.

ContentLength ContentLength ContentLength ContentLength

要求で返されるコンテンツ長を取得します。Gets the length of the content returned by the request.

ContentType ContentType ContentType ContentType

応答のコンテンツ タイプを取得します。Gets the content type of the response.

Cookies Cookies Cookies Cookies

この応答に関連付けられているクッキーを取得または設定します。Gets or sets the cookies that are associated with this response.

Headers Headers Headers Headers

応答に関連付けられているヘッダーをサーバーから取得します。Gets the headers that are associated with this response from the server.

IsFromCache IsFromCache IsFromCache IsFromCache

この応答がキャッシュから取得されたかどうかを示す Boolean 値を取得します。Gets a Boolean value that indicates whether this response was obtained from the cache.

(Inherited from WebResponse)
IsMutuallyAuthenticated IsMutuallyAuthenticated IsMutuallyAuthenticated IsMutuallyAuthenticated

クライアントとサーバーの両方が認証されたかどうかを示す Boolean 値を取得します。Gets a Boolean value that indicates whether both client and server were authenticated.

LastModified LastModified LastModified LastModified

応答の内容が最後に変更された日付と時刻を取得します。Gets the last date and time that the contents of the response were modified.

Method Method Method Method

応答を返すために使用するメソッドを取得します。Gets the method that is used to return the response.

ProtocolVersion ProtocolVersion ProtocolVersion ProtocolVersion

応答で使用される HTTP プロトコルのバージョンを取得します。Gets the version of the HTTP protocol that is used in the response.

ResponseUri ResponseUri ResponseUri ResponseUri

要求に応答したインターネット リソースの URI を取得します。Gets the URI of the Internet resource that responded to the request.

Server Server Server Server

応答を送信したサーバーの名前を取得します。Gets the name of the server that sent the response.

StatusCode StatusCode StatusCode StatusCode

応答のステータスを取得します。Gets the status of the response.

StatusDescription StatusDescription StatusDescription StatusDescription

応答で返されるステータス記述を取得します。Gets the status description returned with the response.

SupportsHeaders SupportsHeaders SupportsHeaders SupportsHeaders

ヘッダーがサポートされているかどうかを示す値を取得します。Gets a value that indicates whether headers are supported.

メソッド

Close() Close() Close() Close()

応答ストリームを閉じます。Closes the response stream.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

WebResponse オブジェクトによって使用されているアンマネージ リソースを解放します。Releases the unmanaged resources used by the WebResponse object.

(Inherited from WebResponse)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

HttpWebResponse が使用しているアンマネージド リソースを解放します。オプションでマネージド リソースも破棄します。Releases the unmanaged resources used by the HttpWebResponse, and optionally disposes of the managed resources.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

HttpWebResponse インスタンスのハッシュ値を返します。Returns a hash value for a HttpWebResponse instance.

GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

SerializationInfo に、オブジェクトをシリアル化するために必要なデータを設定します。Populates a SerializationInfo with the data needed to serialize the target object.

GetResponseHeader(String) GetResponseHeader(String) GetResponseHeader(String) GetResponseHeader(String)

応答で返されたヘッダーの内容を取得します。Gets the contents of a header that was returned with the response.

GetResponseStream() GetResponseStream() GetResponseStream() GetResponseStream()

サーバーから応答の本文を読み取るために使用するストリームを取得します。Gets the stream that is used to read the body of the response from the server.

GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

明示的なインターフェイスの実装

IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose()

HttpWebResponse によって使用されているすべてのリソースを解放します。Releases all resources used by the HttpWebResponse.

ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext)

このインスタンスを、指定した SerializationInfo オブジェクトにシリアル化します。Serializes this instance into the specified SerializationInfo object.

適用対象

こちらもご覧ください