WebRequest Classe

Définition

Effectue une demande à un URI (Uniform Resource Identifier).Makes a request to a Uniform Resource Identifier (URI). Il s'agit d'une classe abstract.This is an abstract class.

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
Public MustInherit Class WebRequest
Public MustInherit Class WebRequest
Inherits MarshalByRefObject
Implements ISerializable
Héritage
WebRequest
Héritage
Dérivé
Attributs
Implémente

Exemples

L’exemple suivant montre comment créer une instance de WebRequest et retourner la réponse.The following example shows how to create a WebRequest instance and return the response.

#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

Important

Nous vous déconseillons d’utiliser WebRequest ou ses classes dérivées pour le nouveau développement.We don't recommend that you use WebRequest or its derived classes for new development. Utilisez plutôt la classe System.Net.Http.HttpClient.Instead, use the System.Net.Http.HttpClient class.

WebRequest est la classe de base abstract pour. Modèle de demande/réponse NET pour accéder aux données à partir d’Internet.WebRequest is the abstract base class for .NET's request/response model for accessing data from the Internet. Une application qui utilise le modèle de demande/réponse peut demander des données à partir d’Internet dans une méthode 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.An application that uses the request/response model can request data from the Internet in a protocol-agnostic manner, in which the application works with instances of the WebRequest class while protocol-specific descendant classes carry out the details of the request.

Les demandes sont envoyées à partir d’une application vers un URI particulier, tel qu’une page Web sur un serveur.Requests are sent from an application to a particular URI, such as a Web page on a server. L’URI détermine la classe descendante appropriée à créer à partir d’une liste de WebRequest descendants inscrits pour l’application.The URI determines the proper descendant class to create from a list of WebRequest descendants registered for the application. WebRequest les descendants sont généralement enregistrés pour gérer un protocole spécifique, tel que HTTP ou FTP, mais ils peuvent être inscrits pour gérer une demande à un serveur ou à un chemin d’accès spécifique sur un serveur.WebRequest descendants are typically registered to handle a specific protocol, such as HTTP or FTP, but can be registered to handle a request to a specific server or path on a server.

La classe WebRequest lève une WebException quand des erreurs se produisent lors de l’accès à une ressource Internet.The WebRequest class throws a WebException when errors occur while accessing an Internet resource. La propriété Status est l’une des valeurs WebExceptionStatus qui indique la source de l’erreur.The Status property is one of the WebExceptionStatus values that indicates the source of the error. Lorsque Status est WebExceptionStatus.ProtocolError, la propriété Response contient les WebResponse reçues de la ressource Internet.When Status is WebExceptionStatus.ProtocolError, the Response property contains the WebResponse received from the Internet resource.

Étant donné que la classe WebRequest est une classe abstract, le comportement réel des instances WebRequest au moment de l’exécution est déterminé par la classe descendante retournée par Create méthode.Because the WebRequest class is an abstract class, the actual behavior of WebRequest instances at run time is determined by the descendant class returned by Create method. Pour plus d’informations sur les valeurs par défaut et les exceptions, consultez la documentation des classes descendantes, telles que HttpWebRequest et FileWebRequest.For more information about default values and exceptions, see the documentation for the descendant classes, such as HttpWebRequest and FileWebRequest.

Notes

Utilisez la méthode Create pour initialiser de nouvelles instances de WebRequest.Use the Create method to initialize new WebRequest instances. N’utilisez pas le constructeur WebRequest.Do not use the WebRequest constructor.

Notes

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 de l’ordinateur local, sauf si l’autorisation a été explicitement accordée à l’utilisateur.If the application that creates the WebRequest object runs with the credentials of a Normal user, the application will not be able to access certificates installed in the local machine store unless permission has been explicitly given to the user to do so.

Notes pour les responsables de l’implémentation

Lorsque vous héritez de WebRequest, vous devez substituer les membres suivants : Method, RequestUri, Headers, ContentLength, ContentType, Credentials, PreAuthenticate, GetRequestStream(), BeginGetRequestStream(AsyncCallback, Object), EndGetRequestStream(IAsyncResult), GetResponse(), BeginGetResponse(AsyncCallback, Object)et EndGetResponse(IAsyncResult).When you inherit from WebRequest, you must override the following members: Method, RequestUri, Headers, ContentLength, ContentType, Credentials, PreAuthenticate, GetRequestStream(), BeginGetRequestStream(AsyncCallback, Object), EndGetRequestStream(IAsyncResult), GetResponse(), BeginGetResponse(AsyncCallback, Object), and 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).In addition, you must provide an implementation of the IWebRequestCreate interface, which defines the Create(Uri) method used when you call 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.You must register the class that implements the IWebRequestCreate interface, using the RegisterPrefix(String, IWebRequestCreate) method or the configuration file.

Constructeurs

WebRequest()

Initialise une nouvelle instance de la classe WebRequest.Initializes a new instance of the WebRequest class.

WebRequest(SerializationInfo, StreamingContext)

Initialise une nouvelle instance de la classe WebRequest à partir des instances spécifiées des classes SerializationInfo et StreamingContext.Initializes a new instance of the WebRequest class from the specified instances of the SerializationInfo and StreamingContext classes.

Propriétés

AuthenticationLevel

Obtient ou définit des valeurs indiquant les niveaux d'authentification et d'emprunt d'identité utilisés pour cette demande.Gets or sets values indicating the level of authentication and impersonation used for this request.

CachePolicy

Obtient ou définit la stratégie de cache de cette demande.Gets or sets the cache policy for this request.

ConnectionGroupName

En cas de substitution dans une classe descendante, obtient ou définit le nom du groupe de connexions pour la demande.When overridden in a descendant class, gets or sets the name of the connection group for the request.

ContentLength

En cas de substitution dans une classe descendante, obtient ou définit la longueur des données de demande envoyées.When overridden in a descendant class, gets or sets the content length of the request data being sent.

ContentType

En cas de substitution dans une classe descendante, obtient ou définit le type de contenu des données de demande envoyées.When overridden in a descendant class, gets or sets the content type of the request data being sent.

CreatorInstance

En cas de remplacement dans une classe descendante, obtient l'objet de fabrique dérivé de la classe IWebRequestCreate utilisé pour créer l'élément WebRequest instancié pour créer la demande à l'URI spécifié.When overridden in a descendant class, gets the factory object derived from the IWebRequestCreate class used to create the WebRequest instantiated for making the request to the specified URI.

Credentials

En cas de substitution dans une classe descendante, obtient ou définit les informations d'identification réseau utilisées pour authentifier la demande auprès de la ressource Internet.When overridden in a descendant class, gets or sets the network credentials used for authenticating the request with the Internet resource.

DefaultCachePolicy

Obtient ou définit la stratégie de cache par défaut de cette demande.Gets or sets the default cache policy for this request.

DefaultWebProxy

Obtient ou définit le proxy HTTP global.Gets or sets the global HTTP proxy.

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 demande.When overridden in a descendant class, gets or sets the collection of header name/value pairs associated with the request.

ImpersonationLevel

Obtient ou définit le niveau d'emprunt d'identité pour la demande en cours.Gets or sets the impersonation level for the current request.

Method

En cas de substitution dans une classe descendante, obtient ou définit la méthode de protocole à utiliser dans cette demande.When overridden in a descendant class, gets or sets the protocol method to use in this request.

PreAuthenticate

En cas de substitution dans une classe descendante, indique si la demande doit être préalablement authentifiée.When overridden in a descendant class, indicates whether to pre-authenticate the request.

Proxy

En cas de substitution dans une classe descendante, obtient ou définit le proxy réseau à utiliser pour accéder à cette ressource Internet.When overridden in a descendant class, gets or sets the network proxy to use to access this Internet resource.

RequestUri

En cas de substitution dans une classe descendante, obtient l'URI de la ressource Internet associée à la demande.When overridden in a descendant class, gets the URI of the Internet resource associated with the request.

Timeout

Obtient ou définit le délai d'expiration des demandes en millisecondes.Gets or sets the length of time, in milliseconds, before the request times out.

UseDefaultCredentials

En cas de remplacement dans une classe descendante, obtient ou définit une valeur Boolean qui détermine si les éléments DefaultCredentials sont envoyés avec les demandes.When overridden in a descendant class, gets or sets a Boolean value that controls whether DefaultCredentials are sent with requests.

Méthodes

Abort()

Abandonne la requête.Aborts the request.

BeginGetRequestStream(AsyncCallback, Object)

En cas de substitution dans une classe descendante, fournit une version asynchrone de la méthode GetRequestStream().When overridden in a descendant class, provides an asynchronous version of the GetRequestStream() method.

BeginGetResponse(AsyncCallback, Object)

En cas de substitution dans une classe descendante, démarre une demande asynchrone pour une ressource Internet.When overridden in a descendant class, begins an asynchronous request for an Internet resource.

Create(String)

Initialise une nouvelle instance de WebRequest pour le modèle d'URI spécifié.Initializes a new WebRequest instance for the specified URI scheme.

Create(Uri)

Initialise une nouvelle instance de WebRequest pour le modèle d'URI spécifié.Initializes a new WebRequest instance for the specified URI scheme.

CreateDefault(Uri)

Initialise une nouvelle instance de WebRequest pour le modèle d'URI spécifié.Initializes a new WebRequest instance for the specified URI scheme.

CreateHttp(String)

Initialise une nouvelle instance de HttpWebRequest pour la chaîne d'URI spécifiée.Initializes a new HttpWebRequest instance for the specified URI string.

CreateHttp(Uri)

Initialise une nouvelle instance de HttpWebRequest pour l'URI spécifié.Initializes a new HttpWebRequest instance for the specified URI.

CreateObjRef(Type)

Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Hérité de MarshalByRefObject)
EndGetRequestStream(IAsyncResult)

En cas de remplacement dans une classe descendante, retourne un élément Stream pour l'écriture de données dans la ressource Internet.When overridden in a descendant class, returns a Stream for writing data to the Internet resource.

EndGetResponse(IAsyncResult)

En cas de remplacement dans une classe descendante, retourne un élément WebResponse.When overridden in a descendant class, returns a WebResponse.

Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetLifetimeService()

Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Hérité de MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext)

Remplit un SerializationInfo avec les données requises pour sérialiser l'objet cible.Populates a SerializationInfo with the data needed to serialize the target object.

GetRequestStream()

En cas de remplacement dans une classe descendante, retourne un élément Stream pour l'écriture de données dans la ressource Internet.When overridden in a descendant class, returns a Stream for writing data to the Internet resource.

GetRequestStreamAsync()

En cas de remplacement dans une classe descendante, retourne un élément Stream pour l'écriture de données dans la ressource Internet sous forme d'opération asynchrone.When overridden in a descendant class, returns a Stream for writing data to the Internet resource as an asynchronous operation.

GetResponse()

En cas de substitution dans une classe descendante, retourne une réponse à une demande Internet.When overridden in a descendant class, returns a response to an Internet request.

GetResponseAsync()

En cas de substitution dans une classe descendante, retourne une réponse à une demande Internet en tant qu'opération asynchrone.When overridden in a descendant class, returns a response to an Internet request as an asynchronous operation.

GetSystemWebProxy()

Retourne un proxy configuré avec les paramètres Internet Explorer de l'utilisateur actuellement représenté.Returns a proxy configured with the Internet Explorer settings of the currently impersonated user.

GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
InitializeLifetimeService()

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.Obtains a lifetime service object to control the lifetime policy for this instance.

(Hérité de MarshalByRefObject)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
MemberwiseClone(Boolean)

Crée une copie superficielle de l'objet MarshalByRefObject actuel.Creates a shallow copy of the current MarshalByRefObject object.

(Hérité de MarshalByRefObject)
RegisterPortableWebRequestCreator(IWebRequestCreate)

Inscrit un objet IWebRequestCreate.Register an IWebRequestCreate object.

RegisterPrefix(String, IWebRequestCreate)

Inscrit un descendant de WebRequest pour l'URI spécifié.Registers a WebRequest descendant for the specified URI.

ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Hérité de Object)

Implémentations d’interfaces explicites

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

En cas de remplacement dans une classe descendante, remplit une instance de SerializationInfo avec les données nécessaires à la sérialisation de l'élément WebRequest.When overridden in a descendant class, populates a SerializationInfo instance with the data needed to serialize the WebRequest.

S’applique à

Voir aussi