FtpWebRequest.Method Vlastnost

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.Requests.dll

Zdroj:

FtpWebRequest.cs

Získá nebo nastaví příkaz odeslat 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 vlastnosti. Method Nastavením vlastnosti na jakoukoli jinou hodnotu dojde k výjimceArgumentException.

Pokud nastavíte Method na UploadFile, musíte to udělat před voláním GetRequestStream metody. Selhání 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