FtpWebRequest.Method Egenskap

Definition

Hämtar eller anger kommandot som ska skickas till FTP-servern.

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

Egenskapsvärde

Ett String värde som innehåller FTP-kommandot som ska skickas till servern. Standardvärdet är DownloadFile.

Undantag

Ett nytt värde har angetts för den här egenskapen för en begäran som redan pågår.

Metoden är ogiltig.

-eller-

Metoden stöds inte.

-eller-

Flera metoder har angetts.

Exempel

I följande kodexempel anges den här egenskapen till 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;
}

Kommentarer

Egenskapen Method avgör vilket kommando som skickas till servern. Du anger genom att Method använda strängarna som definierats i klassens medlemmar i det WebRequestMethods.Ftp offentliga fältet. Observera att de strängar som definierats i WebRequestMethods.Ftp klassen är de enda alternativ som stöds för egenskapen Method . Om du anger egenskapen Method till ett annat värde resulterar det i ett ArgumentException undantag.

När du anger Method till UploadFilemåste du göra det innan du anropar GetRequestStream metoden. Om du inte anropar dessa medlemmar i rätt ordning uppstår ett ProtocolViolationException undantag när du försöker hämta begärandeströmmen.

De autentiseringsuppgifter som anges för FtpWebRequest objektet måste ha behörighet att utföra den angivna metoden. Annars misslyckas FTP-kommandot.

Kontrollera egenskaperna och StatusCode för att fastställa om ett kommando StatusDescription lyckades eller misslyckades.

Gäller för

Se även