FtpWebRequest.Method Properti

Referensi

Definisi

Ruang nama:: System.Net

Rakitan:: System.Net.Requests.dll

Rakitan:: System.dll

Rakitan:: netstandard.dll

Sumber:: FtpWebRequest.cs

Sumber:: FtpWebRequest.cs

Sumber:: FtpWebRequest.cs

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mendapatkan atau mengatur perintah untuk dikirim ke 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

Nilai Properti

String

Nilai String yang berisi perintah FTP untuk dikirim ke server. Nilai defaultnya adalah DownloadFile.

Pengecualian

InvalidOperationException

Nilai baru ditentukan untuk properti ini untuk permintaan yang sudah berlangsung.

ArgumentException

Metode ini tidak valid.

-atau-

Metode ini tidak didukung.

-atau-

Beberapa metode ditentukan.

Contoh

Contoh kode berikut mengatur properti ini ke 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;
}

Keterangan

Properti Method menentukan perintah mana yang dikirim ke server. Anda mengatur Method dengan menggunakan string yang ditentukan dalam anggota bidang publik kelas WebRequestMethods.Ftp . Perhatikan bahwa string yang ditentukan di WebRequestMethods.Ftp kelas adalah satu-satunya opsi yang Method didukung untuk properti . Method Mengatur properti ke nilai lain akan menghasilkan ArgumentException pengecualian.

Saat mengatur Method ke UploadFile, Anda harus melakukannya sebelum memanggil GetRequestStream metode . Kegagalan untuk memanggil anggota ini dalam urutan yang ProtocolViolationException benar menyebabkan pengecualian saat Anda mencoba mendapatkan aliran permintaan.

Kredensial yang disediakan untuk FtpWebRequest objek harus memiliki izin untuk melakukan metode yang ditentukan. Jika tidak, perintah FTP gagal.

Untuk menentukan keberhasilan atau kegagalan perintah, periksa StatusCode properti dan StatusDescription .

Berlaku untuk

Bagikan melalui