FtpWebRequest.Method プロパティ

定義

FTP サーバーに送信するためのコマンドを取得または設定します。Gets or sets the command to send to the FTP server.

public:
 virtual property System::String ^ Method { System::String ^ get(); void set(System::String ^ value); };
public override string? Method { get; set; }
public override string Method { get; set; }
member this.Method : string with get, set
Public Overrides Property Method As String

プロパティ値

String

サーバーに送信するための FTP コマンドを格納している String 値。A String value that contains the FTP command to send to the server. 既定値は DownloadFile です。The default value is DownloadFile.

例外

既に処理中の要求で、このプロパティに対して新しい値が指定されました。A new value was specified for this property for a request that is already in progress.

メソッドが無効です。The method is invalid.

- または --or-

メソッドがサポートされていません。The method is not supported.

- または --or-

複数のメソッドが指定されました。Multiple methods were specified.

このプロパティをに設定するコード例を次に示し DeleteFile ます。The following code example sets this property to DeleteFile.

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

注釈

プロパティは、 Method サーバーに送信されるコマンドを決定します。The Method property determines which command is sent to the server. を設定する Method には、クラスのパブリックフィールドメンバーに定義されている文字列を使用し WebRequestMethods.Ftp ます。You set the Method by using the strings defined in the public field members of the WebRequestMethods.Ftp class. クラスで定義されている文字列は、プロパティでサポートされ WebRequestMethods.Ftp ている唯一のオプションです MethodNote that the strings defined in the WebRequestMethods.Ftp class are the only supported options for the Method property. プロパティを Method 他の値に設定すると、例外が発生 ArgumentException します。Setting the Method property to any other value will result in an ArgumentException exception.

をに設定する場合は Method UploadFile 、メソッドを呼び出す前にこれを行う必要があり GetRequestStream ます。When setting Method to UploadFile, you must do so before calling the GetRequestStream method. 正しい順序でこれらのメンバーを呼び出さないと、 ProtocolViolationException 要求ストリームを取得しようとすると例外が発生します。Failure to call these members in the correct order causes a ProtocolViolationException exception when you attempt to get the request stream.

オブジェクトに指定する資格情報には、 FtpWebRequest 指定されたメソッドを実行するためのアクセス許可が必要です。The credentials supplied for the FtpWebRequest object must have permission to perform the specified method. それ以外の場合、FTP コマンドは失敗します。If not, the FTP command fails.

コマンドの成功または失敗を確認するには、 StatusCode プロパティとプロパティを確認し StatusDescription ます。To determine the success or failure of a command, check the StatusCode and StatusDescription properties.

適用対象

こちらもご覧ください