WebException.Response プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

WebException.Response プロパティ

リモートホストが返す応答を取得します。

名前空間: System.Net
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 Response As WebResponse

Visual Basic (使用法)

Dim instance As WebException
Dim value As WebResponse

value = instance.Response

public WebResponse Response { get; }

C++

public:
property WebResponse^ Response {
    WebResponse^ get ();
}

/** @property */
public WebResponse get_Response ()

JScript

public function get Response
 () : WebResponse

プロパティ値
インターネットリソースから応答がある場合は、インターネットリソースからのエラー応答を格納した WebResponse インスタンス。それ以外の場合は null 参照 (Visual Basic では Nothing)。

解説

HTTP などの一部のインターネットプロトコルは、エラーがプロトコルレベルで発生したことを示すその他の有効な応答を返します。インターネット要求への応答がエラーを示している場合、WebRequest.GetResponse は Status プロパティを WebExceptionStatus.ProtocolError に設定し、エラーメッセージを格納した WebResponse をスローされた WebException の Response プロパティに提供します。アプリケーションは WebResponse を調べ、実際のエラーを判断できます。

使用例

Status プロパティをチェックし、元になる HttpWebResponse インスタンスの StatusCode および StatusDescription をコンソールに出力する例を次に示します。

Visual Basic

 Try
     'Create a web request for an invalid site. Substitute the "invalid
 site" strong in the Create call with a invalid name.
     Dim myHttpWebRequest As HttpWebRequest
 = CType(WebRequest.Create("invalid site"), HttpWebRequest)
     
     'Get the associated response for the above request.
     Dim myHttpWebResponse As HttpWebResponse
 = CType(myHttpWebRequest.GetResponse(), HttpWebResponse)
     myHttpWebResponse.Close()
 Catch e As WebException
     Console.WriteLine(e.Message)
     
      If e.Status = WebExceptionStatus.ProtocolError Then
         Console.WriteLine("Status Code : {0}", CType(e.Response,
 HttpWebResponse).StatusCode)
         Console.WriteLine("Status Description : {0}",
 CType(e.Response, HttpWebResponse).StatusDescription)
     End If

Catch e As Exception
     Console.WriteLine(e.Message)
 End Try

try {
   // Create a web request for an invalid site. Substitute the "invalid
 site" strong in the Create call with a invalid name.
     HttpWebRequest myHttpWebRequest = (HttpWebRequest) WebRequest.Create("invalid
 site");

    // Get the associated response for the above request.
     HttpWebResponse myHttpWebResponse = (HttpWebResponse) myHttpWebRequest.GetResponse();
    myHttpWebResponse.Close();
}
catch(WebException e) {
    Console.WriteLine("This program is expected to throw WebException on successful
 run."+
                        "\n\nException Message :" + e.Message);
    if(e.Status == WebExceptionStatus.ProtocolError) {
        Console.WriteLine("Status Code : {0}", ((HttpWebResponse)e.Response).StatusCode);
        Console.WriteLine("Status Description : {0}", ((HttpWebResponse)e.Response).StatusDescription);
    }
}
catch(Exception e) {
    Console.WriteLine(e.Message);
}

C++

try
{
   // Create a web request for an unknown server (this raises the WebException).
   HttpWebRequest^ myHttpWebRequest = (HttpWebRequest^)(WebRequest::Create( "http://unknown.unknown.com"
 ));
   
   // Get the associated response for the above request.
   HttpWebResponse^ myHttpWebResponse = (HttpWebResponse^)(myHttpWebRequest->GetResponse());
   myHttpWebResponse->Close();
}
catch ( WebException^ e ) 
{
   Console::WriteLine( "This program is expected to throw WebException on successful
 run." +
      "\n\nException Message : " + e->Message );
   if ( e->Status == WebExceptionStatus::ProtocolError )
   {
      Console::WriteLine( "Status Code: {0}", ( (HttpWebResponse^)(e->Response)
 )->StatusCode );
      Console::WriteLine( "Status Description: {0}", ( (HttpWebResponse^)(e->Response)
 )->StatusDescription );
   }
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->Message );
}

try {
    // Create a web request for an invalid site. Substitute the
    // "invalid site" strong in the Create call with a invalid
 name.
    HttpWebRequest myHttpWebRequest = (HttpWebRequest)WebRequest.
        Create("invalid site");
    // Get the associated response for the above request.
    HttpWebResponse myHttpWebResponse =
        ( HttpWebResponse)myHttpWebRequest.GetResponse();
    myHttpWebResponse.Close();
}
catch (WebException e) {
    Console.WriteLine("This program is expected to throw WebException"
        + " on successful run." + "\n\nException Message :" 
        + e.get_Message());
    if (e.get_Status().Equals(WebExceptionStatus.ProtocolError))
 {
        Console.WriteLine("Status Code : {0}", ((HttpWebResponse)(e.
            get_Response())).get_StatusCode());
        Console.WriteLine("Status Description : {0}",((HttpWebResponse)(
            e.get_Response())).get_StatusDescription());
    }
}