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 : MarshalByRefObject, System::Runtime::Serialization::ISerializable
[System.Serializable]
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
Dérivé
Attributs
Implémente

Exemples

L’exemple suivant montre comment créer une WebRequest instance 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' WebRequest utiliser 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 System.Net.Http.HttpClient classe.Instead, use the System.Net.Http.HttpClient class.

WebRequestest la abstract classe de base 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 WebRequest des instances de la classe alors que les classes descendantes spécifiques au protocole effectuent les détails de demande.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' WebRequest une liste de descendants inscrits pour l’application.The URI determines the proper descendant class to create from a list of WebRequest descendants registered for the application. WebRequestles descendants sont généralement enregistrés pour gérer un protocole spécifique, tel que HTTP ou FTP, mais 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 WebRequest classe lève une WebException exception lorsque 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 Status propriété est l’une WebExceptionStatus des valeurs 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, WebResponse la Response propriété contient le reçu de la ressource Internet.When Status is WebExceptionStatus.ProtocolError, the Response property contains the WebResponse received from the Internet resource.

Étant donné WebRequest que la classe abstract est une classe, le comportement WebRequest réel des instances au moment de l’exécution est déterminé par la Create classe descendante retournée par la 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 FileWebRequest, telles que HttpWebRequest et.For more information about default values and exceptions, see the documentation for the descendant classes, such as HttpWebRequest and FileWebRequest.

Notes

Utilisez la Create méthode pour initialiser de WebRequest nouvelles instances.Use the Create method to initialize new WebRequest instances. N’utilisez pas le WebRequest constructeur.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 héritiers

Lorsque vous héritez WebRequestde, vous devez substituer les membres suivants Method: RequestUri, Headers, ContentLength, ContentType, Credentials, PreAuthenticate, GetRequestStream(), BeginGetRequestStream(AsyncCallback, Object), EndGetRequestStream(IAsyncResult) , ,, etEndGetResponse(IAsyncResult). GetResponse() BeginGetResponse(AsyncCallback, Object)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' IWebRequestCreate interface, qui définit la Create(Uri) méthode 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' IWebRequestCreate interface, à l' RegisterPrefix(String, IWebRequestCreate) aide de la méthode 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 requête.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é-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 substitution dans une classe descendante, obtient ou définit une valeur Boolean qui contrôle si les 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 demande.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 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 substitution dans une classe descendante, retourne 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 substitution dans une classe descendante, retourne 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 SerializationInfo avec les données nécessaires pour sérialiser l'objet cible.Populates a SerializationInfo with the data needed to serialize the target object.

GetRequestStream()

En cas de substitution dans une classe descendante, retourne 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 substitution dans une classe descendante, retourne un Stream pour l'écriture de données vers la ressource Internet en tant qu'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 de l'objet 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 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 substitution dans une classe descendante, remplit une instance de SerializationInfo avec les données nécessaire à la sérialisation de WebRequest.When overridden in a descendant class, populates a SerializationInfo instance with the data needed to serialize the WebRequest.

Sécurité

WebPermission
pour accéder à l’URI demandé ou à tout URI vers lequel la demande est redirigée.To access the requested URI or any URI that the request is redirected to. Énumération associée : Connect.Associated enumeration: Connect.

S’applique à

Voir aussi