HttpRequestBase Classe

Definizione

Funge da classe base per le classi che consentono ad ASP.NET di leggere i valori HTTP inviati da un client durante una richiesta 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
Ereditarietà
HttpRequestBase
Derivato

Commenti

La HttpRequestBase classe è una classe astratta che contiene gli stessi membri della HttpRequest classe.The HttpRequestBase class is an abstract class that contains the same members as the HttpRequest class. La HttpRequestBase classe consente di creare classi derivate che sono simili HttpRequest alla classe, ma che è possibile personalizzare e che funzionano al di fuori della 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. Quando si eseguono unit test, si usa in genere una classe derivata per implementare i membri che hanno un comportamento personalizzato che soddisfa lo scenario che si sta testando.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 deriva dalla classe HttpRequestBase .The HttpRequestWrapper class derives from the HttpRequestBase class. La HttpRequestWrapper classe funge da wrapper per la HttpRequest classe.The HttpRequestWrapper class serves as a wrapper for the HttpRequest class. In fase di esecuzione, in genere si utilizza un'istanza HttpRequestWrapper della classe per richiamare i membri HttpRequest dell'oggetto.At run time, you typically use an instance of the HttpRequestWrapper class to invoke members of the HttpRequest object.

Costruttori

HttpRequestBase()

Inizializza la classe per l'uso da parte di un'istanza di una classe ereditata.Initializes the class for use by an inherited class instance. Questo costruttore può essere chiamato solo da una classe ereditata.This constructor can only be called by an inherited class.

Proprietà

AcceptTypes

Sottoposta a override in una classe derivata, ottiene una matrice di tipi di accettazione MIME supportati dal client.When overridden in a derived class, gets an array of client-supported MIME accept types.

AnonymousID

Sottoposta a override in una classe derivata, ottiene l'identificatore anonimo per l'utente, se disponibile.When overridden in a derived class, gets the anonymous identifier for the user, if it is available.

ApplicationPath

Sottoposta a override in una classe derivata, ottiene il percorso radice virtuale dell'applicazione ASP.NET nel server.When overridden in a derived class, gets the virtual root path of the ASP.NET application on the server.

AppRelativeCurrentExecutionFilePath

Sottoposta a override in una classe derivata, ottiene il percorso virtuale della radice dell'applicazione e lo converte in relativo tramite la notazione tilde (~) per la radice dell'applicazione, come in "~/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

Sottoposto a override in una classe derivata, ottiene informazioni sulle funzionalità del browser del client richiedente.When overridden in a derived class, gets information about the requesting client's browser capabilities.

ClientCertificate

Sottoposta a override in una classe derivata, ottiene il certificato di sicurezza del client della richiesta corrente.When overridden in a derived class, gets the current request's client security certificate.

ContentEncoding

Sottoposta a override in una classe derivata, ottiene o imposta il set di caratteri dei dati forniti dal client.When overridden in a derived class, gets or sets the character set of the data that is provided by the client.

ContentLength

Sottoposta a override in una classe derivata, ottiene la lunghezza, in byte, del contenuto inviato dal client.When overridden in a derived class, gets the length, in bytes, of content that was sent by the client.

ContentType

Sottoposta a override in una classe derivata, ottiene o imposta il tipo di contenuto MIME della richiesta.When overridden in a derived class, gets or sets the MIME content type of the request.

Cookies

Sottoposta a override in una classe derivata, ottiene la raccolta di cookie inviati dal client.When overridden in a derived class, gets the collection of cookies that were sent by the client.

CurrentExecutionFilePath

Sottoposta a override in una classe derivata, ottiene il percorso virtuale della richiesta corrente.When overridden in a derived class, gets the virtual path of the current request.

CurrentExecutionFilePathExtension

Implementata in una classe derivata, ottiene l'estensione del nome file specificato nella proprietà CurrentExecutionFilePath.When implemented in a derived class, gets the extension of the file name that is specified in the CurrentExecutionFilePath property.

FilePath

Sottoposta a override in una classe derivata, ottiene il percorso virtuale della richiesta corrente.When overridden in a derived class, gets the virtual path of the current request.

Files

Sottoposta a override in una classe derivata, ottiene l'insieme dei file caricati dal client, in formato MIME multipart.When overridden in a derived class, gets the collection of files that were uploaded by the client, in multipart MIME format.

Filter

Sottoposto a override in una classe derivata, ottiene o imposta il filtro da utilizzare per la lettura del flusso di input corrente.When overridden in a derived class, gets or sets the filter to use when the current input stream is being read.

Form

Sottoposta a override in una classe derivata, ottiene l'insieme di variabili dei form inviate dal client.When overridden in a derived class, gets the collection of form variables that were sent by the client.

Headers

Sottoposta a override in una classe derivata, ottiene l'insieme di intestazioni HTTP inviate dal client.When overridden in a derived class, gets the collection of HTTP headers that were sent by the client.

HttpChannelBinding

Se sottoposta a override in una classe derivata, ottiene l'oggetto ChannelBinding per l'istanza corrente di HttpWorkerRequest.When overridden in a derived class, gets the ChannelBinding object of the current HttpWorkerRequest instance.

HttpMethod

Sottoposta a override in una classe derivata, ottiene il metodo di trasferimento dei dati HTTP, quale ad esempio GET, POST o HEAD, utilizzato dal 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

Sottoposta a override in una classe derivata, ottiene il contenuto del corpo dell'entità HTTP in arrivo.When overridden in a derived class, gets the contents of the incoming HTTP entity body.

IsAuthenticated

Sottoposta a override in una classe derivata, ottiene un valore che indica se la richiesta è stata autenticata.When overridden in a derived class, gets a value that indicates whether the request has been authenticated.

IsLocal

Se sottoposto a override in una classe derivata, ottiene un valore che specifica se la richiesta proviene dal computer locale.When overridden in a derived class, gets a value that indicates whether the request is from the local computer.

IsSecureConnection

Sottoposta a override in una classe derivata, ottiene un valore che indica se per la connessione HTTP viene utilizzato il protocollo HTTPS (Secure Sockets).When overridden in a derived class, gets a value that indicates whether the HTTP connection uses secure sockets (HTTPS protocol).

Item[String]

Sottoposta a override in una classe derivata, ottiene l'oggetto specificato dall'insieme Cookies, Form, QueryString o ServerVariables.When overridden in a derived class, gets the specified object from the Cookies, Form, QueryString, or ServerVariables collections.

LogonUserIdentity

Sottoposta a override in una classe derivata, ottiene il tipo WindowsIdentity per l'utente corrente.When overridden in a derived class, gets the WindowsIdentity type for the current user.

Params

Sottoposto a override in una classe derivata, ottiene un insieme combinato di elementi QueryString, Form, ServerVariables e Cookies.When overridden in a derived class, gets a combined collection of QueryString, Form, ServerVariables, and Cookies items.

Path

Sottoposta a override in una classe derivata, ottiene il percorso virtuale della richiesta corrente.When overridden in a derived class, gets the virtual path of the current request.

PathInfo

Sottoposto a override in una classe derivata, ottiene informazioni aggiuntive sul percorso per una risorsa con estensione URL.When overridden in a derived class, gets additional path information for a resource that has a URL extension.

PhysicalApplicationPath

Sottoposta a override in una classe derivata, ottiene il percorso fisico del file system della directory radice dell'applicazione corrente.When overridden in a derived class, gets the physical file-system path of the current application's root directory.

PhysicalPath

Sottoposta a override in una classe derivata, ottiene il percorso fisico del file system della risorsa richiesta.When overridden in a derived class, gets the physical file-system path of the requested resource.

QueryString

Sottoposta a override in una classe derivata, ottiene l'insieme delle variabili di stringa di query HTTP.When overridden in a derived class, gets the collection of HTTP query-string variables.

RawUrl

Sottoposta a override in una classe derivata, ottiene l'URL completo della richiesta corrente.When overridden in a derived class, gets the complete URL of the current request.

ReadEntityBodyMode

Una volta eseguita l'implementazione in una classe derivata, ottiene un valore che indica se il corpo di entità della richiesta è stato letto e in caso affermativo, la modalità di lettura.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

Se sottoposta a override in una classe derivata, ottiene l'istanza di RequestContext per la richiesta corrente.When overridden in a derived class, gets the RequestContext instance of the current request.

RequestType

Sottoposto a override in una classe derivata, ottiene o imposta il metodo di trasferimento dei dati HTTP (GET o POST) utilizzato dal 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

Sottoposta a override in una classe derivata, ottiene un insieme di variabili server Web.When overridden in a derived class, gets a collection of Web server variables.

TimedOutToken

Quando implementato in una classe derivata, ottiene un oggetto CancellationToken che viene attivato quando scade una richiesta.When implemented in a derived class, gets a CancellationToken object that is tripped when a request times out.

TlsTokenBindingInfo

Ottiene o imposta le informazioni di associazione di token per questa istanza.Gets or sets the token binding information for this instance.

TotalBytes

Sottoposta a override in una classe derivata, ottiene il numero di byte nel flusso di input corrente.When overridden in a derived class, gets the number of bytes in the current input stream.

Unvalidated

Una volta eseguita l'implementazione in una classe derivata, fornisce l'accesso ai valori di richiesta HTTP senza attivare la convalida delle richieste.When implemented in a derived class, provides access to HTTP request values without triggering request validation.

Url

Sottoposta a override in una classe derivata, ottiene informazioni sull'URL della richiesta corrente.When overridden in a derived class, gets information about the URL of the current request.

UrlReferrer

Sottoposta a override in una classe derivata, ottiene informazioni relative all'URL della richiesta del client collegato all'URL corrente.When overridden in a derived class, gets information about the URL of the client request that linked to the current URL.

UserAgent

Sottoposta a override in una classe derivata, ottiene la stringa dell'agente utente completa del client.When overridden in a derived class, gets the complete user-agent string of the client.

UserHostAddress

Sottoposta a override in una classe derivata, ottiene l'indirizzo host IP del client.When overridden in a derived class, gets the IP host address of the client.

UserHostName

Sottoposta a override in una classe derivata, ottiene il nome DNS del client.When overridden in a derived class, gets the DNS name of the client.

UserLanguages

Sottoposta a override in una classe derivata, ottiene una matrice ordinata di preferenze linguistiche del client.When overridden in a derived class, gets a sorted array of client language preferences.

Metodi

Abort()

Termina forzatamente la connessione TCP sottostante, causando l'esito negativo di eventuali operazioni di I/O.Forcibly terminates the underlying TCP connection, causing any outstanding I/O to fail.

BinaryRead(Int32)

Sottoposto a override in una classe derivata, esegue una lettura binaria di un determinato numero di byte provenienti dal flusso di input corrente.When overridden in a derived class, performs a binary read of a specified number of bytes from the current input stream.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetBufferedInputStream()

Una volta eseguita l'implementazione in una classe derivata, ottiene un oggetto di Stream che può essere utilizzato per leggere il corpo dell'entità HTTP in entrata.When implemented in a derived class, gets a Stream object that can be used to read the incoming HTTP entity body.

GetBufferlessInputStream()

Una volta eseguita l'implementazione in una classe derivata, ottiene un oggetto di Stream che può essere utilizzato per leggere il corpo di entità in ingresso HTTP, facoltativamente disabilitando il limite di lunghezza della richiesta impostato nella proprietà di 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)

Una volta eseguita l'implementazione in una classe derivata, ottiene un oggetto di Stream che può essere utilizzato per leggere il corpo di entità in ingresso HTTP, facoltativamente disabilitando il limite di lunghezza della richiesta impostato nella proprietà di 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()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
InsertEntityBody()

Una volta eseguita l'implementazione in una classe derivata, fornisce una copia del corpo di entità delle richieste HTTP in IIS.When implemented in a derived class, provides a copy of the HTTP request entity body to IIS.

InsertEntityBody(Byte[], Int32, Int32)

Se implementata in una classe derivata, fornisce a IIS una copia del corpo dell'entità di richiesta HTTP nonché le informazioni sull'oggetto entità di richiesta.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)

Sottoposto a override in una classe derivata, esegue il mapping di un parametro form del campo immagine in arrivo ai valori appropriati delle coordinate x e y.When overridden in a derived class, maps an incoming image-field form parameter to appropriate x-coordinate and y-coordinate values.

MapPath(String)

Sottoposto a override in una classe derivata, esegue il mapping del percorso virtuale specificato a un percorso fisico sul server.When overridden in a derived class, maps the specified virtual path to a physical path on the server.

MapPath(String, String, Boolean)

Sottoposto a override in una classe derivata, esegue il mapping del percorso virtuale specificato a un percorso fisico sul server.When overridden in a derived class, maps the specified virtual path to a physical path on the server.

MapRawImageCoordinates(String)

Associa un parametro form del campo immagine in arrivo ai valori appropriati delle coordinate x e y.Maps an incoming image field form parameter into appropriate x and y coordinate values.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
SaveAs(String, Boolean)

Sottoposto a override in una classe derivata, salva una richiesta HTTP su disco.When overridden in a derived class, saves an HTTP request to disk.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)
ValidateInput()

Sottoposto a override in una classe derivata, determina la convalida degli insiemi a cui si accede mediante le proprietà Cookies, Form e QueryString.When overridden in a derived class, causes validation to occur for the collections that are accessed through the Cookies, Form, and QueryString properties.

Si applica a