FtpWebResponse クラス

定義

名前空間:

System.Net

アセンブリ:

System.Net.Requests.dll

ソース:

FtpWebResponse.cs

要求に対するファイル転送プロトコル (FTP: File Transfer Protocol) サーバーの応答をカプセル化します。

public ref class FtpWebResponse : System::Net::WebResponse, IDisposable

public class FtpWebResponse : System.Net.WebResponse, IDisposable

type FtpWebResponse = class
    inherit WebResponse
    interface IDisposable

Public Class FtpWebResponse
Inherits WebResponse
Implements IDisposable

継承

Object

MarshalByRefObject

WebResponse

FtpWebResponse

実装

IDisposable

例

次のコード例では、FTP サーバー上のファイルを削除する要求を送信し、要求に対するサーバーの応答からステータス メッセージを表示します。 その他の例については、 クラスと FtpWebRequest クラスのメンバーをWebRequestMethods.Ftp参照してください。

static bool DeleteFileOnServer( Uri^ serverUri )
{
   // The serverUri parameter should use the ftp:// scheme.
   // It contains the name of the server file that is to be deleted.
   // Example: ftp://contoso.com/someFile.txt.
   // 
   if ( serverUri->Scheme != Uri::UriSchemeFtp )
   {
      return false;
   }

   // Get the object used to communicate with the server.
   FtpWebRequest^ request = dynamic_cast<FtpWebRequest^>(WebRequest::Create( serverUri ));
   request->Method = WebRequestMethods::Ftp::DeleteFile;
   FtpWebResponse^ response = dynamic_cast<FtpWebResponse^>(request->GetResponse());
   Console::WriteLine( "Delete status: {0}", response->StatusDescription );
   response->Close();
   return true;
}

public static bool DeleteFileOnServer(Uri serverUri)
{
    // The serverUri parameter should use the ftp:// scheme.
    // It contains the name of the server file that is to be deleted.
    // Example: ftp://contoso.com/someFile.txt.
    //

    if (serverUri.Scheme != Uri.UriSchemeFtp)
    {
        return false;
    }
    // Get the object used to communicate with the server.
    FtpWebRequest request = (FtpWebRequest)WebRequest.Create(serverUri);
    request.Method = WebRequestMethods.Ftp.DeleteFile;

    FtpWebResponse response = (FtpWebResponse) request.GetResponse();
    Console.WriteLine("Delete status: {0}",response.StatusDescription);
    response.Close();
    return true;
}

注釈

の FtpWebResponse インスタンスは、 メソッドを呼び出すことによって取得されます GetResponse 。 返されるオブジェクトは、 にキャストする FtpWebResponse必要があります。 アプリケーションで オブジェクトが不要になったら、 メソッドをFtpWebResponseClose呼び出して、 によって保持されているリソースをFtpWebResponse解放します。

プロパティには StatusCode 、サーバーによって返される状態コードが含まれており StatusDescription 、 プロパティは状態コードと状態を説明するメッセージを返します。 これらのプロパティによって返される値は、サーバーからメッセージが返されると変更されます。

要求によって返されるデータ (要求に対 ListDirectory して返されるファイル名の一覧など) は、 メソッドによって GetResponseStream 返されるストリームで使用できます。 ストリーム データの長さは、 プロパティから ContentLength 取得できます。

プロパティ

BannerMessage	ログオン前に接続が確立された場合に、FTP サーバーが送信するメッセージを取得します。
ContentLength	FTP サーバーから受信したデータの長さを取得します。
ContentType	派生クラスでオーバーライドされると、受信しているデータのコンテンツ タイプを取得または設定します。 (継承元 WebResponse)
ExitMessage	FTP セッションの終了時にサーバーが送信するメッセージを取得します。
Headers	空の WebHeaderCollection オブジェクトを取得します。
IsFromCache	この応答がキャッシュから取得されたかどうかを示す Boolean 値を取得します。 (継承元 WebResponse)
IsMutuallyAuthenticated	相互認証が行われたかどうかを示す Boolean 値を取得します。 (継承元 WebResponse)
LastModified	FTP サーバー上のファイルが最後に更新された日時を取得します。
ResponseUri	要求に対する応答を送信する URI を取得します。
StatusCode	FTP サーバーから送信された最新のステータス コードを取得します。
StatusDescription	FTP サーバーから送信されたステータス コードを示すテキストを取得します。
SupportsHeaders	Headers プロパティが FtpWebResponse インスタンスによってサポートされているかどうかを示す値を取得します。
WelcomeMessage	認証の完了時に FTP サーバーが送信するメッセージを取得します。

メソッド

Close()	応答によって保持されているリソースを解放します。
CreateObjRef(Type)	リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (継承元 MarshalByRefObject)
Dispose()	WebResponse オブジェクトによって使用されているアンマネージ リソースを解放します。 (継承元 WebResponse)
Dispose(Boolean)	WebResponse オブジェクトによって使用されているアンマネージド リソースを解放します。オプションとして、マネージド リソースを破棄することもできます。 (継承元 WebResponse)
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetLifetimeService()	古い. 対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 (継承元 MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext)	古い. SerializationInfo に、ターゲット オブジェクトをシリアル化するために必要なデータを設定します。 (継承元 WebResponse)
GetResponseStream()	FTP サーバーから送信された応答データを格納しているストリームを取得します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
InitializeLifetimeService()	古い. このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。 (継承元 MarshalByRefObject)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
MemberwiseClone(Boolean)	現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。 (継承元 MarshalByRefObject)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

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

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

古い. SerializationInfo インスタンスに、WebResponse をシリアル化するために必要なデータを設定します。 (継承元 WebResponse)

こちらもご覧ください

• FtpWebRequest
• FtpStatusCode
• WebRequestMethods.Ftp
• WebRequest
• WebResponse
• WebClient