FtpWebResponse Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Инкапсулирует ответ 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-сервере и отображается сообщение о состоянии из ответа сервера на запрос. Дополнительные примеры см. в разделе члены WebRequestMethods.Ftp классов и FtpWebRequest .
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) |
Устаревшие..
Заполняет экземпляр SerializationInfo данными, необходимыми для сериализации экземпляра WebResponse. (Унаследовано от WebResponse) |