FtpWebRequest.Method プロパティ

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

FtpWebRequest.Method プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

FTP サーバーに送信するためのコマンドを取得または設定します。

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

Visual Basic (宣言)

Public Overrides Property
 Method As String

Visual Basic (使用法)

Dim instance As FtpWebRequest
Dim value As String

value = instance.Method

instance.Method = value

C#

public override string Method { get;
 set; }

C++

public:
virtual property String^ Method {
    String^ get () override;
    void set (String^ value) override;
}

J#

/** @property */
public String get_Method ()

/** @property */
public void set_Method (String value)

JScript

public override function get
 Method () : String

public override function set
 Method (value : String)

プロパティ値
サーバーに送信するための FTP コマンドを格納している String 値。既定値は DownloadFile です。

例外

例外の種類	条件
InvalidOperationException	既に処理中の要求で、このプロパティに対して新しい値が指定されました。
ArgumentException	メソッドが無効です。 または メソッドがサポートされていません。 または 複数のメソッドが指定されました。

解説

Method プロパティによって、サーバーに送信されるコマンドが決まります。通常、WebRequestMethods.Ftp 構造体で定義された文字列を使用して Method を設定します。Method を UploadFile に設定する場合は、GetRequestStream メソッドを呼び出す前に行う必要があります。これらのメンバを正しい順序で呼び出すことができなかった場合は、要求ストリームを取得しようとすると ProtocolViolationException 例外が発生します。

FtpWebRequest オブジェクトに提供される資格情報には、指定したメソッドを実行するためのアクセス許可が必要です。アクセス許可がない場合、FTP コマンドは失敗します。

Method を、サーバーで認識されるいずれかのコマンドに設定し、FtpWebRequest オブジェクトを使用して、そのコマンドを送信できます。この方法は、そのコマンドがデータを送信する必要がなく、サーバーが要求を受けてデータを送信しない場合にだけ正常に動作します。

接続の状態を変更するコマンドを送信することはできません。たとえば、"MODE"、"PASV"、または "PORT" の各コマンドは使用しないでください。接続の状態を変更するコマンドを使用すると、要求および基になる接続が使用できない状態のままになる可能性があります。コマンドが成功したか失敗したかを確認するには、Status プロパティと StatusDescription プロパティをチェックします。

使用例

このプロパティを DeleteFile に設定するコード例を次に示します。

C#

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;
}

プラットフォーム

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