FtpWebResponse Classe

Definição

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 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
Herança
Implementações

Exemplos

O exemplo de código a seguir envia uma solicitação para excluir um arquivo em um servidor FTP e exibe a mensagem 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 status retornado pelo servidor e a StatusDescription propriedade retorna o código status e uma mensagem que descreve o status. Os valores retornados por essas propriedades mudam 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

Gera um NotImplementedException em todos os casos.

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.

SupportsHeaders

Obtém um valor que indica se os cabeçalhos têm suporte.

(Herdado de WebResponse)
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

IDisposable.Dispose()

Quando substituído em uma classe derivada, libera todos os recursos usados pela WebResponse.

(Herdado de WebResponse)
ISerializable.GetObjectData(SerializationInfo, StreamingContext)
Obsoleto.

Preenche uma instância SerializationInfo com os dados necessários para serializar WebResponse.

(Herdado de WebResponse)

Aplica-se a

Confira também