FtpWebResponse Класс

Определение

Пространство имен:

System.Net

Сборка:

System.Net.Requests.dll

Инкапсулирует ответ 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-сервере и отображается сообщение о состоянии из ответа сервера на запрос. Дополнительные примеры см. в разделе Члены 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	При переопределении производного класса возвращает или задает тип содержимого принимаемых данных. (Унаследовано от 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)

Устаревшие.. Заполняет экземпляр SerializationInfo данными, необходимыми для сериализации экземпляра WebResponse. (Унаследовано от WebResponse)

См. также раздел

• FtpWebRequest
• FtpStatusCode
• WebRequestMethods.Ftp
• WebRequest
• WebResponse
• WebClient