FtpWebRequest.Method Свойство

Определение

Пространство имен:

System.Net

Сборка:

System.Net.Requests.dll

Исходный код:

FtpWebRequest.cs

Возвращает или задает команду, которая будет отправлена на FTP-сервер.

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

Значение String, содержащее FTP-команду для отправки на сервер. Значение по умолчанию — DownloadFile.

Исключения

InvalidOperationException

Для этого свойства задано новое значение для уже выполняющегося запроса.

ArgumentException

Метод является недопустимым.

-или-

Метод не поддерживается.

-или-

Было указано несколько методов.

Примеры

В следующем примере кода этому свойству присваивается значение 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 определяет, какая команда отправляется на сервер. Задается Method с помощью строк, определенных в элементах открытого WebRequestMethods.Ftp поля класса . Обратите внимание, что строки, определенные в WebRequestMethods.Ftp классе , являются единственными поддерживаемыми параметрами Method для свойства . Method Установка для свойства любого другого значения приведет к возникновению ArgumentException исключения.

Если задано значение MethodUploadFile, это необходимо сделать перед вызовом GetRequestStream метода . Если эти члены не вызываются в правильном ProtocolViolationException порядке, при попытке получить поток запроса возникает исключение.

Учетные данные, предоставленные FtpWebRequest для объекта, должны иметь разрешение на выполнение указанного метода. В противном случае команда FTP завершается ошибкой.

Чтобы определить успешность или сбой команды, проверьте StatusCode свойства и StatusDescription .

См. также раздел

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