FtpWebResponse Classe

Definizione

Spazio dei nomi:

System.Net

Assembly:

System.Net.Requests.dll

Origine:

FtpWebResponse.cs

Inserisce una risposta del server FTP (File Transfer Protocol) a una richiesta.

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

Ereditarietà

Object

MarshalByRefObject

WebResponse

FtpWebResponse

Implementazioni

IDisposable

Esempio

Nell'esempio di codice seguente viene inviata una richiesta di eliminazione di un file in un server FTP e viene visualizzato il messaggio di stato dalla risposta del server alla richiesta. Per altri esempi, vedere i membri delle WebRequestMethods.Ftp classi e 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;
}

Commenti

Le istanze di FtpWebResponse vengono ottenute chiamando il GetResponse metodo . L'oggetto restituito deve essere sottoposto a cast a un oggetto FtpWebResponse. Quando l'applicazione non richiede più l'oggetto FtpWebResponse , chiamare il Close metodo per liberare le risorse contenute da FtpWebResponse.

La StatusCode proprietà contiene il codice di stato restituito dal server e la StatusDescription proprietà restituisce il codice di stato e un messaggio che descrive lo stato. I valori restituiti da queste proprietà cambiano man mano che i messaggi vengono restituiti dal server.

Tutti i dati restituiti dalla richiesta, ad esempio l'elenco dei nomi di file restituiti per una ListDirectory richiesta, sono disponibili nel flusso restituito dal GetResponseStream metodo . La lunghezza dei dati del flusso può essere ottenuta dalla ContentLength proprietà .

Proprietà

BannerMessage	Ottiene il messaggio inviato dal server FTP quando viene stabilita una connessione prima dell'accesso.
ContentLength	Ottiene la lunghezza dei dati ricevuti dal server FTP.
ContentType	Quando ne viene eseguito l'override in una classe derivata, ottiene o imposta il tipo del contenuto dei dati ricevuti. (Ereditato da WebResponse)
ExitMessage	Ottiene il messaggio inviato dal server al termine della sessione FTP.
Headers	Ottiene un oggetto WebHeaderCollection vuoto.
IsFromCache	Ottiene un valore Boolean che indica se questa risposta è stata ottenuta dalla memoria cache. (Ereditato da WebResponse)
IsMutuallyAuthenticated	Ottiene un valore Boolean che indica se è stata effettuata l'autenticazione reciproca. (Ereditato da WebResponse)
LastModified	Ottiene la data e l'ora dell'ultima modifica di un file in un server FTP.
ResponseUri	Ottiene l'URI che ha inviato la risposta alla richiesta.
StatusCode	Ottiene il codice di stato più recente inviato dal server FTP.
StatusDescription	Ottiene il testo che descrive il codice di stato inviato dal server FTP.
SupportsHeaders	Ottiene un valore che indica se la proprietà Headers è supportata dall'istanza di FtpWebResponse.
WelcomeMessage	Ottiene il messaggio inviato dal server FTP al termine dell'autenticazione.

Metodi

Close()	Libera le risorse utilizzate dalla risposta.
CreateObjRef(Type)	Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto. (Ereditato da MarshalByRefObject)
Dispose()	Rilascia le risorse non gestite usate dall'oggetto WebResponse. (Ereditato da WebResponse)
Dispose(Boolean)	Rilascia le risorse non gestite usate dall'oggetto WebResponse ed eventualmente elimina le risorse gestite. (Ereditato da WebResponse)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetLifetimeService()	Obsoleti. Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext)	Obsoleti. Popola un oggetto SerializationInfo con i dati necessari per serializzare l'oggetto di destinazione. (Ereditato da WebResponse)
GetResponseStream()	Recupera il flusso che contiene i dati della risposta inviati dal server FTP.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
InitializeLifetimeService()	Obsoleti. Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Implementazioni dell'interfaccia esplicita

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Obsoleti. Popola un'istanza di SerializationInfo con i dati necessari per serializzare WebResponse. (Ereditato da WebResponse)

Vedi anche

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