FtpWebRequest.Method Vlastnost

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.Requests.dll

Zdroj:

FtpWebRequest.cs

Získá nebo nastaví příkaz k odeslání na server 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

Hodnota vlastnosti

String

Hodnota String , která obsahuje příkaz FTP pro odeslání na server. Výchozí hodnota je DownloadFile.

Výjimky

InvalidOperationException

Byla zadána nová hodnota pro tuto vlastnost pro požadavek, který již probíhá.

ArgumentException

Metoda je neplatná.

-nebo-

Metoda není podporována.

-nebo-

Bylo zadáno více metod.

Příklady

Následující příklad kódu nastaví tuto vlastnost na 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;
}

Poznámky

Vlastnost Method určuje, který příkaz se odešle na server. Nastavíte Method pomocí řetězců definovaných ve veřejných polích členů WebRequestMethods.Ftp třídy . Všimněte si, že řetězce definované ve WebRequestMethods.Ftp třídě jsou jedinými podporovanými možnostmi Method pro vlastnost . Method Nastavení vlastnosti na jakoukoli jinou ArgumentException hodnotu způsobí výjimku.

Pokud nastavíte Method na UploadFile, musíte to udělat před voláním GetRequestStream metody . Volání těchto členů ve správném pořadí způsobí ProtocolViolationException výjimku při pokusu o získání streamu požadavku.

Přihlašovací údaje zadané pro FtpWebRequest objekt musí mít oprávnění k provedení zadané metody. Pokud ne, příkaz FTP selže.

Pokud chcete zjistit úspěch nebo selhání příkazu, zkontrolujte StatusCode vlastnosti a StatusDescription .

Viz také

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