FtpWebRequest.Method Свойство
В этой статье
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает команду, которая будет отправлена на 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, содержащее FTP-команду для отправки на сервер. Значение по умолчанию — DownloadFile.
Для этого свойства задано новое значение для уже выполняющегося запроса.
Метод является недопустимым.
-или-
Метод не поддерживается.
-или-
Было указано несколько методов.
В следующем примере кода этому свойству присваивается значение 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 .
Применяется к
Продукт | Версии |
---|---|
.NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |