FtpWebRequest.Method Proprietà

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

Valore della proprietà

Valore String che contiene il comando FTP da inviare al server. Il valore predefinito è DownloadFile.

Eccezioni

Esempio

Nell'esempio di codice seguente questa proprietà viene impostata su 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;
}

Commenti

La Method proprietà determina quale comando viene inviato al server. L'oggetto Method viene impostato usando le stringhe definite nei membri del campo pubblico della WebRequestMethods.Ftp classe . Si noti che le stringhe definite nella WebRequestMethods.Ftp classe sono le uniche opzioni supportate per la Method proprietà . Se si imposta la Method proprietà su qualsiasi altro valore, verrà generata un'eccezione ArgumentException .

Quando si imposta su MethodUploadFile, è necessario eseguire questa operazione prima di chiamare il GetRequestStream metodo . Se non si chiamano questi membri nell'ordine corretto, viene generata un'eccezione ProtocolViolationException quando si tenta di ottenere il flusso di richiesta.

Le credenziali fornite per l'oggetto devono disporre dell'autorizzazione FtpWebRequest per eseguire il metodo specificato. In caso contrario, il comando FTP ha esito negativo.

Per determinare l'esito positivo o negativo di un comando, controllare le StatusCode proprietà e StatusDescription .

Vedi anche

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