HttpRequestBase Classe

Définition

Sert de classe de base pour les classes qui permettent à ASP.NET de lire les valeurs HTTP envoyées par un client lors d'une requête web.Serves as the base class for classes that enable ASP.NET to read the HTTP values sent by a client during a Web request.

public ref class HttpRequestBase abstract
public abstract class HttpRequestBase
type HttpRequestBase = class
Public MustInherit Class HttpRequestBase
Héritage
HttpRequestBase
Dérivé

Remarques

La HttpRequestBase classe est une classe abstraite qui contient les mêmes membres que HttpRequest la classe.The HttpRequestBase class is an abstract class that contains the same members as the HttpRequest class. La HttpRequestBase classe vous permet de créer des classes dérivées qui sont HttpRequest similaires à la classe, mais que vous pouvez personnaliser et qui fonctionnent à l’extérieur du pipeline ASP.net.The HttpRequestBase class enables you to create derived classes that are like the HttpRequest class, but that you can customize and that work outside the ASP.NET pipeline. Lorsque vous effectuez des tests unitaires, vous utilisez généralement une classe dérivée pour implémenter des membres qui ont un comportement personnalisé qui respecte le scénario que vous testez.When you perform unit testing, you typically use a derived class to implement members that have customized behavior that fulfills the scenario that you are testing.

La classe HttpRequestWrapper dérive de la classe HttpRequestBase .The HttpRequestWrapper class derives from the HttpRequestBase class. La HttpRequestWrapper classe sert de wrapper pour la HttpRequest classe.The HttpRequestWrapper class serves as a wrapper for the HttpRequest class. Au moment de l’exécution, vous utilisez généralement une instance HttpRequestWrapper de la classe pour appeler des HttpRequest membres de l’objet.At run time, you typically use an instance of the HttpRequestWrapper class to invoke members of the HttpRequest object.

Constructeurs

HttpRequestBase()

Initialise la classe pour qu'elle soit utilisée par une instance de la classe héritée.Initializes the class for use by an inherited class instance. Ce constructeur peut être appelé uniquement par une classe héritée.This constructor can only be called by an inherited class.

Propriétés

AcceptTypes

En cas de substitution dans une classe dérivée, obtient un tableau des types MIME pris en charge par le client.When overridden in a derived class, gets an array of client-supported MIME accept types.

AnonymousID

En cas de substitution dans une classe dérivée, obtient l'identificateur anonyme de l'utilisateur, s'il est disponible.When overridden in a derived class, gets the anonymous identifier for the user, if it is available.

ApplicationPath

En cas de substitution dans une classe dérivée, obtient le chemin d'accès racine virtuel de l'application ASP.NET sur le serveur.When overridden in a derived class, gets the virtual root path of the ASP.NET application on the server.

AppRelativeCurrentExecutionFilePath

En cas de substitution dans une classe dérivée, obtient le chemin virtuel de la racine de l’application et le rend relatif à l’aide du caractère tilde (~) à la racine de l’application (par exemple « ~/page.aspx »).When overridden in a derived class, gets the virtual path of the application root and makes it relative by using the tilde (~) notation for the application root (as in "~/page.aspx").

Browser

En cas de substitution dans une classe dérivée, obtient les informations relatives aux fonctionnalités de navigation du client demandeur.When overridden in a derived class, gets information about the requesting client's browser capabilities.

ClientCertificate

En cas de substitution dans une classe dérivée, obtient le certificat de sécurité du client pour la demande en cours.When overridden in a derived class, gets the current request's client security certificate.

ContentEncoding

En cas de substitution dans une classe dérivée, obtient ou définit le jeu de caractères des données fournies par le client.When overridden in a derived class, gets or sets the character set of the data that is provided by the client.

ContentLength

En cas de substitution dans une classe dérivée, obtient la longueur, en octets, du contenu envoyé par le client.When overridden in a derived class, gets the length, in bytes, of content that was sent by the client.

ContentType

En cas de substitution dans une classe dérivée, obtient ou définit le type de contenu MIME de la requête.When overridden in a derived class, gets or sets the MIME content type of the request.

Cookies

En cas de substitution dans une classe dérivée, obtient la collection des cookies envoyés par le client.When overridden in a derived class, gets the collection of cookies that were sent by the client.

CurrentExecutionFilePath

En cas de substitution dans une classe dérivée, obtient le chemin d'accès virtuel de la requête actuelle.When overridden in a derived class, gets the virtual path of the current request.

CurrentExecutionFilePathExtension

En cas d'implémentation dans une classe dérivée, obtient l'extension du nom de fichier spécifié dans la propriété CurrentExecutionFilePath.When implemented in a derived class, gets the extension of the file name that is specified in the CurrentExecutionFilePath property.

FilePath

En cas de substitution dans une classe dérivée, obtient le chemin d'accès virtuel de la requête actuelle.When overridden in a derived class, gets the virtual path of the current request.

Files

En cas de substitution dans une classe dérivée, obtient la collection des fichiers qui ont été téléchargés par le client (format Multipart MIME).When overridden in a derived class, gets the collection of files that were uploaded by the client, in multipart MIME format.

Filter

En cas de substitution dans une classe dérivée, obtient ou définit le filtre à utiliser lors de la lecture du flux d'entrée actuel.When overridden in a derived class, gets or sets the filter to use when the current input stream is being read.

Form

En cas de substitution dans une classe dérivée, obtient la collection des variables de formulaire envoyées par le client.When overridden in a derived class, gets the collection of form variables that were sent by the client.

Headers

En cas de substitution dans une classe dérivée, obtient la collection des en-têtes HTTP envoyés par le client.When overridden in a derived class, gets the collection of HTTP headers that were sent by the client.

HttpChannelBinding

En cas de substitution dans une classe dérivée, obtient l'objet ChannelBinding de l'instance de HttpWorkerRequest actuelle.When overridden in a derived class, gets the ChannelBinding object of the current HttpWorkerRequest instance.

HttpMethod

En cas de substitution dans une classe dérivée, obtient la méthode de transfert des données HTTP (par exemple GET, POST ou HEAD) utilisée par le client.When overridden in a derived class, gets the HTTP data-transfer method (such as GET, POST, or HEAD) that was used by the client.

InputStream

En cas de substitution dans une classe dérivée, obtient le contenu du corps de l'entité HTTP entrante.When overridden in a derived class, gets the contents of the incoming HTTP entity body.

IsAuthenticated

En cas de substitution dans une classe dérivée, obtient une valeur qui indique si la demande a été authentifiée.When overridden in a derived class, gets a value that indicates whether the request has been authenticated.

IsLocal

En cas de substitution dans une classe dérivée, obtient une valeur qui indique si la demande provient de l'ordinateur local.When overridden in a derived class, gets a value that indicates whether the request is from the local computer.

IsSecureConnection

En cas de substitution dans une classe dérivée, obtient une valeur qui indique si la connexion HTTP est sécurisée (protocole HTTPS).When overridden in a derived class, gets a value that indicates whether the HTTP connection uses secure sockets (HTTPS protocol).

Item[String]

En cas de substitution dans une classe dérivée, obtient l'objet spécifié à partir des collections Cookies, Form, QueryString ou ServerVariables.When overridden in a derived class, gets the specified object from the Cookies, Form, QueryString, or ServerVariables collections.

LogonUserIdentity

En cas de substitution dans une classe dérivée, obtient le type WindowsIdentity pour l'utilisateur actuel.When overridden in a derived class, gets the WindowsIdentity type for the current user.

Params

En cas de substitution dans une classe dérivée, obtient une collection combinée d'éléments QueryString, Form, ServerVariables et Cookies.When overridden in a derived class, gets a combined collection of QueryString, Form, ServerVariables, and Cookies items.

Path

En cas de substitution dans une classe dérivée, obtient le chemin d'accès virtuel de la requête actuelle.When overridden in a derived class, gets the virtual path of the current request.

PathInfo

En cas de substitution dans une classe dérivée, obtient les informations supplémentaires de chemin d'accès pour une ressource munie d'une extension URL.When overridden in a derived class, gets additional path information for a resource that has a URL extension.

PhysicalApplicationPath

En cas de substitution dans une classe dérivée, obtient le chemin d'accès physique, dans le système de fichiers, du répertoire racine de l'application en cours.When overridden in a derived class, gets the physical file-system path of the current application's root directory.

PhysicalPath

En cas de substitution dans une classe dérivée, obtient le chemin d'accès physique, dans le système de fichiers, de la ressource demandée.When overridden in a derived class, gets the physical file-system path of the requested resource.

QueryString

En cas de substitution dans une classe dérivée, obtient la collection des variables chaîne de requête HTTP.When overridden in a derived class, gets the collection of HTTP query-string variables.

RawUrl

En cas de substitution dans une classe dérivée, obtient l'URL complète de la demande actuelle.When overridden in a derived class, gets the complete URL of the current request.

ReadEntityBodyMode

En cas d'implémentation dans une classe dérivée, obtient une valeur qui indique si le corps d'entité de requête a été lu et, si tel est le cas, comment il a été lu.When implemented in a derived class, gets a value that indicates whether the request entity body has been read, and if so, how it was read.

RequestContext

En cas de substitution dans une classe dérivée, obtient l'objet RequestContext de l'instance de la demande actuelle.When overridden in a derived class, gets the RequestContext instance of the current request.

RequestType

En cas de substitution dans une classe dérivée, obtient ou définit la méthode de transfert des données HTTP (par exemple GET ou POST) utilisée par le client.When overridden in a derived class, gets or sets the HTTP data-transfer method (GET or POST) that was used by the client.

ServerVariables

En cas de substitution dans une classe dérivée, obtient une collection de variables de serveur Web.When overridden in a derived class, gets a collection of Web server variables.

TimedOutToken

En cas d'implémentation dans une classe dérivée, obtient un objet CancellationToken dépassé lors de l'expiration d'une requête.When implemented in a derived class, gets a CancellationToken object that is tripped when a request times out.

TlsTokenBindingInfo

Obtient ou définit les informations de liaison de jeton pour cette instance.Gets or sets the token binding information for this instance.

TotalBytes

En cas de substitution dans une classe dérivée, obtient le nombre d'octets du flux d'entrée actuel.When overridden in a derived class, gets the number of bytes in the current input stream.

Unvalidated

En cas d'implémentation dans une classe dérivée, permet d'accéder aux valeurs de requête HTTP sans déclencher la validation de la demande.When implemented in a derived class, provides access to HTTP request values without triggering request validation.

Url

En cas de substitution dans une classe dérivée, obtient les informations relatives à l'URL de la demande actuelle.When overridden in a derived class, gets information about the URL of the current request.

UrlReferrer

En cas de substitution dans une classe dérivée, obtient les informations relatives à l'URL de la demande client liée à l'URL actuelle.When overridden in a derived class, gets information about the URL of the client request that linked to the current URL.

UserAgent

En cas de substitution dans une classe dérivée, obtient la chaîne de l'agent utilisateur complète du client.When overridden in a derived class, gets the complete user-agent string of the client.

UserHostAddress

Lors d'une substitution dans une classe dérivée, obtient l'adresse hôte IP du client.When overridden in a derived class, gets the IP host address of the client.

UserHostName

En cas de substitution dans une classe dérivée, obtient le nom DNS du client.When overridden in a derived class, gets the DNS name of the client.

UserLanguages

En cas de substitution dans une classe dérivée, obtient un tableau trié des préférences de langue du client.When overridden in a derived class, gets a sorted array of client language preferences.

Méthodes

Abort()

Termine de force la connexion TCP sous-jacente, entraînant l'échec des E/S en attente.Forcibly terminates the underlying TCP connection, causing any outstanding I/O to fail.

BinaryRead(Int32)

En cas de substitution dans une classe dérivée, effectue une lecture binaire du nombre d'octets spécifié à partir du flux d'entrée actuel.When overridden in a derived class, performs a binary read of a specified number of bytes from the current input stream.

Equals(Object)

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

(Hérité de Object)
GetBufferedInputStream()

En cas d'implémentation dans une classe dérivée, obtient un objet Stream qui peut être utilisé pour lire le corps de l'entité HTTP entrante.When implemented in a derived class, gets a Stream object that can be used to read the incoming HTTP entity body.

GetBufferlessInputStream()

En cas d'implémentation dans une classe dérivée, obtient un objet Stream qui peut être utilisé pour lire le corps de l'entité HTTP entrante, en désactivant éventuellement la longueur maximale de la requête définie dans la propriété MaxRequestLength.When implemented in a derived class, gets a Stream object that can be used to read the incoming HTTP entity body, optionally disabling the request length limit that is set in the MaxRequestLength property.

GetBufferlessInputStream(Boolean)

En cas d'implémentation dans une classe dérivée, obtient un objet Stream qui peut être utilisé pour lire le corps de l'entité HTTP entrante, en désactivant éventuellement la longueur maximale de la requête définie dans la propriété MaxRequestLength.When implemented in a derived class, gets a Stream object that can be used to read the incoming HTTP entity body, optionally disabling the request length limit that is set in the MaxRequestLength property.

GetHashCode()

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

(Hérité de Object)
GetType()

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

(Hérité de Object)
InsertEntityBody()

En cas d'implémentation dans une classe dérivée, fournit aux services Internet (IIS) une copie du corps d'entité de la requête HTTP.When implemented in a derived class, provides a copy of the HTTP request entity body to IIS.

InsertEntityBody(Byte[], Int32, Int32)

En cas d'implémentation dans une classe dérivée, fournit à IIS (Internet Information Services) une copie du corps d'entité de la requête HTTP et des informations à propos de l'objet d'entité de la requête.When implemented in a derived class, provides IIS with a copy of the HTTP request entity body and with information about the request entity object.

MapImageCoordinates(String)

En cas de substitution dans une classe dérivée, fait correspondre un paramètre de formulaire avec champ image entrant aux valeurs de coordonnées x/y appropriées.When overridden in a derived class, maps an incoming image-field form parameter to appropriate x-coordinate and y-coordinate values.

MapPath(String)

En cas de substitution dans une classe dérivée, fait correspondre le chemin d'accès virtuel spécifié avec un chemin d'accès physique sur le serveur.When overridden in a derived class, maps the specified virtual path to a physical path on the server.

MapPath(String, String, Boolean)

En cas de substitution dans une classe dérivée, fait correspondre le chemin d'accès virtuel spécifié avec un chemin d'accès physique sur le serveur.When overridden in a derived class, maps the specified virtual path to a physical path on the server.

MapRawImageCoordinates(String)

Mappe un paramètre de formulaire avec champ image entrant dans des valeurs de coordonnées x/y appropriées.Maps an incoming image field form parameter into appropriate x and y coordinate values.

MemberwiseClone()

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

(Hérité de Object)
SaveAs(String, Boolean)

En cas de substitution dans une classe dérivée, enregistre une requête HTTP sur disque.When overridden in a derived class, saves an HTTP request to disk.

ToString()

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

(Hérité de Object)
ValidateInput()

En cas de substitution dans une classe dérivée, entraîne la validation des collections accessibles via les propriétés Cookies, Form et QueryString.When overridden in a derived class, causes validation to occur for the collections that are accessed through the Cookies, Form, and QueryString properties.

S’applique à