FtpWebResponse 類別

定義

命名空間:

System.Net

組件:

System.Net.Requests.dll

來源:

FtpWebResponse.cs

封裝檔案傳輸通訊協定 (File Transfer Protocol，FTP) 伺服器對要求的回應。

public ref class FtpWebResponse : System::Net::WebResponse, IDisposable

public class FtpWebResponse : System.Net.WebResponse, IDisposable

type FtpWebResponse = class
    inherit WebResponse
    interface IDisposable

Public Class FtpWebResponse
Inherits WebResponse
Implements IDisposable

繼承

Object

MarshalByRefObject

WebResponse

FtpWebResponse

實作

IDisposable

範例

下列程式代碼範例會傳送要求來刪除 FTP 伺服器上的檔案，並顯示來自伺服器回應要求的狀態消息。 如需其他範例，請參閱 和 FtpWebRequest 類別的成員WebRequestMethods.Ftp。

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

備註

的 FtpWebResponse 實例是藉由呼叫 GetResponse 方法來取得。 傳回的物件必須轉換成 FtpWebResponse。 當您的應用程式不再需要 FtpWebResponse 物件時，請呼叫 Close 方法來釋放 所 FtpWebResponse保留的資源。

屬性 StatusCode 包含伺服器傳回的狀態代碼，而 StatusDescription 屬性會傳回狀態代碼和描述狀態的訊息。 當伺服器傳回訊息時，這些屬性所傳回的值會變更。

要求所傳回的任何數據，例如針對 ListDirectory 要求傳回的檔名清單，都可以在方法傳回的 GetResponseStream 數據流中使用。 數據流數據的長度可以從 屬性取得 ContentLength 。

屬性

BannerMessage	取得連接在登入之前建立時 FTP 伺服器所傳送的訊息。
ContentLength	取得從 FTP 伺服器接收之資料的長度。
ContentType	在衍生類別中覆寫時，取得或設定正在接收資料的內容類型。 (繼承來源 WebResponse)
ExitMessage	取得 FTP 工作階段結束時伺服器所傳送的訊息。
Headers	取得空的 WebHeaderCollection 物件。
IsFromCache	取得 Boolean 值，指出這個回應是否從快取中取得。 (繼承來源 WebResponse)
IsMutuallyAuthenticated	取得 Boolean 值，指出是否發生過相互驗證。 (繼承來源 WebResponse)
LastModified	取得 FTP 伺服器上之檔案的上次修改日期和時間。
ResponseUri	取得傳送對要求之回應的 URI。
StatusCode	取得從 FTP 伺服器傳送的最新狀態碼。
StatusDescription	取得描述從 FTP 伺服器傳送之狀態碼的文字。
SupportsHeaders	取得值，這個值表示 Headers 執行個體是否支援 FtpWebResponse 屬性。
WelcomeMessage	取得驗證完成時 FTP 伺服器所傳送的訊息。

方法

Close()	釋放回應所持有的資源。
CreateObjRef(Type)	建立包含所有相關資訊的物件，這些資訊是產生用來與遠端物件通訊的所需 Proxy。 (繼承來源 MarshalByRefObject)
Dispose()	釋放由 WebResponse 物件使用的 Unmanaged 資源。 (繼承來源 WebResponse)
Dispose(Boolean)	釋放 WebResponse 物件所使用的 Unmanaged 資源，並選擇性處置 Managed 資源。 (繼承來源 WebResponse)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetLifetimeService()	已淘汰. 擷取控制這個執行個體存留期 (Lifetime) 原則的目前存留期服務物件。 (繼承來源 MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext)	已淘汰. 將序列化目標物件所需的資料填入 SerializationInfo。 (繼承來源 WebResponse)
GetResponseStream()	擷取包含從 FTP 伺服器傳送之回應資料的資料流。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
InitializeLifetimeService()	已淘汰. 取得存留期服務物件，以控制這個執行個體的存留期原則。 (繼承來源 MarshalByRefObject)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
MemberwiseClone(Boolean)	建立目前 MarshalByRefObject 物件的淺層複本。 (繼承來源 MarshalByRefObject)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

明確介面實作

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

已淘汰. 以序列化 WebResponse 所需的資料填入 SerializationInfo 執行個體。 (繼承來源 WebResponse)

另請參閱

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