FtpWebResponse Classe

Definição

Encapsula a resposta de um servidor do Protocolo de Transferência de Ficheiros (FTP) a um pedido.

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 seguinte exemplo de código envia um pedido para eliminar um ficheiro num servidor FTP e mostra a mensagem de estado da resposta do servidor ao pedido. Para exemplos adicionais, veja os membros das WebRequestMethods.Ftp classes e 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;
}

Observações

As instâncias de FtpWebResponse são obtidas ao chamar o GetResponse método. O objeto devolvido deve ser lançado para um FtpWebResponse. Quando a sua aplicação já não precisar do FtpWebResponse objeto, chame o Close método para libertar os recursos detidos pelo FtpWebResponse.

A StatusCode propriedade contém o código de estado devolvido pelo servidor, e a StatusDescription propriedade devolve o código de estado e uma mensagem que descreve o estado. Os valores devolvidos por estas propriedades mudam à medida que as mensagens são devolvidas pelo servidor.

Quaisquer dados devolvidos pelo pedido, como a lista de nomes de ficheiros devolvidos para um ListDirectory pedido, estão disponíveis no fluxo devolvido pelo GetResponseStream método. O comprimento dos dados do fluxo pode ser obtido a partir da ContentLength propriedade.

Propriedades

Name Description
BannerMessage

Recebe a mensagem enviada pelo servidor FTP quando uma ligação é estabelecida antes do início de sessão.

ContentLength

Obtém o comprimento dos dados recebidos do servidor FTP.

ContentType

Lança A NotImplementedException em todos os casos.

ContentType

Quando sobrescrito numa classe derivada, obtém ou define o tipo de conteúdo dos dados recebidos.

(Herdado de WebResponse)
ExitMessage

Recebe a mensagem enviada pelo servidor quando a sessão FTP está a terminar.

Headers

Fica com um objeto vazio WebHeaderCollection .

IsFromCache

Obtém um Boolean valor que indica se esta resposta foi obtida a partir da cache.

(Herdado de WebResponse)
IsMutuallyAuthenticated

Recebe um Boolean valor que indica se ocorreu autenticação mútua.

(Herdado de WebResponse)
LastModified

Obtém a data e hora em que um ficheiro num servidor FTP foi modificado pela última vez.

ResponseUri

Obtém o URI que enviou a resposta ao pedido.

StatusCode

Recebe o código de estado mais recente enviado pelo servidor FTP.

StatusDescription

Recebe texto que descreve um código de estado enviado pelo servidor FTP.

SupportsHeaders

Obtém um valor que indica se a Headers propriedade é suportada pela FtpWebResponse instância.

WelcomeMessage

Recebe a mensagem enviada pelo servidor FTP quando a autenticação está concluída.

Métodos

Name Description
Close()

Liberta os recursos detidos pela resposta.

CreateObjRef(Type)

Cria um objeto que contém toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto.

(Herdado de MarshalByRefObject)
Dispose()

Liberta os recursos não geridos usados pelo WebResponse objeto.

(Herdado de WebResponse)
Dispose(Boolean)

Liberta os recursos não geridos usados pelo WebResponse objeto e, opcionalmente, elimina os recursos geridos.

(Herdado de WebResponse)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso.

(Herdado de MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext)

Preenche a SerializationInfo com os dados necessários para serializar o objeto alvo.

(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()

Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso.

(Herdado de MarshalByRefObject)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto atual MarshalByRefObject .

(Herdado de MarshalByRefObject)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Implementações de Interface Explícita

Name Description
IDisposable.Dispose()

Quando sobrescrito numa classe derivada, liberta todos os recursos usados pelo WebResponse.

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

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

(Herdado de WebResponse)

Aplica-se a

Ver também