FtpWebResponse Classe

Définition

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

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
Héritage
Implémente

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

Lève une exception NotImplementedException dans tous les cas.

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.

SupportsHeaders

Obtient une valeur qui indique si les en-têtes sont pris en charge.

(Hérité de WebResponse)
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

IDisposable.Dispose()

En cas de substitution dans une classe dérivée, libère toutes les ressources utilisées par WebResponse.

(Hérité de WebResponse)
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)

S’applique à

Voir aussi