FtpWebRequest.Method Właściwość

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.Requests.dll

Źródło:

FtpWebRequest.cs

Pobiera lub ustawia polecenie do wysłania na serwer 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

String

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

Wyjątki

InvalidOperationException

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

ArgumentException

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ść .

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

Uwagi

Właściwość Method określa, które polecenie jest wysyłane do serwera. Method Ustawiana jest wartość 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 właściwości Method . Method Ustawienie właściwości na dowolną inną ArgumentException wartość spowoduje wyjątek.

W przypadku ustawienia na MethodUploadFilewartość 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 .

Zobacz też

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