FtpWebRequest.Method Свойство

Определение

Пространство имен:
System.Net
Сборки:
netstandard.dll, System.Net.Requests.dll
Сборка:
System.Net.Requests.dll
Сборка:
System.dll
Сборка:
netstandard.dll
Исходный код:
FtpWebRequest.cs
Исходный код:
FtpWebRequest.cs
Исходный код:
FtpWebRequest.cs
Исходный код:
FtpWebRequest.cs
Исходный код:
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.

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 завершается ошибкой.

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

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

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