FtpWebResponse Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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) |