FtpWebResponse 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
封装文件传输协议 (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) |
创建一个对象,该对象包含生成用于与远程对象进行通信的代理所需的全部相关信息。 (继承自 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) |
显式接口实现
IDisposable.Dispose() |
当在派生类中被重写时,释放 WebResponse 使用的所有资源。 (继承自 WebResponse) |
ISerializable.GetObjectData(SerializationInfo, StreamingContext) |
已过时.
使用序列化 WebResponse 所需的数据来填充 SerializationInfo 实例。 (继承自 WebResponse) |
适用于
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈