FtpWebResponse Classe

Definição

Namespace:

System.Net

Assemblies:

netstandard.dll, System.Net.Requests.dll

Origem:

FtpWebResponse.cs

Encapsula a resposta de um servidor FTP (File Transfer Protocol) 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 classes e FtpWebRequest os WebRequestMethods.Ftp membros.

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 são FtpWebResponse 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

Nome	Description
BannerMessage	Obtém a mensagem enviada pelo servidor FTP quando uma conexão é estabelecida antes do logon.
ContentLength	Obtém o comprimento 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 recebidos. (Herdado de WebResponse)
ExitMessage	Obtém a mensagem enviada pelo servidor quando a sessão FTP está terminando.
Headers	Obtém um objeto vazio WebHeaderCollection .
IsFromCache	Obtém um Boolean valor que indica se essa resposta foi obtida do cache. (Herdado de WebResponse)
IsMutuallyAuthenticated	Obtém um Boolean valor que indica se a autenticação mútua ocorreu. (Herdado de WebResponse)
LastModified	Obtém a data e a 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 Headers propriedade tem suporte pela FtpWebResponse instância.
WelcomeMessage	Obtém a mensagem enviada pelo servidor FTP quando a autenticação é concluída.

Métodos

Nome	Description
Close()	Libera os recursos mantidos pela resposta.
Dispose()	Libera os recursos não gerenciados usados pelo WebResponse objeto. (Herdado de WebResponse)
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo WebResponse objeto e, opcionalmente, descarta 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 tempo de vida para essa instância. (Herdado de MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext)	Obsoleto. Popula um SerializationInfo com os dados necessários para serializar o objeto de destino. (Herdado de WebResponse)
GetResponseStream()	Recupera o fluxo que contém 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 dessa instância. (Herdado de MarshalByRefObject)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Implantações explícitas de interface

Nome	Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Obsoleto. Popula uma SerializationInfo instância com os dados necessários para serializar WebResponse. (Herdado de WebResponse)

Confira também

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