FtpWebResponse Classe

Définition

Espace de noms:

System.Net

Assembly:

System.Net.Requests.dll

Source:

FtpWebResponse.cs

Encapsule la réponse d'un serveur FTP (File Transfer Protocol) à une demande.

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

Héritage

Object

MarshalByRefObject

WebResponse

FtpWebResponse

Implémente

IDisposable

Exemples

L’exemple de code suivant envoie une demande de suppression d’un fichier sur un serveur FTP et affiche le message d’état de la réponse du serveur à la demande. Pour obtenir d’autres exemples, consultez les membres des WebRequestMethods.Ftp classes et 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;
}

Remarques

Les instances de FtpWebResponse sont obtenues en appelant la GetResponse méthode . L’objet retourné doit être casté en FtpWebResponse. Lorsque votre application n’a plus besoin de l’objetFtpWebResponse, appelez la Close méthode pour libérer les ressources détenues par .FtpWebResponse

La StatusCode propriété contient le code d’état retourné par le serveur, et la StatusDescription propriété retourne le code d’état et un message qui décrit l’état. Les valeurs retournées par ces propriétés changent à mesure que les messages sont retournés par le serveur.

Toutes les données retournées par la requête, telles que la liste des noms de fichiers retournés pour une ListDirectory demande, sont disponibles dans le flux retourné par la GetResponseStream méthode. La longueur des données de flux peut être obtenue à partir de la ContentLength propriété .

Propriétés

BannerMessage	Obtient le message envoyé par le serveur FTP lorsqu'une connexion est établie avant l'ouverture de session.
ContentLength	Obtient la longueur des données reçues du serveur FTP.
ContentType	En cas de substitution dans une classe dérivée, obtient ou définit le type de contenu des données reçues. (Hérité de WebResponse)
ExitMessage	Obtient le message envoyé par le serveur lorsque la session FTP se termine.
Headers	Obtient un objet WebHeaderCollection vide.
IsFromCache	Obtient une valeur Boolean qui indique si cette réponse a été extraite du cache. (Hérité de WebResponse)
IsMutuallyAuthenticated	Obtient une valeur Boolean indiquant si l'authentification mutuelle s'est produite. (Hérité de WebResponse)
LastModified	Obtient la date et l’heure de dernière modification d’un fichier figurant sur un serveur FTP.
ResponseUri	Obtient l'URI qui a envoyé la réponse à la demande.
StatusCode	Obtient le code d'état le plus récent envoyé à partir du serveur FTP.
StatusDescription	Obtient du texte qui décrit un code d'état envoyé à partir du serveur FTP.
SupportsHeaders	Obtient une valeur qui indique si la propriété Headers est prise en charge par l'instance FtpWebResponse.
WelcomeMessage	Obtient le message envoyé par le serveur FTP lorsque l'authentification est terminée.

Méthodes

Close()	Libère les ressources détenues par la réponse.
CreateObjRef(Type)	Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant. (Hérité de MarshalByRefObject)
Dispose()	Libère les ressources non managées utilisées par l’objet WebResponse. (Hérité de WebResponse)
Dispose(Boolean)	Libère les ressources non managées utilisées par l’objet WebResponse et supprime éventuellement les ressources managées. (Hérité de WebResponse)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetLifetimeService()	Obsolète. Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext)	Obsolète. Remplit SerializationInfo avec les données qui sont nécessaires pour sérialiser l'objet cible. (Hérité de WebResponse)
GetResponseStream()	Récupère le flux qui contient des données de réponse envoyées à partir d'un serveur FTP.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
InitializeLifetimeService()	Obsolète. Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Obsolète. Remplit une instance de SerializationInfo avec les données nécessaires pour sérialiser WebResponse. (Hérité de WebResponse)

Voir aussi

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