WebRequest Classe
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.
Effettua una richiesta a un URI (Uniform Resource Identifier). Si tratta di una classe abstract
.
public ref class WebRequest abstract
public ref class WebRequest abstract : MarshalByRefObject, System::Runtime::Serialization::ISerializable
public abstract class WebRequest
public abstract class WebRequest : MarshalByRefObject, System.Runtime.Serialization.ISerializable
[System.Serializable]
public abstract class WebRequest : MarshalByRefObject, System.Runtime.Serialization.ISerializable
type WebRequest = class
type WebRequest = class
inherit MarshalByRefObject
interface ISerializable
[<System.Serializable>]
type WebRequest = class
inherit MarshalByRefObject
interface ISerializable
Public MustInherit Class WebRequest
Public MustInherit Class WebRequest
Inherits MarshalByRefObject
Implements ISerializable
- Ereditarietà
-
WebRequest
- Ereditarietà
- Derivato
- Attributi
- Implementazioni
Nell'esempio seguente viene illustrato come creare un'istanza di WebRequest e restituire la risposta.
#using <System.dll>
using namespace System;
using namespace System::IO;
using namespace System::Net;
using namespace System::Text;
int main()
{
// Create a request for the URL.
WebRequest^ request = WebRequest::Create( "http://www.contoso.com/default.html" );
// If required by the server, set the credentials.
request->Credentials = CredentialCache::DefaultCredentials;
// Get the response.
HttpWebResponse^ response = dynamic_cast<HttpWebResponse^>(request->GetResponse());
// Display the status.
Console::WriteLine( response->StatusDescription );
// Get the stream containing content returned by the server.
Stream^ dataStream = response->GetResponseStream();
// Open the stream using a StreamReader for easy access.
StreamReader^ reader = gcnew StreamReader( dataStream );
// Read the content.
String^ responseFromServer = reader->ReadToEnd();
// Display the content.
Console::WriteLine( responseFromServer );
// Cleanup the streams and the response.
reader->Close();
dataStream->Close();
response->Close();
}
using System;
using System.IO;
using System.Net;
using System.Text;
namespace Examples.System.Net
{
public class WebRequestGetExample
{
public static void Main ()
{
// Create a request for the URL.
WebRequest request = WebRequest.Create ("http://www.contoso.com/default.html");
// If required by the server, set the credentials.
request.Credentials = CredentialCache.DefaultCredentials;
// Get the response.
HttpWebResponse response = (HttpWebResponse)request.GetResponse ();
// Display the status.
Console.WriteLine (response.StatusDescription);
// Get the stream containing content returned by the server.
Stream dataStream = response.GetResponseStream ();
// Open the stream using a StreamReader for easy access.
StreamReader reader = new StreamReader (dataStream);
// Read the content.
string responseFromServer = reader.ReadToEnd ();
// Display the content.
Console.WriteLine (responseFromServer);
// Cleanup the streams and the response.
reader.Close ();
dataStream.Close ();
response.Close ();
}
}
}
Imports System.IO
Imports System.Net
Imports System.Text
Namespace Examples.System.Net
Public Class WebRequestGetExample
Public Shared Sub Main()
' Create a request for the URL.
Dim request As WebRequest = WebRequest.Create("http://www.contoso.com/default.html")
' If required by the server, set the credentials.
request.Credentials = CredentialCache.DefaultCredentials
' Get the response.
Dim response As HttpWebResponse = CType(request.GetResponse(), HttpWebResponse)
' Display the status.
Console.WriteLine(response.StatusDescription)
' Get the stream containing content returned by the server.
Dim dataStream As Stream = response.GetResponseStream()
' Open the stream using a StreamReader for easy access.
Dim reader As New StreamReader(dataStream)
' Read the content.
Dim responseFromServer As String = reader.ReadToEnd()
' Display the content.
Console.WriteLine(responseFromServer)
' Cleanup the streams and the response.
reader.Close()
dataStream.Close()
response.Close()
End Sub
End Class
End Namespace
Attenzione
WebRequest
, HttpWebRequest
, ServicePoint
e WebClient
sono obsoleti e non è consigliabile usarli per nuovi sviluppi. Usare invece HttpClient.
WebRequest è la classe base abstract
per . Modello di richiesta/risposta di NET per l'accesso ai dati da Internet. Un'applicazione che usa il modello di richiesta/risposta può richiedere dati da Internet in modo indipendente dal protocollo, in cui l'applicazione funziona con istanze della classe WebRequest mentre le classi discendenti specifiche del protocollo eseguono i dettagli della richiesta.
Le richieste vengono inviate da un'applicazione a un URI specifico, ad esempio una pagina Web in un server. L'URI determina la classe discendente appropriata da creare da un elenco di discendenti WebRequest registrati per l'applicazione. WebRequest discendenti vengono in genere registrati per gestire un protocollo specifico, ad esempio HTTP o FTP, ma può essere registrato per gestire una richiesta a un server o a un percorso specifico in un server.
La classe WebRequest genera un WebException quando si verificano errori durante l'accesso a una risorsa Internet. La proprietà Status è uno dei valori WebExceptionStatus che indica l'origine dell'errore. Quando Status è WebExceptionStatus.ProtocolError, la proprietà Response contiene il WebResponse ricevuto dalla risorsa Internet.
Poiché la classe WebRequest è una classe abstract
, il comportamento effettivo delle istanze di WebRequest in fase di esecuzione viene determinato dalla classe discendente restituita dal metodo Create. Per altre informazioni sui valori predefiniti e sulle eccezioni, vedere la documentazione per le classi discendenti, ad esempio HttpWebRequest e FileWebRequest.
Nota
Utilizzare il metodo Create per inizializzare nuove istanze di WebRequest. Non usare il costruttore WebRequest.
Nota
Se l'applicazione che crea l'oggetto WebRequest viene eseguita con le credenziali di un utente Normale, l'applicazione non sarà in grado di accedere ai certificati installati nell'archivio computer locale, a meno che l'autorizzazione non sia stata concessa esplicitamente all'utente.
Quando si eredita da WebRequest, è necessario eseguire l'override dei membri seguenti: Method, RequestUri, Headers, ContentLength, ContentType, Credentials, PreAuthenticate, GetRequestStream(), BeginGetRequestStream(AsyncCallback, Object), EndGetRequestStream(IAsyncResult), GetResponse(), BeginGetResponse(AsyncCallback, Object)e EndGetResponse(IAsyncResult). Inoltre, è necessario fornire un'implementazione dell'interfaccia IWebRequestCreate, che definisce il metodo Create(Uri) usato quando si chiama Create(Uri). È necessario registrare la classe che implementa l'interfaccia IWebRequestCreate usando il metodo RegisterPrefix(String, IWebRequestCreate) o il file di configurazione.
Web |
Obsoleti.
Inizializza una nuova istanza della classe WebRequest. |
Web |
Obsoleti.
Inizializza una nuova istanza della classe WebRequest dalle istanze specificate delle classi SerializationInfo e StreamingContext. |
Authentication |
Ottiene o imposta valori che indicano il livello di autenticazione e rappresentazione utilizzati per questa richiesta. |
Cache |
Ottiene o imposta i criteri di cache per questa richiesta. |
Connection |
In caso di override in una classe discendente, ottiene o imposta il nome del gruppo di connessione per la richiesta. |
Content |
Quando sottoposto a override in una classe discendente, ottiene o imposta la lunghezza del contenuto dei dati della richiesta inviati. |
Content |
Quando sottoposto a override in una classe discendente, ottiene o imposta il tipo di contenuto dei dati della richiesta inviati. |
Creator |
Obsoleti.
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. |
Credentials |
Quando sottoposto a override in una classe discendente, ottiene o imposta le credenziali di rete usate per autenticare la richiesta con la risorsa Internet. |
Default |
Ottiene o imposta i criteri di cache predefiniti per questa richiesta. |
Default |
Ottiene o imposta il proxy HTTP globale. |
Headers |
In caso di override in una classe discendente, ottiene o imposta la raccolta di coppie nome/valore di intestazione associate alla richiesta. |
Impersonation |
Ottiene o imposta il livello di rappresentazione per la richiesta corrente. |
Method |
In caso di override in una classe discendente, ottiene o imposta il metodo del protocollo da utilizzare in questa richiesta. |
Pre |
In caso di override in una classe discendente, indica se pre-autenticare la richiesta. |
Proxy |
Quando sottoposto a override in una classe discendente, ottiene o imposta il proxy di rete da usare per accedere a questa risorsa Internet. |
Request |
Quando sottoposto a override in una classe discendente, ottiene l'URI della risorsa Internet associata alla richiesta. |
Timeout |
Ottiene o imposta l'intervallo di tempo, espresso in millisecondi, prima del timeout della richiesta. |
Use |
In caso di override in una classe discendente, ottiene o imposta un valore Boolean che controlla se DefaultCredentials vengono inviati con le richieste. |
Abort() |
Interrompe la richiesta. |
Begin |
Quando sottoposto a override in una classe discendente, fornisce una versione asincrona del metodo GetRequestStream(). |
Begin |
Quando sottoposto a override in una classe discendente, avvia una richiesta asincrona per una risorsa Internet. |
Create(String) |
Obsoleti.
Inizializza una nuova istanza di WebRequest per lo schema URI specificato. |
Create(Uri) |
Obsoleti.
Inizializza una nuova istanza di WebRequest per lo schema URI specificato. |
Create |
Obsoleti.
Inizializza una nuova istanza di WebRequest per lo schema URI specificato. |
Create |
Obsoleti.
Inizializza una nuova istanza di HttpWebRequest per la stringa URI specificata. |
Create |
Obsoleti.
Inizializza una nuova istanza di HttpWebRequest per l'URI specificato. |
Create |
Crea un oggetto che contiene tutte le informazioni pertinenti necessarie per generare un proxy utilizzato per comunicare con un oggetto remoto. (Ereditato da MarshalByRefObject) |
End |
Quando sottoposto a override in una classe discendente, restituisce un Stream per la scrittura di dati nella risorsa Internet. |
End |
Quando sottoposto a override in una classe discendente, restituisce un WebResponse. |
Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
Get |
Funge da funzione hash predefinita. (Ereditato da Object) |
Get |
Obsoleti.
Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject) |
Get |
Obsoleti.
Popola un SerializationInfo con i dati necessari per serializzare l'oggetto di destinazione. |
Get |
Quando sottoposto a override in una classe discendente, restituisce un Stream per la scrittura di dati nella risorsa Internet. |
Get |
Quando sottoposto a override in una classe discendente, restituisce un Stream per la scrittura di dati nella risorsa Internet come operazione asincrona. |
Get |
Quando sottoposto a override in una classe discendente, restituisce una risposta a una richiesta Internet. |
Get |
Quando sottoposto a override in una classe discendente, restituisce una risposta a una richiesta Internet come operazione asincrona. |
Get |
Restituisce un proxy configurato con le impostazioni delle opzioni Internet dell'utente attualmente rappresentato. |
Get |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
Initialize |
Obsoleti.
Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject) |
Memberwise |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
Memberwise |
Crea una copia superficiale dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject) |
Register |
Obsoleti.
Registrare un oggetto IWebRequestCreate. |
Register |
Registra un WebRequest discendente per l'URI specificato. |
To |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
ISerializable. |
Obsoleti.
Quando sottoposto a override in una classe discendente, popola un'istanza di SerializationInfo con i dati necessari per serializzare il WebRequest. |
- HttpWebRequest
- richiesta di dati
- protocolli pluggable di programmazione
Feedback su .NET
.NET è un progetto di open source. Selezionare un collegamento per fornire feedback: