FtpWebResponse 類別

定義

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

public ref class FtpWebResponse : System::Net::WebResponse, IDisposable
public ref class FtpWebResponse : System::Net::WebResponse
public class FtpWebResponse : System.Net.WebResponse, IDisposable
public class FtpWebResponse : System.Net.WebResponse
type FtpWebResponse = class
    inherit WebResponse
    interface IDisposable
Public Class FtpWebResponse
Inherits WebResponse
Implements IDisposable
Public Class FtpWebResponse
Inherits WebResponse
繼承
實作

範例

下列程式碼範例會傳送要求來刪除 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

在所有情況下都擲回 NotImplementedException

ContentType

在衍生類別中覆寫時,取得或設定正在接收資料的內容類型。

(繼承來源 WebResponse)
ExitMessage

取得 FTP 工作階段結束時伺服器所傳送的訊息。

Headers

取得空的 WebHeaderCollection 物件。

IsFromCache

取得 Boolean 值,指出這個回應是否從快取中取得。

(繼承來源 WebResponse)
IsMutuallyAuthenticated

取得 Boolean 值,指出是否發生過相互驗證。

(繼承來源 WebResponse)
LastModified

取得 FTP 伺服器上之檔案的上次修改日期和時間。

ResponseUri

取得傳送對要求之回應的 URI。

StatusCode

取得從 FTP 伺服器傳送的最新狀態碼。

StatusDescription

取得描述從 FTP 伺服器傳送之狀態碼的文字。

SupportsHeaders

取得值,這個值表示 Headers 執行個體是否支援 FtpWebResponse 屬性。

SupportsHeaders

取得指出是否支援標頭的值。

(繼承來源 WebResponse)
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)

明確介面實作

IDisposable.Dispose()

在衍生類別中覆寫時,釋放 WebResponse 使用的所有資源。

(繼承來源 WebResponse)
ISerializable.GetObjectData(SerializationInfo, StreamingContext)
已淘汰.

以序列化 WebResponse 所需的資料填入 SerializationInfo 執行個體。

(繼承來源 WebResponse)

適用於

另請參閱