FtpWebResponse Classe

Definição

Namespace:

System.Net

Assembly:

System.Net.Requests.dll

Origem:

FtpWebResponse.cs

Encapsula a resposta de um servidor FTP (protocolo de transferência de arquivos) a uma solicitação.

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

Herança

Object

MarshalByRefObject

WebResponse

FtpWebResponse

Implementações

IDisposable

Exemplos

O exemplo de código a seguir envia uma solicitação para excluir um arquivo em um servidor FTP e exibe a mensagem de status da resposta do servidor à solicitação. Para obter exemplos adicionais, consulte os membros das WebRequestMethods.Ftp classes e 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;
}

Comentários

As instâncias de FtpWebResponse são obtidas chamando o GetResponse método . O objeto retornado deve ser convertido em um FtpWebResponse. Quando o aplicativo não precisar mais do FtpWebResponse objeto, chame o Close método para liberar os recursos mantidos pelo FtpWebResponse.

A StatusCode propriedade contém o código de status retornado pelo servidor e a StatusDescription propriedade retorna o código de status e uma mensagem que descreve o status. Os valores retornados por essas propriedades são alterados conforme as mensagens são retornadas pelo servidor.

Todos os dados retornados pela solicitação, como a lista de nomes de arquivo retornados para uma ListDirectory solicitação, estão disponíveis no fluxo retornado pelo GetResponseStream método . O comprimento dos dados de fluxo pode ser obtido da ContentLength propriedade .

Propriedades

BannerMessage	Obtém a mensagem enviada pelo servidor FTP quando uma conexão é estabelecida antes do logon.
ContentLength	Obtém o tamanho dos dados recebidos do servidor FTP.
ContentType	Quando substituído em uma classe derivada, obtém ou define o tipo de conteúdo dos dados que estão sendo recebidos. (Herdado de WebResponse)
ExitMessage	Obtém a mensagem enviada pelo servidor quando a sessão FTP está terminando.
Headers	Obtém um objeto WebHeaderCollection vazio.
IsFromCache	Obtém um valor Boolean que indica se essa resposta foi obtida do cache. (Herdado de WebResponse)
IsMutuallyAuthenticated	Obtém um valor Boolean que indica se ocorreu uma autenticação mútua. (Herdado de WebResponse)
LastModified	Obtém a data e hora em que um arquivo em um servidor FTP foi modificado pela última vez.
ResponseUri	Obtém o URI que enviou a resposta à solicitação.
StatusCode	Obtém o código de status mais recente enviado do servidor FTP.
StatusDescription	Obtém o texto que descreve um código de status enviado do servidor FTP.
SupportsHeaders	Obtém um valor que indica se a propriedade Headers tem suporte pela instância de FtpWebResponse.
WelcomeMessage	Obtém a mensagem enviada pelo servidor FTP quando a autenticação é concluída.

Métodos

Close()	Libera os recursos mantidos pela resposta.
CreateObjRef(Type)	Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
Dispose()	Libera os recursos não gerenciados usados pelo objeto WebResponse. (Herdado de WebResponse)
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo objeto WebResponse e, opcionalmente, libera os recursos gerenciados. (Herdado de WebResponse)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetLifetimeService()	Obsoleto. Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext)	Obsoleto. Preenche um SerializationInfo com os dados necessários para serializar o objeto de destino. (Herdado de WebResponse)
GetResponseStream()	Recupera o fluxo que contém os dados de resposta enviados de um servidor FTP.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InitializeLifetimeService()	Obsoleto. Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Implantações explícitas de interface

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Obsoleto. Preenche uma instância SerializationInfo com os dados necessários para serializar WebResponse. (Herdado de WebResponse)

Confira também

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