FtpWebRequest.Method 屬性
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
取得或設定要傳送至 FTP 伺服器的命令。
public:
virtual property System::String ^ Method { System::String ^ get(); void set(System::String ^ value); };C#
public override string Method { get; set; }member this.Method : string with get, setPublic Overrides Property Method As StringString 值，包含要傳送至伺服器的 FTP 命令。 預設值是 DownloadFile。
由於已經在進行的要求，已為這個屬性指定新的值。
下列程式代碼範例會將這個屬性設定為 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;
}
C#
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;
}
屬性 Method 會決定要傳送至伺服器的命令。 您可以使用 類別的WebRequestMethods.Ftp公用欄位成員中定義的字串來設定 Method 。 請注意，類別中 WebRequestMethods.Ftp 定義的字串是唯一支援的屬性選項 Method 。 將 Method 屬性設定為任何其他值將會導致 ArgumentException 例外狀況。
將 設定 Method 為 UploadFile時，您必須先這麼做， GetRequestStream 才能呼叫 方法。 當您嘗試取得要求數據流時，無法以正確的順序呼叫這些成員會造成 ProtocolViolationException 例外狀況。
為 FtpWebRequest 物件提供的認證必須具有執行指定方法的許可權。 如果沒有，FTP 命令會失敗。
若要判斷命令的成功或失敗，請檢查 StatusCode 和 StatusDescription 屬性。
| 產品 | 版本 |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
