Udostępnij za pośrednictwem


FtpWebRequest.Method Właściwość

Definicja

Pobiera lub ustawia polecenie do wysyłania do serwera 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

Wartość właściwości

Wartość zawierająca String polecenie FTP do wysłania na serwer. Domyślna wartość to DownloadFile.

Wyjątki

Dla tej właściwości określono nową wartość dla żądania, które jest już w toku.

Metoda jest nieprawidłowa.

— lub —

Metoda nie jest obsługiwana.

— lub —

Określono wiele metod.

Przykłady

Poniższy przykład kodu ustawia tę właściwość na DeleteFilewartość .

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;
}

Uwagi

Właściwość Method określa, które polecenie jest wysyłane do serwera. Element można ustawić Method przy użyciu ciągów zdefiniowanych w elementach członkowskich WebRequestMethods.Ftp pola publicznego klasy. Należy pamiętać, że ciągi zdefiniowane w WebRequestMethods.Ftp klasie są jedynymi obsługiwanymi opcjami dla Method właściwości . Method Ustawienie właściwości na dowolną inną ArgumentException wartość spowoduje wyjątek.

Podczas ustawiania MethodUploadFilewartości należy to zrobić przed wywołaniem GetRequestStream metody . Błąd wywołania tych elementów członkowskich w prawidłowej kolejności powoduje ProtocolViolationException wyjątek podczas próby pobrania strumienia żądania.

Poświadczenia podane dla FtpWebRequest obiektu muszą mieć uprawnienia do wykonywania określonej metody. Jeśli nie, polecenie FTP zakończy się niepowodzeniem.

Aby określić powodzenie lub niepowodzenie polecenia, sprawdź StatusCode właściwości i StatusDescription .

Dotyczy

Zobacz też