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 классах.
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 . |
| 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) |