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; }
member this.Method : string with get, set
Public Overrides Property Method As String

Значение свойства

Значение String, содержащее FTP-команду для отправки на сервер.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, являются единственными поддерживаемыми параметрами для свойства Method.Note 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.

Применяется к

Дополнительно