WebRequest Classe

Définition

Espace de noms:

System.Net

Assembly:

System.Net.Requests.dll

Source:

WebRequest.cs

Envoie une requête à un URI (Uniform Resource Identifier). Il s’agit d’une classe abstract.

public ref class WebRequest abstract : MarshalByRefObject, System::Runtime::Serialization::ISerializable

public abstract class WebRequest : MarshalByRefObject, System.Runtime.Serialization.ISerializable

type WebRequest = class
    inherit MarshalByRefObject
    interface ISerializable

Public MustInherit Class WebRequest
Inherits MarshalByRefObject
Implements ISerializable

Héritage

Object

MarshalByRefObject

WebRequest

Dérivé

System.IO.Packaging.PackWebRequest

System.Net.FileWebRequest

System.Net.FtpWebRequest

System.Net.HttpWebRequest

Implémente

ISerializable

Exemples

L’exemple suivant montre comment créer une instance de WebRequest et retourner la réponse.

#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

Remarques

Prudence

WebRequest, HttpWebRequest, ServicePointet WebClient sont obsolètes et vous ne devez pas les utiliser pour le nouveau développement. Utilisez HttpClient à la place.

WebRequest est la classe de base abstract pour . Modèle de demande/réponse de NET pour accéder aux données à partir d’Internet. Une application qui utilise le modèle de requête/réponse peut demander des données à partir d’Internet de manière indépendante du protocole, dans laquelle l’application fonctionne avec des instances de la classe WebRequest tandis que les classes descendantes spécifiques au protocole effectuent les détails de la requête.

Les demandes sont envoyées d’une application à un URI particulier, par exemple une page web sur un serveur. L’URI détermine la classe descendante appropriée à créer à partir d’une liste de descendants WebRequest inscrits pour l’application. WebRequest descendants sont généralement inscrits pour gérer un protocole spécifique, tel que HTTP ou FTP, mais peuvent être inscrits pour gérer une requête auprès d’un serveur ou d’un chemin d’accès spécifique sur un serveur.

La classe WebRequest lève une WebException lorsque des erreurs se produisent lors de l’accès à une ressource Internet. La propriété Status est l’une des valeurs WebExceptionStatus qui indique la source de l’erreur. Lorsque Status est WebExceptionStatus.ProtocolError, la propriété Response contient le WebResponse reçu de la ressource Internet.

Étant donné que la classe WebRequest est une classe abstract, le comportement réel des instances de WebRequest au moment de l’exécution est déterminé par la classe descendante retournée par Create méthode. Pour plus d’informations sur les valeurs et exceptions par défaut, consultez la documentation relative aux classes descendantes, telles que HttpWebRequest et FileWebRequest.

Note

Utilisez la méthode Create pour initialiser de nouvelles instances de WebRequest. N’utilisez pas le constructeur WebRequest.

Note

Si l’application qui crée l’objet WebRequest s’exécute avec les informations d’identification d’un utilisateur normal, l’application ne pourra pas accéder aux certificats installés dans le magasin d’ordinateurs local, sauf si l’autorisation a été explicitement accordée à l’utilisateur.

Notes pour les responsables de l’implémentation

Lorsque vous héritez de WebRequest, vous devez remplacer les membres suivants : Method, RequestUri, Headers, ContentLength, ContentType, Credentials, PreAuthenticate, GetRequestStream(), BeginGetRequestStream(AsyncCallback, Object), EndGetRequestStream(IAsyncResult), GetResponse(), BeginGetResponse(AsyncCallback, Object)et EndGetResponse(IAsyncResult). En outre, vous devez fournir une implémentation de l’interface IWebRequestCreate, qui définit la méthode Create(Uri) utilisée lorsque vous appelez Create(Uri). Vous devez inscrire la classe qui implémente l’interface IWebRequestCreate, à l’aide de la méthode RegisterPrefix(String, IWebRequestCreate) ou du fichier de configuration.

Constructeurs

WebRequest()	Obsolète. Initialise une nouvelle instance de la classe WebRequest.
WebRequest(SerializationInfo, StreamingContext)	Obsolète. Initialise une nouvelle instance de la classe WebRequest à partir des instances spécifiées des classes SerializationInfo et StreamingContext.

Propriétés

AuthenticationLevel	Obtient ou définit des valeurs indiquant le niveau d’authentification et d’emprunt d’identité utilisé pour cette requête.
CachePolicy	Obtient ou définit la stratégie de cache pour cette requête.
ConnectionGroupName	En cas de substitution dans une classe descendante, obtient ou définit le nom du groupe de connexions pour la demande.
ContentLength	En cas de substitution dans une classe descendante, obtient ou définit la longueur du contenu des données de requête envoyées.
ContentType	En cas de substitution dans une classe descendante, obtient ou définit le type de contenu des données de requête envoyées.
Credentials	En cas de substitution dans une classe descendante, obtient ou définit les informations d’identification réseau utilisées pour authentifier la requête avec la ressource Internet.
DefaultCachePolicy	Obtient ou définit la stratégie de cache par défaut pour cette requête.
DefaultWebProxy	Obtient ou définit le proxy HTTP global.
Headers	En cas de substitution dans une classe descendante, obtient ou définit la collection de paires nom/valeur d’en-tête associées à la requête.
ImpersonationLevel	Obtient ou définit le niveau d’emprunt d’identité de la requête actuelle.
Method	En cas de substitution dans une classe descendante, obtient ou définit la méthode de protocole à utiliser dans cette requête.
PreAuthenticate	En cas de substitution dans une classe descendante, indique s’il faut pré-authentifier la requête.
Proxy	En cas de substitution dans une classe descendante, obtient ou définit le proxy réseau à utiliser pour accéder à cette ressource Internet.
RequestUri	En cas de substitution dans une classe descendante, obtient l’URI de la ressource Internet associée à la requête.
Timeout	Obtient ou définit la durée, en millisecondes, avant l’expiration de la requête.
UseDefaultCredentials	En cas de substitution dans une classe descendante, obtient ou définit une valeur Boolean qui contrôle si DefaultCredentials sont envoyées avec des requêtes.

Méthodes

Abort()	Abandonne la demande.
BeginGetRequestStream(AsyncCallback, Object)	En cas de substitution dans une classe descendante, fournit une version asynchrone de la méthode GetRequestStream().
BeginGetResponse(AsyncCallback, Object)	En cas de substitution dans une classe descendante, commence une requête asynchrone pour une ressource Internet.
Create(String)	Obsolète. Initialise une nouvelle instance WebRequest pour le schéma d’URI spécifié.
Create(Uri)	Obsolète. Initialise une nouvelle instance WebRequest pour le schéma d’URI spécifié.
CreateDefault(Uri)	Obsolète. Initialise une nouvelle instance WebRequest pour le schéma d’URI spécifié.
CreateHttp(String)	Obsolète. Initialise une nouvelle instance de HttpWebRequest pour la chaîne d’URI spécifiée.
CreateHttp(Uri)	Obsolète. Initialise une nouvelle instance de HttpWebRequest pour l’URI spécifié.
CreateObjRef(Type)	Crée un objet qui contient toutes les informations pertinentes requises pour générer un proxy utilisé pour communiquer avec un objet distant. (Hérité de MarshalByRefObject)
EndGetRequestStream(IAsyncResult)	En cas de substitution dans une classe descendante, retourne une Stream pour écrire des données dans la ressource Internet.
EndGetResponse(IAsyncResult)	En cas de substitution dans une classe descendante, retourne un WebResponse.
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetLifetimeService()	Obsolète. Récupère l’objet de service de durée de vie actuel qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext)	Obsolète. Remplit une SerializationInfo avec les données nécessaires pour sérialiser l’objet cible.
GetRequestStream()	En cas de substitution dans une classe descendante, retourne une Stream pour écrire des données dans la ressource Internet.
GetRequestStreamAsync()	En cas de substitution dans une classe descendante, retourne une Stream pour écrire des données dans la ressource Internet en tant qu’opération asynchrone.
GetResponse()	En cas de substitution dans une classe descendante, retourne une réponse à une requête Internet.
GetResponseAsync()	En cas de substitution dans une classe descendante, retourne une réponse à une requête Internet en tant qu’opération asynchrone.
GetSystemWebProxy()	Retourne un proxy configuré avec les paramètres d’options Internet de l’utilisateur actuellement emprunt d’identité.
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
InitializeLifetimeService()	Obsolète. Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l’objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject)
RegisterPrefix(String, IWebRequestCreate)	Inscrit un WebRequest descendant pour l’URI spécifié.
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Obsolète. En cas de substitution dans une classe descendante, remplit une instance de SerializationInfo avec les données nécessaires pour sérialiser le WebRequest.

Voir aussi

• HttpWebRequest
• demande de données
• protocoles enfichables programmation