C#のHttpWebResponseクラス
4958 ワード
WebResponseクラスのHTTP固有の実装を提供する.
階層の継承
.Object→System
.MarshalByRefObject→System.Net
.WebResponse→
System.Net.HttpWebResponse
ネーミングスペース:System.Net;プログラムセット:System(System.dll).
C#構文
HttpWebResponseタイプは、以下のメンバーを開示する.
1、コンストラクタ
名前
説明
HttpWebResponse()
古いです.HttpWebResponseクラスの新しいインスタンスを初期化します.
HttpWebResponse(SerializationInfo, StreamingContext)
古くなりました.HttpWebResponseクラスの新しいインスタンスは、指定したSerializationInfoおよびStreamingContextインスタンスに基づいて初期化されます.
2、属性
名前
説明
CharacterSet
応答の文字セットを取得します.
ContentEncoding
応答体を符号化する方法を取得する.
ContentLength
要求されたコンテンツの長さを取得します.(WebResponse.contentLengthを書き換えます.)
ContentType
レスポンスのコンテンツタイプを取得します.(WebResponse.contentTypeを書き換えます.)
Cookies
このレスポンスに関連付けられたCookieを取得または設定します.
Headers
このレスポンスに関連付けられたヘッダをサーバから取得します.(WebResponse.Headersを書き換えます.)
IsFromCache
このレスポンスがキャッシュから取得されたかどうかを示すBoolean値を取得します(WebResponseから継承されます).
IsMutuallyAuthenticated
クライアントとサーバが認証済みかどうかを示すBoolean値を取得します(WebResponse.IsMutuallyAuthenticatedを書き換えます).
LastModified
最後に変更されたレスポンス内容の日付と時間を取得します.
Method
応答を返す方法を取得します.
ProtocolVersion
レスポンスで使用されるHTTPプロトコルのバージョンを取得します.
ResponseUri
リクエストに応答するインターネットリソースのURIを取得します.(WebResponse.ResponseUriを書き換えます.)
Server
送信応答のサーバ名を取得します.
StatusCode
応答のステータスを取得します.
StatusDescription
応答とともに返されるステータスの説明を取得します.
SupportsHeaders
タイトルがサポートされているかどうかを示す値を取得します.(WebResponse.SupportsHeadersを書き換えます.)
3、方法
名前
説明
Close
応答フローを閉じます.(WebResponse.Close()を書き換えます.)
CreateObjRef
リモート・オブジェクトと通信するエージェントを生成するために必要なすべての関連情報を含むオブジェクトを作成します(MarshalByRefObjectから継承されます).
Dispose()
WebResponseオブジェクトで使用されている管理されていないリソースを解放します.(WebResponseから継承されます.)
Dispose(Boolean)
HttpWebResponseで使用される非管理リソースを解放し、必要に応じて管理リソースを解放します.(WebResponse.Dispose(Boolean)を書き換えます.)
Equals(Object)
指定したオブジェクトが現在のオブジェクトに等しいかどうかを決定します.(Objectから継承されます.)
Finalize
オブジェクトがリサイクル前にリソースを解放し、その他のクリーンアップ操作を実行できるようにします(Objectから継承されます).
GetHashCode
デフォルトのハッシュ関数として使用します.(Objectから継承されます.)
GetLifetimeService
このインスタンスの生存期間ポリシーを制御する現在の生存期間サービスオブジェクトを取得します.(MarshalByRefObjectから継承されます.)
GetObjectData
インフラストラクチャ.ターゲットオブジェクトをシーケンス化するために必要なデータを使用してSerializationInfoに入力します.(WebResponse.GetObjectData(SerializationInfo,StreamingContext)を書き換えます.)
GetResponseHeader
応答とともに返されるヘッダの内容を取得します.
GetResponseStream
サーバからの応答のボリュームを読み込むストリームを取得します(WebResponse.GetResponseStream()を書き換えます.)
GetType
現在のインスタンスのTypeを取得します.(Objectから継承されます.)
InitializeLifetimeService
このインスタンスを制御する生存期間ポリシーの生存期間サービスオブジェクトを取得します.(MarshalByRefObjectから継承されます.)
MemberwiseClone()
現在のObjectの浅いテーブルコピーを作成します.(Objectから継承されます.)
MemberwiseClone(Boolean)
現在のMarshalByRefObjectオブジェクトの浅いテーブルのコピーを作成します(MarshalByRefObjectから継承されます).
ToString
現在のオブジェクトを表す文字列を返します.(Objectから継承されます.)
4、明示的なインタフェースの実現
名前
説明
IDisposable.Dispose
インフラストラクチャ.派生クラスで書き換えられると、WebResponseが使用するすべてのリソースが解放されます.(WebResponseから継承されます.)
ISerializable.GetObjectData
インフラストラクチャ.このインスタンスを指定したSerializationInfoオブジェクトにシーケンス化します.
5、備考
このクラスには、WebResponseクラスの属性およびメソッドに対するHTTP固有の使用法のサポートが含まれています.HttpWebResponseクラスは、HTTPリクエストの送信およびHTTP応答の受信のためのHTTP独立クライアントアプリケーションを生成するために使用されます.
説明
HttpWebResponseクラスとHttpResponseクラスを混同しないでください.後者はASP.NETアプリケーションに使用され、その方法と属性はASP.NETの内部Responseオブジェクトによって公開されます.
HttpWebResponseクラスのインスタンスを直接作成するのではなく、HttpWebRequest.GetResponseを呼び出すことによって返されるインスタンスを使用します.Stream.CloseメソッドまたはHttpWebResponse.Closeメソッドを呼び出す必要があります.応答を停止し、再利用のために接続を解放する必要があります.Stream.CloseとHttpWebResponse.Closeを同時に呼び出す必要はありませんが、これでは導きません.エラーを起こす.
Internetリソースから返される共通ヘッダー情報は、クラスのプロパティとして公開されています.完全なリストについては、次の表を参照してください.Headersプロパティから他のヘッダーを名前/値ペアで読み込むことができます.
次の表に、HttpWebResponseクラスのプロパティで使用できる共通HTTPヘッダを示します.
Header
Property
コンテンツエンコーディング
ContentEncoding
Content-Length
ContentLength
Content-Type
ContentType
最終変更日
LastModified
サーバ
Server
GetResponseStreamメソッドを呼び出すことで、インターネットリソースからの応答の内容をStreamとして返します.
6、例
階層の継承
.Object→System
.MarshalByRefObject→System.Net
.WebResponse→
System.Net.HttpWebResponse
ネーミングスペース:System.Net;プログラムセット:System(System.dll).
C#構文
[SerializableAttribute]
public class HttpWebResponse : WebResponse, ISerializable HttpWebResponseタイプは、以下のメンバーを開示する.
1、コンストラクタ
名前
説明
HttpWebResponse()
古いです.HttpWebResponseクラスの新しいインスタンスを初期化します.
HttpWebResponse(SerializationInfo, StreamingContext)
古くなりました.HttpWebResponseクラスの新しいインスタンスは、指定したSerializationInfoおよびStreamingContextインスタンスに基づいて初期化されます.
2、属性
名前
説明
CharacterSet
応答の文字セットを取得します.
ContentEncoding
応答体を符号化する方法を取得する.
ContentLength
要求されたコンテンツの長さを取得します.(WebResponse.contentLengthを書き換えます.)
ContentType
レスポンスのコンテンツタイプを取得します.(WebResponse.contentTypeを書き換えます.)
Cookies
このレスポンスに関連付けられたCookieを取得または設定します.
Headers
このレスポンスに関連付けられたヘッダをサーバから取得します.(WebResponse.Headersを書き換えます.)
IsFromCache
このレスポンスがキャッシュから取得されたかどうかを示すBoolean値を取得します(WebResponseから継承されます).
IsMutuallyAuthenticated
クライアントとサーバが認証済みかどうかを示すBoolean値を取得します(WebResponse.IsMutuallyAuthenticatedを書き換えます).
LastModified
最後に変更されたレスポンス内容の日付と時間を取得します.
Method
応答を返す方法を取得します.
ProtocolVersion
レスポンスで使用されるHTTPプロトコルのバージョンを取得します.
ResponseUri
リクエストに応答するインターネットリソースのURIを取得します.(WebResponse.ResponseUriを書き換えます.)
Server
送信応答のサーバ名を取得します.
StatusCode
応答のステータスを取得します.
StatusDescription
応答とともに返されるステータスの説明を取得します.
SupportsHeaders
タイトルがサポートされているかどうかを示す値を取得します.(WebResponse.SupportsHeadersを書き換えます.)
3、方法
名前
説明
Close
応答フローを閉じます.(WebResponse.Close()を書き換えます.)
CreateObjRef
リモート・オブジェクトと通信するエージェントを生成するために必要なすべての関連情報を含むオブジェクトを作成します(MarshalByRefObjectから継承されます).
Dispose()
WebResponseオブジェクトで使用されている管理されていないリソースを解放します.(WebResponseから継承されます.)
Dispose(Boolean)
HttpWebResponseで使用される非管理リソースを解放し、必要に応じて管理リソースを解放します.(WebResponse.Dispose(Boolean)を書き換えます.)
Equals(Object)
指定したオブジェクトが現在のオブジェクトに等しいかどうかを決定します.(Objectから継承されます.)
Finalize
オブジェクトがリサイクル前にリソースを解放し、その他のクリーンアップ操作を実行できるようにします(Objectから継承されます).
GetHashCode
デフォルトのハッシュ関数として使用します.(Objectから継承されます.)
GetLifetimeService
このインスタンスの生存期間ポリシーを制御する現在の生存期間サービスオブジェクトを取得します.(MarshalByRefObjectから継承されます.)
GetObjectData
インフラストラクチャ.ターゲットオブジェクトをシーケンス化するために必要なデータを使用してSerializationInfoに入力します.(WebResponse.GetObjectData(SerializationInfo,StreamingContext)を書き換えます.)
GetResponseHeader
応答とともに返されるヘッダの内容を取得します.
GetResponseStream
サーバからの応答のボリュームを読み込むストリームを取得します(WebResponse.GetResponseStream()を書き換えます.)
GetType
現在のインスタンスのTypeを取得します.(Objectから継承されます.)
InitializeLifetimeService
このインスタンスを制御する生存期間ポリシーの生存期間サービスオブジェクトを取得します.(MarshalByRefObjectから継承されます.)
MemberwiseClone()
現在のObjectの浅いテーブルコピーを作成します.(Objectから継承されます.)
MemberwiseClone(Boolean)
現在のMarshalByRefObjectオブジェクトの浅いテーブルのコピーを作成します(MarshalByRefObjectから継承されます).
ToString
現在のオブジェクトを表す文字列を返します.(Objectから継承されます.)
4、明示的なインタフェースの実現
名前
説明
IDisposable.Dispose
インフラストラクチャ.派生クラスで書き換えられると、WebResponseが使用するすべてのリソースが解放されます.(WebResponseから継承されます.)
ISerializable.GetObjectData
インフラストラクチャ.このインスタンスを指定したSerializationInfoオブジェクトにシーケンス化します.
5、備考
このクラスには、WebResponseクラスの属性およびメソッドに対するHTTP固有の使用法のサポートが含まれています.HttpWebResponseクラスは、HTTPリクエストの送信およびHTTP応答の受信のためのHTTP独立クライアントアプリケーションを生成するために使用されます.
説明HttpWebResponseクラスとHttpResponseクラスを混同しないでください.後者はASP.NETアプリケーションに使用され、その方法と属性はASP.NETの内部Responseオブジェクトによって公開されます.
HttpWebResponseクラスのインスタンスを直接作成するのではなく、HttpWebRequest.GetResponseを呼び出すことによって返されるインスタンスを使用します.Stream.CloseメソッドまたはHttpWebResponse.Closeメソッドを呼び出す必要があります.応答を停止し、再利用のために接続を解放する必要があります.Stream.CloseとHttpWebResponse.Closeを同時に呼び出す必要はありませんが、これでは導きません.エラーを起こす.
Internetリソースから返される共通ヘッダー情報は、クラスのプロパティとして公開されています.完全なリストについては、次の表を参照してください.Headersプロパティから他のヘッダーを名前/値ペアで読み込むことができます.
次の表に、HttpWebResponseクラスのプロパティで使用できる共通HTTPヘッダを示します.
Header
Property
コンテンツエンコーディング
ContentEncoding
Content-Length
ContentLength
Content-Type
ContentType
最終変更日
LastModified
サーバ
Server
GetResponseStreamメソッドを呼び出すことで、インターネットリソースからの応答の内容をStreamとして返します.
6、例
HttpWebRequest HttpWReq =
(HttpWebRequest)WebRequest.Create("http://www.contoso.com");
HttpWebResponse HttpWResp = (HttpWebResponse)HttpWReq.GetResponse();
// Insert code that uses the response object. HttpWResp.Close();