FtpWebRequest.EndGetResponse メソッド

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

FtpWebRequest.EndGetResponse メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

BeginGetResponse で開始された保留中の非同期操作を終了します。

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

Visual Basic (宣言)

Public Overrides Function
 EndGetResponse ( _
    asyncResult As IAsyncResult _
) As WebResponse

Visual Basic (使用法)

Dim instance As FtpWebRequest
Dim asyncResult As IAsyncResult
Dim returnValue As WebResponse

returnValue = instance.EndGetResponse(asyncResult)

C#

public override WebResponse EndGetResponse (
    IAsyncResult asyncResult
)

C++

public:
virtual WebResponse^ EndGetResponse (
    IAsyncResult^ asyncResult
) override

J#

public WebResponse EndGetResponse (
    IAsyncResult asyncResult
)

JScript

public override function EndGetResponse (
    asyncResult : IAsyncResult
) : WebResponse

パラメータ

asyncResult

操作の開始時に返された IAsyncResult。

戻り値
FtpWebResponse インスタンスを格納している WebResponse 参照。このオブジェクトは、要求に対する FTP サーバーの応答を格納しています。

例外

例外の種類	条件
ArgumentNullException	asyncResult が null 参照 (Visual Basic では Nothing) です。
ArgumentException	BeginGetResponse の呼び出しで、asyncResult が取得されませんでした。
InvalidOperationException	このメソッドは、asyncResult で識別される操作に対して既に呼び出されています。

解説

EndGetResponse メソッドが呼び出されたときに操作が完了していなかった場合、EndGetResponse は操作が完了するまでブロックします。ブロックされないようにするには、EndGetResponse を呼び出す前に、IsCompleted プロパティをチェックします。

「例外」で説明している例外に加えて、EndGetResponse は、サーバーとの通信中にスローされた例外を再スローします。

メモ
このメンバは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。詳細については、「ネットワークのトレース」を参照してください。

呼び出し時の注意 このメソッドは、ネットワーク トラフィックを生成します。

使用例

応答を取得するための非同期操作を終了するコード例を次に示します。このコード例は FtpWebRequest クラスの概要で取り上げているコード例の一部分です。

C#

// The EndGetResponseCallback method  
// completes a call to BeginGetResponse.
private static void EndGetResponseCallback(IAsyncResult
 ar)
{
    FtpState state = (FtpState) ar.AsyncState;
    FtpWebResponse response = null;
    try 
    {
        response = (FtpWebResponse) state.Request.EndGetResponse(ar);
        response.Close();
        state.StatusDescription = response.StatusDescription;
        // Signal the main application thread that 
        // the operation is complete.
        state.OperationComplete.Set();
    }
    // Return exceptions to the main application thread.
    catch (Exception e)
    {
        Console.WriteLine ("Error getting response.");
        state.OperationException = e;
        state.OperationComplete.Set();
    }
}

C++

// The EndGetResponseCallback method  
// completes a call to BeginGetResponse.
static void EndGetResponseCallback( IAsyncResult^
 ar )
{
   FtpState^ state = dynamic_cast<FtpState^>(ar->AsyncState);
   FtpWebResponse ^ response = nullptr;
   try
   {
      response = dynamic_cast<FtpWebResponse^>(state->Request->EndGetResponse(
 ar ));
      response->Close();
      state->StatusDescription = response->StatusDescription;

      // Signal the main application thread that 
      // the operation is complete.
      state->OperationComplete->Set();
   }
   // Return exceptions to the main application thread.
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "Error getting response." );
      state->OperationException = e;
      state->OperationComplete->Set();
   }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
FtpWebRequest クラス
FtpWebRequest メンバ
System.Net 名前空間
FtpWebResponse
FtpStatusCode 列挙体
WebRequestMethods.Ftp
WebRequest
WebResponse
WebClient
GetResponse