HttpWebResponse 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.
Fornisce un'implementazione specifica di HTTP della WebResponse classe .
public ref class HttpWebResponse : System::Net::WebResponse
public ref class HttpWebResponse : System::Net::WebResponse, System::Runtime::Serialization::ISerializable
public ref class HttpWebResponse : System::Net::WebResponse, IDisposable, System::Runtime::Serialization::ISerializable
public class HttpWebResponse : System.Net.WebResponse
public class HttpWebResponse : System.Net.WebResponse, System.Runtime.Serialization.ISerializable
[System.Serializable]
public class HttpWebResponse : System.Net.WebResponse, IDisposable, System.Runtime.Serialization.ISerializable
[System.Serializable]
public class HttpWebResponse : System.Net.WebResponse, System.Runtime.Serialization.ISerializable
type HttpWebResponse = class
inherit WebResponse
type HttpWebResponse = class
inherit WebResponse
interface ISerializable
[<System.Serializable>]
type HttpWebResponse = class
inherit WebResponse
interface ISerializable
interface IDisposable
[<System.Serializable>]
type HttpWebResponse = class
inherit WebResponse
interface ISerializable
Public Class HttpWebResponse
Inherits WebResponse
Public Class HttpWebResponse
Inherits WebResponse
Implements ISerializable
Public Class HttpWebResponse
Inherits WebResponse
Implements IDisposable, ISerializable
- Ereditarietà
- Ereditarietà
- Attributi
- Implementazioni
Esempio
Nell'esempio seguente viene restituito un oggetto HttpWebResponse da un oggetto HttpWebRequest.
HttpWebRequest HttpWReq =
(HttpWebRequest)WebRequest.Create("http://www.contoso.com");
HttpWebResponse HttpWResp = (HttpWebResponse)HttpWReq.GetResponse();
// Insert code that uses the response object.
HttpWResp.Close();
Dim HttpWReq As HttpWebRequest = _
CType(WebRequest.Create("http://www.contoso.com"), HttpWebRequest)
Dim HttpWResp As HttpWebResponse = _
CType(HttpWReq.GetResponse(), HttpWebResponse)
' Insert code that uses the response object.
HttpWResp.Close()
Commenti
Questa classe contiene il supporto per usi specifici di HTTP delle proprietà e dei metodi della WebResponse classe . La HttpWebResponse classe viene usata per compilare applicazioni client autonome HTTP che inviano richieste HTTP e ricevono risposte HTTP.
Annotazioni
Non confondere HttpWebResponse con la HttpResponse classe usata nelle applicazioni ASP.NET e i cui metodi e proprietà vengono esposti tramite ASP. Oggetto intrinseco Response di NET.
Non è mai consigliabile creare direttamente un'istanza della HttpWebResponse classe . Usare invece l'istanza restituita da una chiamata a HttpWebRequest.GetResponse. È necessario chiamare o il Stream.CloseHttpWebResponse.Close metodo per chiudere la risposta e rilasciare la connessione per il riutilizzo. Non è necessario chiamare sia Stream.Close e HttpWebResponse.Close, ma in questo modo non si verifica un errore.
Le informazioni di intestazione comuni restituite dalla risorsa Internet vengono esposte come proprietà della classe . Per un elenco completo, vedere la tabella seguente. Altre intestazioni possono essere lette dalla Headers proprietà come coppie nome/valore.
La tabella seguente illustra le intestazioni HTTP comuni disponibili tramite le proprietà della HttpWebResponse classe .
| Intestazione | Proprietà |
|---|---|
| Codifica contenuto | ContentEncoding |
| La lunghezza del contenuto | ContentLength |
| Tipo di contenuto | ContentType |
| Ultima Modifica | LastModified |
| Servidor | Server |
Il contenuto della risposta dalla risorsa Internet viene restituito come oggetto Stream chiamando il GetResponseStream metodo .
Costruttori
| Nome | Descrizione |
|---|---|
| HttpWebResponse() |
Obsoleti.
Obsoleti.
Obsoleti.
Obsoleti.
Inizializza una nuova istanza della classe HttpWebResponse. |
| HttpWebResponse(SerializationInfo, StreamingContext) |
Obsoleti.
Obsoleti.
Obsoleti.
Inizializza una nuova istanza della HttpWebResponse classe dalle istanze e StreamingContext specificateSerializationInfo. |
Proprietà
| Nome | Descrizione |
|---|---|
| CharacterSet |
Ottiene il set di caratteri della risposta. |
| ContentEncoding |
Ottiene il metodo utilizzato per codificare il corpo della risposta. |
| ContentLength |
Ottiene la lunghezza del contenuto restituito dalla richiesta. |
| ContentType |
Ottiene il tipo di contenuto della risposta. |
| Cookies |
Ottiene o imposta i cookie associati a questa risposta. |
| Headers |
Ottiene le intestazioni associate a questa risposta dal server. |
| 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 sia il client che il server sono stati autenticati. |
| LastModified |
Ottiene la data e l'ora dell'ultima modifica del contenuto della risposta. |
| Method |
Ottiene il metodo utilizzato per restituire la risposta. |
| ProtocolVersion |
Ottiene la versione del protocollo HTTP utilizzato nella risposta. |
| ResponseUri |
Ottiene l'URI della risorsa Internet che ha risposto alla richiesta. |
| Server |
Ottiene il nome del server che ha inviato la risposta. |
| StatusCode |
Ottiene lo stato della risposta. |
| StatusDescription |
Ottiene la descrizione dello stato restituita con la risposta. |
| SupportsHeaders |
Ottiene un valore che indica se le intestazioni sono supportate. |
Metodi
| Nome | Descrizione |
|---|---|
| Close() |
Chiude il flusso di 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 da HttpWebResponsee, facoltativamente, elimina le risorse gestite. |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| GetHashCode() |
Restituisce un valore hash per un'istanza HttpWebResponse di . |
| 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.
Obsoleti.
Obsoleti.
Popola un SerializationInfo oggetto con i dati necessari per serializzare l'oggetto di destinazione. |
| GetResponseHeader(String) |
Ottiene il contenuto di un'intestazione restituita con la risposta. |
| GetResponseStream() |
Ottiene il flusso utilizzato per leggere il corpo della risposta dal server. |
| 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() |
Questa API supporta l'infrastruttura del prodotto e non è previsto che venga usata direttamente dal codice. Rilascia tutte le risorse usate da HttpWebResponse. |
| 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.
Obsoleti.
Obsoleti.
Serializza questa istanza nell'oggetto specificato SerializationInfo . |