FtpWebResponse FtpWebResponse FtpWebResponse FtpWebResponse Class

Definición

Encapsula la respuesta de un servidor de Protocolo de transferencia de archivos (FTP) a una solicitud. Encapsulates a File Transfer Protocol (FTP) server's response to a request.

public ref class FtpWebResponse : System::Net::WebResponse
public class FtpWebResponse : System.Net.WebResponse
type FtpWebResponse = class
    inherit WebResponse
Public Class FtpWebResponse
Inherits WebResponse
Herencia

Ejemplos

El siguiente ejemplo de código envía una solicitud para eliminar un archivo en un servidor FTP y muestra el mensaje de estado de la respuesta del servidor a la solicitud.The following code example sends a request to delete a file on an FTP server and displays the status message from the server's response to the request. Para obtener ejemplos adicionales, vea los miembros de la WebRequestMethods.Ftp y FtpWebRequest clases.For additional examples, see the members of the WebRequestMethods.Ftp and FtpWebRequest classes.

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 a la GetResponse método.Instances of FtpWebResponse are obtained by calling the GetResponse method. El objeto devuelto debe convertirse en un FtpWebResponse.The returned object must be cast to an FtpWebResponse. Cuando la aplicación ya no necesita la FtpWebResponse de objeto, llame a la Close método para liberar los recursos mantenidos por el FtpWebResponse.When your application no longer needs the FtpWebResponse object, call the Close method to free the resources held by the FtpWebResponse.

El StatusCode propiedad contiene el código de estado devuelto por el servidor y el StatusDescription propiedad devuelve el código de estado y un mensaje que describe el estado.The StatusCode property contains the status code returned by the server, and the StatusDescription property returns the status code and a message that describes the status. Los valores devueltos por estas propiedades cambiarán los mensajes se devuelven por el servidor.The values returned by these properties change as the messages are returned by the server.

Los datos devueltos por la solicitud, como la lista de nombres de archivo devueltos para un ListDirectory solicitar, está disponible en la secuencia devuelta por la GetResponseStream método.Any data returned by the request, such as the list of file names returned for a ListDirectory request, is available in the stream returned by the GetResponseStream method. La longitud de los datos de streaming puede obtenerse a partir del ContentLength propiedad.The length of the stream data can be obtained from the ContentLength property.

Propiedades

BannerMessage BannerMessage BannerMessage BannerMessage

Obtiene el mensaje enviado por el servidor FTP cuando se establece una conexión antes del inicio de sesión. Gets the message sent by the FTP server when a connection is established prior to logon.

ContentLength ContentLength ContentLength ContentLength

Obtiene la longitud de los datos recibidos del servidor FTP. Gets the length of the data received from the FTP server.

ContentType ContentType ContentType ContentType
ExitMessage ExitMessage ExitMessage ExitMessage

Obtiene el mensaje enviado por el servidor cuando la sesión de FTP está finalizando. Gets the message sent by the server when the FTP session is ending.

Headers Headers Headers Headers

Obtiene un objeto WebHeaderCollection vacío. Gets an empty WebHeaderCollection object.

IsFromCache IsFromCache IsFromCache IsFromCache

Obtiene un valor Boolean que indica si esta respuesta se obtuvo de la caché. Gets a Boolean value that indicates whether this response was obtained from the cache.

(Inherited from WebResponse)
IsMutuallyAuthenticated IsMutuallyAuthenticated IsMutuallyAuthenticated IsMutuallyAuthenticated

Obtiene un valor Boolean que indica si ocurrió una autenticación mutua. Gets a Boolean value that indicates whether mutual authentication occurred.

(Inherited from WebResponse)
LastModified LastModified LastModified LastModified

Obtiene la fecha y hora en que se modificó por última vez un archivo en un servidor FTP. Gets the date and time that a file on an FTP server was last modified.

ResponseUri ResponseUri ResponseUri ResponseUri

Obtiene el identificador URI que envió la respuesta a la solicitud. Gets the URI that sent the response to the request.

StatusCode StatusCode StatusCode StatusCode

Obtiene el código de estado más reciente que se ha enviado desde el servidor FTP. Gets the most recent status code sent from the FTP server.

StatusDescription StatusDescription StatusDescription StatusDescription

Obtiene texto que describe un código de estado enviado desde el servidor FTP. Gets text that describes a status code sent from the FTP server.

SupportsHeaders SupportsHeaders SupportsHeaders SupportsHeaders

Obtiene un valor que indica si la instancia Headers admite la propiedad FtpWebResponse. Gets a value that indicates whether the Headers property is supported by the FtpWebResponse instance.

WelcomeMessage WelcomeMessage WelcomeMessage WelcomeMessage

Obtiene el mensaje enviado por el servidor FTP cuando la autenticación ha finalizado. Gets the message sent by the FTP server when authentication is complete.

Métodos

Close() Close() Close() Close()

Libera los recursos mantenidos por la respuesta. Frees the resources held by the response.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Libera los recursos no administrados que usa el objeto WebResponse. Releases the unmanaged resources used by the WebResponse object.

(Inherited from WebResponse)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libera los recursos no administrados que usa el objeto WebResponse y, de forma opcional, desecha los recursos administrados. Releases the unmanaged resources used by the WebResponse object, and optionally disposes of the managed resources.

(Inherited from WebResponse)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual. Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada. Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

Llena SerializationInfo con los datos necesarios para serializar el objeto de destino. Populates a SerializationInfo with the data that is needed to serialize the target object.

(Inherited from WebResponse)
GetResponseStream() GetResponseStream() GetResponseStream() GetResponseStream()

Recupera la secuencia que contiene los datos de respuesta enviados desde un servidor FTP. Retrieves the stream that contains response data sent from an FTP server.

GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual. Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del Object actual. Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual. Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual. Returns a string that represents the current object.

(Inherited from Object)

Implementaciones de interfaz explícitas

IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose()

Cuando se reemplaza en una clase derivada, libera todos los recursos usados por WebResponse. When overridden in a derived class, releases all resources used by the WebResponse.

(Inherited from WebResponse)
ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Rellena una instancia de SerializationInfo con los datos necesarios para serializar el objeto WebResponse. Populates a SerializationInfo instance with the data that is needed to serialize WebResponse.

(Inherited from WebResponse)

Se aplica a

Consultar también