HttpContext.Request Property

Definition

Obtient l'objet HttpRequest pour la requête HTTP actuelle.Gets the HttpRequest object for the current HTTP request.

public:
 property System::Web::HttpRequest ^ Request { System::Web::HttpRequest ^ get(); };
public System.Web.HttpRequest Request { get; }
member this.Request : System.Web.HttpRequest
Public ReadOnly Property Request As HttpRequest

Property Value

HttpRequest

HttpRequest pour la requête HTTP actuelle.The HttpRequest for the current HTTP request.

Exceptions

L'application web s'exécute sous IIS 7 en mode intégré.The Web application is running under IIS 7 in Integrated mode.

Remarks

La propriété Request fournit un accès par programme aux propriétés et aux méthodes de la classe HttpRequest.The Request property provides programmatic access to the properties and methods of the HttpRequest class. Étant donné que les pages ASP.NET contiennent une référence par défaut à l’espace de noms System.Web (qui contient la classe HttpContext), vous pouvez référencer les membres de HttpRequest sur une page. aspx sans utiliser la référence de classe complète pour HttpContext.Because ASP.NET pages contain a default reference to the System.Web namespace (which contains the HttpContext class), you can reference the members of HttpRequest on an .aspx page without using the fully qualified class reference to HttpContext. Par exemple, vous pouvez utiliser Request.Browser pour obtenir les fonctionnalités du navigateur client.For example, you can use Request.Browser to get the capabilities of the client browser. Toutefois, si vous souhaitez utiliser les membres de HttpRequest à partir d’un module code-behind ASP.NET, vous devez inclure une référence à l’espace de noms System.Web dans le module et une référence qualifiée complète au contexte de requête/réponse actuellement actif et à la classe dans System.Web que vous souhaitez utiliser.However, if you want to use the members of HttpRequest from an ASP.NET code-behind module, you must include a reference to the System.Web namespace in the module and a fully qualified reference to both the currently active request/response context and the class in System.Web that you want to use. Par exemple, dans une page code-behind, vous devez spécifier le nom complet HttpContext.Current.Request.Browser.For example, in a code-behind page you must specify the fully qualified name HttpContext.Current.Request.Browser.

Note

ASP.NET lèvera une exception si vous essayez d’utiliser cette propriété lorsque l’objet HttpRequest n’est pas disponible.ASP.NET will throw an exception if you try to use this property when the HttpRequest object is not available. Par exemple, cette valeur est true dans la méthode Application_Start du fichier global. asax ou dans une méthode appelée à partir de la méthode Application_Start.For example, this would be true in the Application_Start method of the Global.asax file, or in a method that is called from the Application_Start method. À ce moment, aucune requête HTTP n’a encore été créée.At that time no HTTP request has been created yet.

Applies to