HttpWebRequest Classe

Definizione

Spazio dei nomi:

System.Net

Assembly:

System.Net.Requests.dll

Origine:

HttpWebRequest.cs

Fornisce un'implementazione specifica http della classe WebRequest.

public ref class HttpWebRequest : System::Net::WebRequest, System::Runtime::Serialization::ISerializable

public class HttpWebRequest : System.Net.WebRequest, System.Runtime.Serialization.ISerializable

type HttpWebRequest = class
    inherit WebRequest
    interface ISerializable

Public Class HttpWebRequest
Inherits WebRequest
Implements ISerializable

Ereditarietà

Object

MarshalByRefObject

WebRequest

HttpWebRequest

Implementazioni

ISerializable

Esempio

Nell'esempio di codice seguente viene creata una HttpWebRequest per l'URI http://www.contoso.com/.

HttpWebRequest^ myReq = dynamic_cast<HttpWebRequest^>(WebRequest::Create( "http://www.contoso.com/" ));

HttpWebRequest myReq =
(HttpWebRequest)WebRequest.Create("http://www.contoso.com/");

Dim myReq As HttpWebRequest = _
    WebRequest.Create("http://www.contoso.com/")

Commenti

Cautela

WebRequest, HttpWebRequest, ServicePointe WebClient sono obsoleti e non è consigliabile usarli per nuovi sviluppi. Usare invece HttpClient.

La classe HttpWebRequest fornisce supporto per le proprietà e i metodi definiti in WebRequest e per proprietà e metodi aggiuntivi che consentono all'utente di interagire direttamente con i server tramite HTTP.

Non usare il costruttore HttpWebRequest. Utilizzare il metodo WebRequest.Create per inizializzare nuovi oggetti HttpWebRequest. Se lo schema per l'URI (Uniform Resource Identifier) è http:// o https://, Create restituisce un oggetto HttpWebRequest.

Il metodo GetResponse effettua una richiesta sincrona alla risorsa specificata nella proprietà RequestUri e restituisce un HttpWebResponse che contiene l'oggetto risposta. I dati di risposta possono essere ricevuti usando il flusso restituito da GetResponseStream. Se l'oggetto risposta o il flusso di risposta viene chiuso, i dati rimanenti verranno interrotti. I dati rimanenti verranno svuotati e il socket verrà riutilizzato per le richieste successive quando si chiude l'oggetto o il flusso di risposta se sono presenti le condizioni seguenti: si tratta di una richiesta keep-alive o pipeline, è necessario ricevere solo una piccola quantità di dati o i dati rimanenti vengono ricevuti in un intervallo di tempo ridotto. Se nessuna delle condizioni menzionate mantiene o viene superato il tempo di scarico, il socket verrà chiuso. Per le connessioni keep-alive o pipeline, è consigliabile che l'applicazione legga i flussi fino a EOF. In questo modo si garantisce che il socket venga riutilizzato per le richieste successive, ottenendo prestazioni migliori e meno risorse usate.

Quando si desidera inviare dati alla risorsa, il metodo GetRequestStream restituisce un oggetto Stream da utilizzare per inviare dati. I metodi BeginGetRequestStream e EndGetRequestStream forniscono l'accesso asincrono al flusso di dati di invio.

Per l'autenticazione client con HttpWebRequest, il certificato client deve essere installato nell'archivio certificati personale dell'utente corrente.

La classe HttpWebRequest genera un WebException quando si verificano errori durante l'accesso a una risorsa. La proprietà WebException.Status contiene un valore WebExceptionStatus che indica l'origine dell'errore. Quando WebException.Status è WebExceptionStatus.ProtocolError, la proprietà Response contiene il HttpWebResponse ricevuto dalla risorsa.

HttpWebRequest espone i valori di intestazione HTTP comuni inviati alla risorsa Internet come proprietà, impostati da metodi o impostati dal sistema; la tabella seguente contiene un elenco completo. È possibile impostare altre intestazioni nella proprietà Headers come coppie nome/valore. Si noti che i server e le cache possono modificare o aggiungere intestazioni durante la richiesta.

Nella tabella seguente sono elencate le intestazioni HTTP impostate da proprietà o metodi o dal sistema.

Intestazione	Impostato da
Accept	Impostato dalla proprietà Accept.
Connection	Impostata dalla proprietà Connection, KeepAlive proprietà .
Content-Length	Impostato dalla proprietà ContentLength.
Content-Type	Impostato dalla proprietà ContentType.
Expect	Impostato dalla proprietà Expect.
Date	Impostato dal sistema sulla data corrente.
Host	Impostare dal sistema sulle informazioni sull'host corrente.
If-Modified-Since	Impostato dalla proprietà IfModifiedSince.
Range	Impostato dal metodo AddRange.
Referer	Impostato dalla proprietà Referer.
Transfer-Encoding	Impostata dalla proprietà TransferEncoding (la proprietà SendChunked deve essere true).
User-Agent	Impostato dalla proprietà UserAgent.

Nota

HttpWebRequest viene registrato automaticamente. Non è necessario chiamare il metodo RegisterPrefix per registrare System.Net.HttpWebRequest prima di usare gli URI che iniziano con http:// o https://.

Il file di configurazione del computer locale o dell'applicazione può specificare che viene usato un proxy predefinito. Se viene specificata la proprietà Proxy, le impostazioni proxy della proprietà Proxy sostituiscono il computer locale o il file di configurazione dell'applicazione e l'istanza di HttpWebRequest userà le impostazioni proxy specificate. Se non viene specificato alcun proxy in un file di configurazione e la proprietà Proxy non è specificata, la classe HttpWebRequest utilizza le impostazioni proxy ereditate dalle opzioni Internet nel computer locale. Se non sono presenti impostazioni proxy nelle opzioni Internet, la richiesta viene inviata direttamente al server.

Nota

Framework memorizza nella cache le sessioni SSL durante la creazione e tenta di riutilizzare una sessione memorizzata nella cache per una nuova richiesta, se possibile. Quando si tenta di riutilizzare una sessione SSL, framework usa il primo elemento di ClientCertificates (se presente) o tenta di riutilizzare una sessione anonima se ClientCertificates è vuoto.

Nota

Per motivi di sicurezza, i cookie sono disabilitati per impostazione predefinita. Se si desidera utilizzare i cookie, utilizzare la proprietà CookieContainer per abilitare i cookie.

.NET Framework 4.6 include una nuova funzionalità di sicurezza che blocca algoritmi di crittografia e hash non sicuri per le connessioni. Le applicazioni che usano TLS/SSL tramite API, ad esempio HttpClient, HttpWebRequest, FTPClient, SmtpClient, SslStream e così via, e come destinazione .NET Framework 4.6 ottengono il comportamento più sicuro per impostazione predefinita.

Gli sviluppatori potrebbero voler rifiutare esplicitamente questo comportamento per mantenere l'interoperabilità con i servizi SSL3 esistenti O TLS w/ RC4. Questo articolo spiega come modificare il codice in modo che il nuovo comportamento sia disabilitato.

Costruttori

HttpWebRequest(SerializationInfo, StreamingContext)

Obsoleti. Inizializza una nuova istanza della classe HttpWebRequest dalle istanze specificate delle classi SerializationInfo e StreamingContext. Questo costruttore è obsoleto.

Proprietà

Accept	Ottiene o imposta il valore dell'intestazione HTTP Accept.
Address	Ottiene l'URI (Uniform Resource Identifier) della risorsa Internet che risponde effettivamente alla richiesta.
AllowAutoRedirect	Ottiene o imposta un valore che indica se la richiesta deve seguire le risposte di reindirizzamento.
AllowReadStreamBuffering	Ottiene o imposta un valore che indica se memorizzare nel buffer l'oggetto ricevuto dalla risorsa Internet.
AllowWriteStreamBuffering	Ottiene o imposta un valore che indica se memorizzare nel buffer i dati inviati alla risorsa Internet.
AuthenticationLevel	Ottiene o imposta valori che indicano il livello di autenticazione e rappresentazione utilizzati per questa richiesta. (Ereditato da WebRequest)
AutomaticDecompression	Ottiene o imposta il tipo di decompressione utilizzata.
CachePolicy	Ottiene o imposta i criteri di cache per questa richiesta. (Ereditato da WebRequest)
ClientCertificates	Ottiene o imposta la raccolta di certificati di sicurezza associati a questa richiesta.
Connection	Ottiene o imposta il valore dell'intestazione HTTP Connection.
ConnectionGroupName	Ottiene o imposta il nome del gruppo di connessione per la richiesta.
ContentLength	Ottiene o imposta l'intestazione HTTP Content-length.
ContentType	Ottiene o imposta il valore dell'intestazione HTTP Content-type.
ContinueDelegate	Ottiene o imposta il metodo delegato chiamato quando viene ricevuta una risposta HTTP 100-continue dalla risorsa Internet.
ContinueTimeout	Ottiene o imposta un timeout, espresso in millisecondi, per attendere che il 100-Continue venga ricevuto dal server.
CookieContainer	Ottiene o imposta i cookie associati alla richiesta.
CreatorInstance	In caso di override in una classe discendente, ottiene l'oggetto factory derivato dalla classe IWebRequestCreate utilizzata per creare l'WebRequest creata un'istanza per effettuare la richiesta all'URI specificato. (Ereditato da WebRequest)
Credentials	Ottiene o imposta le informazioni di autenticazione per la richiesta.
Date	Ottiene o imposta il valore dell'intestazione HTTP Date da usare in una richiesta HTTP.
DefaultCachePolicy	Ottiene o imposta i criteri di cache predefiniti per questa richiesta.
DefaultMaximumErrorResponseLength	Ottiene o imposta la lunghezza massima predefinita di una risposta di errore HTTP.
DefaultMaximumResponseHeadersLength	Ottiene o imposta il valore predefinito per la proprietà MaximumResponseHeadersLength.
Expect	Ottiene o imposta il valore dell'intestazione HTTP Expect.
HaveResponse	Ottiene un valore che indica se una risposta è stata ricevuta da una risorsa Internet.
Headers	Specifica una raccolta delle coppie nome/valore che costituiscono le intestazioni HTTP.
Host	Ottiene o imposta il valore dell'intestazione Host da utilizzare in una richiesta HTTP indipendente dall'URI della richiesta.
IfModifiedSince	Ottiene o imposta il valore dell'intestazione HTTP If-Modified-Since.
ImpersonationLevel	Ottiene o imposta il livello di rappresentazione per la richiesta corrente. (Ereditato da WebRequest)
KeepAlive	Ottiene o imposta un valore che indica se stabilire una connessione permanente alla risorsa Internet.
MaximumAutomaticRedirections	Ottiene o imposta il numero massimo di reindirizzamenti che la richiesta segue.
MaximumResponseHeadersLength	Ottiene o imposta la lunghezza massima consentita delle intestazioni di risposta.
MediaType	Ottiene o imposta il tipo di supporto della richiesta.
Method	Ottiene o imposta il metodo per la richiesta.
Pipelined	Ottiene o imposta un valore che indica se eseguire la pipeline della richiesta alla risorsa Internet.
PreAuthenticate	Ottiene o imposta un valore che indica se inviare un'intestazione di autorizzazione con la richiesta.
ProtocolVersion	Ottiene o imposta la versione di HTTP da utilizzare per la richiesta.
Proxy	Ottiene o imposta le informazioni sul proxy per la richiesta.
ReadWriteTimeout	Ottiene o imposta un timeout in millisecondi durante la scrittura o la lettura da un flusso.
Referer	Ottiene o imposta il valore dell'intestazione HTTP Referer.
RequestUri	Ottiene l'URI (Uniform Resource Identifier) originale della richiesta.
SendChunked	Ottiene o imposta un valore che indica se inviare dati in segmenti alla risorsa Internet.
ServerCertificateValidationCallback	Ottiene o imposta una funzione di callback per convalidare il certificato del server.
ServicePoint	Ottiene il punto di servizio da utilizzare per la richiesta.
SupportsCookieContainer	Ottiene un valore che indica se la richiesta fornisce supporto per un CookieContainer.
Timeout	Ottiene o imposta il valore di timeout in millisecondi per i metodi GetResponse() e GetRequestStream().
TransferEncoding	Ottiene o imposta il valore dell'intestazione HTTP Transfer-encoding.
UnsafeAuthenticatedConnectionSharing	Ottiene o imposta un valore che indica se consentire la condivisione di connessioni NTLM ad alta velocità.
UseDefaultCredentials	Ottiene o imposta un valore Boolean che controlla se le credenziali predefinite vengono inviate con richieste.
UserAgent	Ottiene o imposta il valore dell'intestazione HTTP User-agent.

Metodi

Abort()	Annulla una richiesta a una risorsa Internet.
AddRange(Int32)	Aggiunge un'intestazione di intervallo di byte a una richiesta per un intervallo specifico dall'inizio o dalla fine dei dati richiesti.
AddRange(Int32, Int32)	Aggiunge un'intestazione di intervallo di byte alla richiesta di un intervallo specificato.
AddRange(Int64)	Aggiunge un'intestazione di intervallo di byte a una richiesta per un intervallo specifico dall'inizio o dalla fine dei dati richiesti.
AddRange(Int64, Int64)	Aggiunge un'intestazione di intervallo di byte alla richiesta di un intervallo specificato.
AddRange(String, Int32)	Aggiunge un'intestazione Range a una richiesta per un intervallo specifico dall'inizio o dalla fine dei dati richiesti.
AddRange(String, Int32, Int32)	Aggiunge un'intestazione di intervallo a una richiesta per un intervallo specificato.
AddRange(String, Int64)	Aggiunge un'intestazione Range a una richiesta per un intervallo specifico dall'inizio o dalla fine dei dati richiesti.
AddRange(String, Int64, Int64)	Aggiunge un'intestazione di intervallo a una richiesta per un intervallo specificato.
BeginGetRequestStream(AsyncCallback, Object)	Avvia una richiesta asincrona per un oggetto Stream da utilizzare per scrivere dati.
BeginGetResponse(AsyncCallback, Object)	Avvia una richiesta asincrona a una risorsa Internet.
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)
EndGetRequestStream(IAsyncResult)	Termina una richiesta asincrona per un oggetto Stream da utilizzare per scrivere dati.
EndGetRequestStream(IAsyncResult, TransportContext)	Termina una richiesta asincrona per un oggetto Stream da usare per scrivere dati e restituisce i TransportContext associati al flusso.
EndGetResponse(IAsyncResult)	Termina una richiesta asincrona a una risorsa Internet.
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 SerializationInfo con i dati necessari per serializzare l'oggetto di destinazione.
GetRequestStream()	Ottiene un oggetto Stream da utilizzare per scrivere i dati della richiesta.
GetRequestStream(TransportContext)	Ottiene un oggetto Stream da utilizzare per scrivere i dati della richiesta e restituisce il TransportContext associato al flusso.
GetRequestStreamAsync()	Quando sottoposto a override in una classe discendente, restituisce un Stream per la scrittura di dati nella risorsa Internet come operazione asincrona. (Ereditato da WebRequest)
GetResponse()	Restituisce una risposta da una risorsa Internet.
GetResponseAsync()	Quando sottoposto a override in una classe discendente, restituisce una risposta a una richiesta Internet come operazione asincrona. (Ereditato da WebRequest)
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 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 SerializationInfo con i dati necessari per serializzare l'oggetto di destinazione.

Metodi di estensione

GetRequestMetadata(HttpWebRequest)	Ottiene i metadati per le richieste in uscita da utilizzare a scopo di telemetria.
SetRequestMetadata(HttpWebRequest, RequestMetadata)	Imposta i metadati per le richieste in uscita da usare a scopo di telemetria.

Vedi anche

• elemento DefaultProxy (Impostazioni di rete)
• Modifiche all'autenticazione NTLM per HTTPWebRequest nella versione 3.5 SP1