FtpWebResponse 类

定义

命名空间:

System.Net

程序集:

System.Net.Requests.dll

Source:

FtpWebResponse.cs

封装文件传输协议 (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;
}

注解

通过调用 GetResponse 方法获取 的FtpWebResponse实例。 返回的对象必须强制转换为 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)	创建一个对象，该对象包含生成用于与远程对象进行通信的代理所需的全部相关信息。 (继承自 MarshalByRefObject)
Dispose()	释放 WebResponse 对象使用的非托管资源。 (继承自 WebResponse)
Dispose(Boolean)	释放由 WebResponse 对象使用的非托管资源，并可根据需要释放托管资源。 (继承自 WebResponse)
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetLifetimeService()	已过时. 检索控制此实例的生存期策略的当前生存期服务对象。 (继承自 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