FtpWebResponse Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Incapsula la risposta di un server FTP (File Transfer Protocol) a una richiesta.
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
- Ereditarietà
- Implementazioni
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 .
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 ha più bisogno dell'oggetto FtpWebResponse , chiamare il Close metodo per liberare le risorse contenute in 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 di 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à
| Nome | Descrizione |
|---|---|
| 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 |
Genera un oggetto NotImplementedException in tutti i casi. |
| ContentType |
In caso di override in una classe derivata, ottiene o imposta il tipo di contenuto dei dati ricevuti. (Ereditato da WebResponse) |
| ExitMessage |
Ottiene il messaggio inviato dal server al termine della sessione FTP. |
| Headers |
Ottiene un oggetto vuoto WebHeaderCollection . |
| IsFromCache |
Ottiene un Boolean valore che indica se questa risposta è stata ottenuta dalla cache. (Ereditato da WebResponse) |
| IsMutuallyAuthenticated |
Ottiene un Boolean valore che indica se si è verificata 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 un codice di stato inviato dal server FTP. |
| SupportsHeaders |
Ottiene un valore che indica se la Headers proprietà è supportata dall'istanza FtpWebResponse di . |
| WelcomeMessage |
Ottiene il messaggio inviato dal server FTP al termine dell'autenticazione. |
Metodi
| Nome | Descrizione |
|---|---|
| Close() |
Libera le risorse contenute nella risposta. |
| CreateObjRef(Type) |
Crea un oggetto che contiene tutte le informazioni pertinenti necessarie per generare un proxy utilizzato per comunicare 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 e, facoltativamente, 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.
Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa 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 di risposta inviati da un server FTP. |
| GetType() |
Ottiene il 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 del Objectcorrente. (Ereditato da Object) |
| MemberwiseClone(Boolean) |
Crea una copia superficiale dell'oggetto corrente MarshalByRefObject . (Ereditato da MarshalByRefObject) |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| IDisposable.Dispose() |
In caso di override in una classe derivata, rilascia tutte le risorse usate da WebResponse. (Ereditato da WebResponse) |
| ISerializable.GetObjectData(SerializationInfo, StreamingContext) |
Obsoleti.
Popola un'istanza SerializationInfo con i dati necessari per serializzare WebResponse. (Ereditato da WebResponse) |