FtpWebResponse Clase

Definición

Encapsula la respuesta de un servidor de Protocolo de transferencia de archivos (FTP) a una solicitud.

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
Herencia
Implementaciones

Ejemplos

En el ejemplo de código siguiente se envía una solicitud para eliminar un archivo en un servidor FTP y se muestra el mensaje de estado de la respuesta del servidor a la solicitud. Para obtener ejemplos adicionales, vea los miembros de las WebRequestMethods.Ftp clases y 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;
}

Comentarios

Las instancias de FtpWebResponse se obtienen mediante una llamada al GetResponse método . El objeto devuelto debe convertirse en .FtpWebResponse Cuando la aplicación ya no necesite el FtpWebResponse objeto , llame al Close método para liberar los recursos mantenidos por .FtpWebResponse

La StatusCode propiedad contiene el código de estado devuelto por el servidor y la StatusDescription propiedad devuelve el código de estado y un mensaje que describe el estado. Los valores devueltos por estas propiedades cambian a medida que el servidor devuelve los mensajes.

Los datos devueltos por la solicitud, como la lista de nombres de archivo devueltos para una ListDirectory solicitud, están disponibles en la secuencia devuelta por el GetResponseStream método . La longitud de los datos del flujo se puede obtener de la ContentLength propiedad .

Propiedades

BannerMessage

Obtiene el mensaje enviado por el servidor FTP cuando se establece una conexión antes del inicio de sesión.

ContentLength

Obtiene la longitud de los datos recibidos del servidor FTP.

ContentType

Devuelve NotImplementedException en todos los casos

ContentType

Cuando se realizan omisiones en una clase derivada, obtiene o establece el tipo de contenido de los datos recibidos.

(Heredado de WebResponse)
ExitMessage

Obtiene el mensaje enviado por el servidor cuando la sesión de FTP está finalizando.

Headers

Obtiene un objeto WebHeaderCollection vacío.

IsFromCache

Obtiene un valor Boolean que indica si esta respuesta se obtuvo de la caché.

(Heredado de WebResponse)
IsMutuallyAuthenticated

Obtiene un valor Boolean que indica si ocurrió una autenticación mutua.

(Heredado de WebResponse)
LastModified

Obtiene la fecha y hora en que se modificó por última vez un archivo en un servidor FTP.

ResponseUri

Obtiene el identificador URI que envió la respuesta a la solicitud.

StatusCode

Obtiene el código de estado más reciente que se ha enviado desde el servidor FTP.

StatusDescription

Obtiene texto que describe un código de estado enviado desde el servidor FTP.

SupportsHeaders

Obtiene un valor que indica si la instancia Headers admite la propiedad FtpWebResponse.

SupportsHeaders

Obtiene un valor que indica si se admiten encabezados.

(Heredado de WebResponse)
WelcomeMessage

Obtiene el mensaje enviado por el servidor FTP cuando la autenticación ha finalizado.

Métodos

Close()

Libera los recursos mantenidos por la respuesta.

CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto.

(Heredado de MarshalByRefObject)
Dispose()

Libera los recursos no administrados que usa el objeto WebResponse.

(Heredado de WebResponse)
Dispose(Boolean)

Libera los recursos no administrados que usa el objeto WebResponse y, de forma opcional, desecha los recursos administrados.

(Heredado de WebResponse)
Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetLifetimeService()
Obsoletos.

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.

(Heredado de MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext)
Obsoletos.

Llena SerializationInfo con los datos necesarios para serializar el objeto de destino.

(Heredado de WebResponse)
GetResponseStream()

Recupera la secuencia que contiene los datos de respuesta enviados desde un servidor FTP.

GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
InitializeLifetimeService()
Obsoletos.

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.

(Heredado de MarshalByRefObject)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.

(Heredado de MarshalByRefObject)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Implementaciones de interfaz explícitas

IDisposable.Dispose()

Cuando se reemplaza en una clase derivada, libera todos los recursos usados por WebResponse.

(Heredado de WebResponse)
ISerializable.GetObjectData(SerializationInfo, StreamingContext)
Obsoletos.

Rellena una instancia de SerializationInfo con los datos necesarios para serializar el objeto WebResponse.

(Heredado de WebResponse)

Se aplica a

Consulte también