HttpRequest Classe

Definição

Namespace:: System.Web

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Permite que ASP.NET leia os valores HTTP enviados por um cliente durante uma solicitação da Web.

public ref class HttpRequest sealed

public sealed class HttpRequest

type HttpRequest = class

Public NotInheritable Class HttpRequest

Herança: Object
HttpRequest

Exemplos

Os exemplos a seguir acessam a HttpRequest instância da solicitação atual usando a Request propriedade da Page classe.

Você pode usar a sintaxe simplificada para acessar dados das QueryStringcoleções, Form Cookiesdas coleções.ServerVariables Você pode escrever Request["key"].

O primeiro exemplo mostra como recuperar um valor de cadeia de caracteres de consulta ao carregar uma página.

public partial class AddToCart : Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        string rawId = Request["ProductID"];
        int productId;
        if (!String.IsNullOrEmpty(rawId) && int.TryParse(rawId, out productId))
        {
            using (ShoppingCartActions usersShoppingCart = new ShoppingCartActions())
            {
                usersShoppingCart.AddToCart(productId);
            }
        }
        else
        {
            throw new Exception("Tried to call AddToCart.aspx without setting a ProductId.");
        }
        Response.Redirect("ShoppingCart.aspx");
    }
}

Public Class AddToCart
    Inherits Page

    Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) Handles Me.Load
        Dim rawId = Request("ProductID")
        Dim productId As Integer
        If Not String.IsNullOrEmpty(rawId) And Integer.TryParse(rawId, productId) Then
            Using usersShoppingCart As New ShoppingCartActions()
                usersShoppingCart.AddToCart(productId)
            End Using

        Else
            Throw New Exception("Tried to call AddToCart.aspx without setting a ProductId.")
        End If
        Response.Redirect("ShoppingCart.aspx")
    End Sub
End Class

O exemplo a seguir mostra como verificar se a solicitação está autenticada e recuperar a URL bruta.

public partial class RestrictedPage : Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        if (!Request.IsAuthenticated)
        {
            var rawUrl = Request.RawUrl;
            Response.Redirect("/Account/Login?ru=" + Server.HtmlEncode(rawUrl));
        }
    }
}

Public Class RestrictedPage
    Inherits Page

    Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) Handles Me.Load
        If Not Request.IsAuthenticated Then
            Dim rawUrl = Request.RawUrl
            Response.Redirect("/Account/Login?ru=" + Server.HtmlEncode(rawUrl))
        End If
    End Sub
End Class

Este exemplo usa a StreamWriter classe para gravar os valores de várias HttpRequest propriedades de classe em um arquivo. Para propriedades que são do tipo cadeia de caracteres, os valores são codificados em HTML conforme são gravados no arquivo. As propriedades que representam uma coleção são executadas em loop e cada par chave/valor que elas contêm é gravado no arquivo.

Importante

Este exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma potencial ameaça à segurança. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos de script ou HTML. Para obter mais informações, consulte Visão geral das Explorações de Script.

<%@ Page Language="C#" %>
<%@ import Namespace="System.Threading" %>
<%@ import Namespace="System.IO" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

    /* NOTE: To use this sample, create a c:\temp\CS folder,
    *  add the ASP.NET account (in IIS 5.x <machinename>\ASPNET,
    *  in IIS 6.x NETWORK SERVICE), and give it write permissions
    *  to the folder.*/

    private const string INFO_DIR = @"c:\temp\CS\RequestDetails";
    public static int requestCount;

    private void Page_Load(object sender, System.EventArgs e)
    {

        // Create a variable to use when iterating
        // through the UserLanguages property.
        int langCount;

        int requestNumber = Interlocked.Increment(ref requestCount);

        // Create the file to contain information about the request.
        string strFilePath = INFO_DIR + requestNumber.ToString() + @".txt";


        StreamWriter sw = File.CreateText(strFilePath);

        try
        {
// <snippet2>
            // Write request information to the file with HTML encoding.
            sw.WriteLine(Server.HtmlEncode(DateTime.Now.ToString()));
            sw.WriteLine(Server.HtmlEncode(Request.CurrentExecutionFilePath));
            sw.WriteLine(Server.HtmlEncode(Request.ApplicationPath));
            sw.WriteLine(Server.HtmlEncode(Request.FilePath));
            sw.WriteLine(Server.HtmlEncode(Request.Path));
// </snippet2>

// <snippet3>
            // Iterate through the Form collection and write
            // the values to the file with HTML encoding.
            // String[] formArray = Request.Form.AllKeys;
            foreach (string s in Request.Form)
            {
                sw.WriteLine("Form: " + Server.HtmlEncode(s));
            }
// </snippet3>

// <snippet4>
            // Write the PathInfo property value
            // or a string if it is empty.
            if (Request.PathInfo == String.Empty)
            {
                sw.WriteLine("The PathInfo property contains no information.");
            }
            else
            {
                sw.WriteLine(Server.HtmlEncode(Request.PathInfo));
            }
// </snippet4>

// <snippet5>
            // Write request information to the file with HTML encoding.
            sw.WriteLine(Server.HtmlEncode(Request.PhysicalApplicationPath));
            sw.WriteLine(Server.HtmlEncode(Request.PhysicalPath));
            sw.WriteLine(Server.HtmlEncode(Request.RawUrl));
// </snippet5>

// <snippet6>
            // Write a message to the file dependent upon
            // the value of the TotalBytes property.
            if (Request.TotalBytes > 1000)
            {
                sw.WriteLine("The request is 1KB or greater");
            }
            else
            {
                sw.WriteLine("The request is less than 1KB");
            }
// </snippet6>

// <snippet7>
            // Write request information to the file with HTML encoding.
            sw.WriteLine(Server.HtmlEncode(Request.RequestType));
            sw.WriteLine(Server.HtmlEncode(Request.UserHostAddress));
            sw.WriteLine(Server.HtmlEncode(Request.UserHostName));
            sw.WriteLine(Server.HtmlEncode(Request.HttpMethod));
// </snippet7>

// <snippet8>
            // Iterate through the UserLanguages collection and
            // write its HTML encoded values to the file.
            for (langCount=0; langCount < Request.UserLanguages.Length; langCount++)
            {
                sw.WriteLine(@"User Language " + langCount +": " + Server.HtmlEncode(Request.UserLanguages[langCount]));
            }
// </snippet8>
       }

       finally
       {
            // Close the stream to the file.
            sw.Close();
       }

        lblInfoSent.Text = "Information about this request has been sent to a file.";
    }


    private void btnSendInfo_Click(object sender, System.EventArgs e)
    {
        lblInfoSent.Text = "Hello, " + Server.HtmlEncode(txtBoxName.Text) +
          ". You have created a new  request info file.";
    }

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <p>
        </p>
        <p>
            Enter your name here:
            <asp:TextBox id="txtBoxName" runat="server"></asp:TextBox>
        </p>
        <p>
            <asp:Button id="btnSendInfo" onclick="btnSendInfo_Click" runat="server" Text="Click Here"></asp:Button>
        </p>
        <p>
            <asp:Label id="lblInfoSent" runat="server"></asp:Label>
        </p>
    </form>
</body>
</html>

<%@ Page Language="VB" %>
<%@ import Namespace="System.Threading" %>
<%@ import Namespace="System.IO" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

    '  NOTE: To use this sample, create a c:\temp\CS folder,
    '  add the ASP.NET account (in IIS 5.x <machinename>\ASPNET,
    '  in IIS 6.x NETWORK SERVICE), and give it write permissions
    '  to the folder.

    Private Const INFO_DIR As String = "c:\temp\VB\RequestDetails"
    Public Shared requestCount As Integer

    Private Sub Page_Load(sender As Object, e As System.EventArgs)

        ' Create a variable to use when iterating
        ' through the UserLanguages property.
        Dim langCount As Integer

        ' Create a counter to name the file.
        Dim requestNumber As Integer = _
          Interlocked.Increment(requestCount)

        ' Create the file to contain information about the request.
        Dim strFilePath As String = INFO_DIR & requestNumber.ToString() & ".txt"
        Dim sw As StreamWriter = File.CreateText(strFilePath)

        Try

' <snippet2>
            ' Write request information to the file with HTML encoding.
            sw.WriteLine(Server.HtmlEncode(DateTime.Now.ToString()))
            sw.WriteLine(Server.HtmlEncode(Request.CurrentExecutionFilePath))
            sw.WriteLine(Server.HtmlEncode(Request.ApplicationPath))
            sw.WriteLine(Server.HtmlEncode(Request.FilePath))
            sw.WriteLine(Server.HtmlEncode(Request.Path))
' </snippet2>

' <snippet3>
            ' Iterate through the Form collection and write
            ' the values to the file with HTML encoding.
            For Each s As String In Request.Form
                sw.WriteLine("Form: " & Server.HtmlEncode(s))
            Next s
' </snippet3>

' <snippet4>
            ' Write the PathInfo property value
            ' or a string if it is empty.
            If Request.PathInfo = String.Empty Then
                sw.WriteLine("The PathInfo property contains no information.")
            Else
                sw.WriteLine(Server.HtmlEncode(Request.PathInfo))
            End If
' </snippet4>

' <snippet5>
            ' Write request information to the file with HTML encoding.
            sw.WriteLine(Server.HtmlEncode(Request.PhysicalApplicationPath))
            sw.WriteLine(Server.HtmlEncode(Request.PhysicalPath))
            sw.WriteLine(Server.HtmlEncode(Request.RawUrl))
' </snippet5>

' <snippet6>
            ' Write a message to the file dependent upon
            ' the value of the TotalBytes property.
            If Request.TotalBytes > 1000 Then
                sw.WriteLine("The request is 1KB or greater")
            Else
                sw.WriteLine("The request is less than 1KB")
            End If
' </snippet6>

' <snippet7>
            ' Write request information to the file with HTML encoding.
            sw.WriteLine(Server.HtmlEncode(Request.RequestType))
            sw.WriteLine(Server.HtmlEncode(Request.UserHostAddress))
            sw.WriteLine(Server.HtmlEncode(Request.UserHostName))
            sw.WriteLine(Server.HtmlEncode(Request.HttpMethod))
' </snippet7>

' <snippet8>
            ' Iterate through the UserLanguages collection and
            ' write its HTML encoded values to the file.
            For langCount = 0 To Request.UserLanguages.Length - 1
                sw.WriteLine("User Language " & langCount.ToString() & _
                 ": " & Server.HtmlEncode( _
                     Request.UserLanguages(langCount)))
            Next
' </snippet8>

        Finally
            ' Close the stream to the file.
            sw.Close()
        End Try

        lblInfoSent.Text = _
         "Information about this request has been sent to a file."
    End Sub 'Page_Load



    Private Sub btnSendInfo_Click(sender As Object, e As System.EventArgs)
        lblInfoSent.Text = _
         "Hello, " & Server.HtmlEncode(txtBoxName.Text) & _
          ". You have created a new  request info file."
    End Sub 'btnSendInfo_Click

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <p>
        </p>
        <p>
            Enter your name here:
            <asp:TextBox id="txtBoxName" runat="server"></asp:TextBox>
        </p>
        <p>
            <asp:Button id="btnSendInfo" onclick="btnSendInfo_Click" runat="server" Text="Click Here"></asp:Button>
        </p>
        <p>
            <asp:Label id="lblInfoSent" runat="server"></asp:Label>
        </p>
    </form>
</body>
</html>

Comentários

Os métodos e as propriedades da HttpRequest classe são expostos por meio das Request propriedades do HttpApplication, HttpContexte Page UserControl das classes.

Para acessar dados das QueryStringcoleções , ou Cookies ServerVariables , Formvocê pode escreverRequest["key"], conforme mostrado no exemplo da QueryString propriedade.

Observação

O suporte unicode para HttpRequest membros da classe requer o IIS versão 6.0 ou posterior.

Construtores

Nome	Description
HttpRequest(String, String, String)	Inicializa um HttpRequest objeto.

Propriedades

Nome	Description
AcceptTypes	Obtém uma matriz de cadeia de caracteres de tipos de aceitação MIME compatíveis com o cliente.
AnonymousID	Obtém o identificador anônimo para o usuário, se presente.
ApplicationPath	Obtém o caminho raiz do aplicativo virtual do aplicativo ASP.NET no servidor.
AppRelativeCurrentExecutionFilePath	Obtém o caminho virtual da raiz do aplicativo e o torna relativo usando a notação til (~) para a raiz do aplicativo (como em "~/page.aspx").
Browser	Obtém ou define informações sobre os recursos do navegador do cliente solicitante.
ClientCertificate	Obtém o certificado de segurança do cliente da solicitação atual.
ContentEncoding	Obtém ou define o conjunto de caracteres do corpo da entidade.
ContentLength	Especifica o comprimento, em bytes, do conteúdo enviado pelo cliente.
ContentType	Obtém ou define o tipo de conteúdo MIME da solicitação de entrada.
Cookies	Obtém uma coleção de cookies enviados pelo cliente.
CurrentExecutionFilePath	Obtém o caminho virtual da solicitação atual.
CurrentExecutionFilePathExtension	Obtém a extensão do nome do arquivo especificado na CurrentExecutionFilePath propriedade.
FilePath	Obtém o caminho virtual da solicitação atual.
Files	Obtém a coleção de arquivos carregados pelo cliente, no formato MIME de várias partes.
Filter	Obtém ou define o filtro a ser usado ao ler o fluxo de entrada atual.
Form	Obtém uma coleção de variáveis de formulário.
Headers	Obtém uma coleção de cabeçalhos HTTP.
HttpChannelBinding	Obtém o ChannelBinding objeto da instância atual HttpWorkerRequest .
HttpMethod	Obtém o método de transferência de dados HTTP (como `GET`, `POST`ou `HEAD`) usado pelo cliente.
InputStream	Obtém o conteúdo do corpo da entidade HTTP de entrada.
IsAuthenticated	Obtém um valor que indica se a solicitação foi autenticada.
IsLocal	Obtém um valor que indica se a solicitação é do computador local.
IsSecureConnection	Obtém um valor que indica se a conexão HTTP usa soquetes seguros (ou seja, HTTPS).
Item[String]	Obtém o objeto especificado de QueryString, Form, Cookiesou ServerVariables coleções.
LogonUserIdentity	Obtém o WindowsIdentity tipo do usuário atual.
Params	Obtém uma coleção combinada de QueryString, Forme Cookies ServerVariables itens.
Path	Obtém o caminho virtual da solicitação atual.
PathInfo	Obtém as informações de caminho adicionais para um recurso com uma extensão de URL.
PhysicalApplicationPath	Obtém o caminho do sistema de arquivos físico do diretório raiz do aplicativo de servidor em execução no momento.
PhysicalPath	Obtém o caminho do sistema de arquivos físico correspondente à URL solicitada.
QueryString	Obtém a coleção de variáveis de cadeia de caracteres de consulta HTTP.
RawUrl	Obtém a URL bruta da solicitação atual.
ReadEntityBodyMode	Obtém um valor que indica se o corpo da entidade de solicitação foi lido e, em caso afirmativo, como ele foi lido.
RequestContext	Obtém a RequestContext instância da solicitação atual.
RequestType	Obtém ou define o método de transferência de dados HTTP (`GET` ou `POST`) usado pelo cliente.
ServerVariables	Obtém uma coleção de variáveis de servidor Web.
TimedOutToken	Obtém um CancellationToken objeto que é tropeçado quando uma solicitação atinge o tempo limite.
TlsTokenBindingInfo	Obtém as informações de associação de token TLS. A propriedade permite que os aplicativos recuperem informações de token de solicitações HTTP de entrada para autenticação aprimorada.
TotalBytes	Obtém o número de bytes no fluxo de entrada atual.
Unvalidated	Obtém os valores de solicitação HTTP sem disparar a validação da solicitação.
Url	Obtém informações sobre a URL da solicitação atual.
UrlReferrer	Obtém informações sobre a URL da solicitação anterior do cliente vinculada à URL atual.
UserAgent	Obtém a cadeia de caracteres de agente de usuário bruto do navegador do cliente que foi fornecido. Observe que pode ser nulo.
UserHostAddress	Obtém o endereço de host IP do cliente remoto.
UserHostName	Obtém o nome DNS do cliente remoto.
UserLanguages	Obtém uma matriz de cadeia de caracteres classificada de preferências de idioma do cliente.

Métodos

Nome	Description
Abort()	Encerra à força a conexão TCP subjacente, fazendo com que qualquer E/S pendente falhe. Você pode usar esse método em resposta a um ataque de um cliente HTTP mal-intencionado.
BinaryRead(Int32)	Executa uma leitura binária de um número especificado de bytes do fluxo de entrada atual.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetBufferedInputStream()	Obtém um Stream objeto que pode ser usado para ler o corpo da entidade HTTP de entrada.
GetBufferlessInputStream()	Obtém um Stream objeto que pode ser usado para ler o corpo da entidade HTTP de entrada.
GetBufferlessInputStream(Boolean)	Obtém um Stream objeto que pode ser usado para ler o corpo da entidade HTTP de entrada, opcionalmente desabilitando o limite de comprimento da solicitação definido na MaxRequestLength propriedade.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InsertEntityBody()	Fornece ao IIS uma cópia do corpo da entidade de solicitação HTTP.
InsertEntityBody(Byte[], Int32, Int32)	Fornece ao IIS uma cópia do corpo da entidade de solicitação HTTP e informações sobre o objeto de entidade de solicitação.
MapImageCoordinates(String)	Mapeia um parâmetro de formulário de campo de imagem de entrada para valores de coordenada x e coordenada y apropriados.
MapPath(String, String, Boolean)	Mapeia o caminho virtual especificado para um caminho físico.
MapPath(String)	Mapeia o caminho virtual especificado para um caminho físico.
MapRawImageCoordinates(String)	Mapeia um parâmetro de formulário de campo de imagem de entrada em valores de coordenadas x e y apropriados.
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
SaveAs(String, Boolean)	Salva uma solicitação HTTP no disco.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
ValidateInput()	Faz com que a validação ocorra para as coleções acessadas por meio do Cookies, Forme QueryString das propriedades.

Aplica-se a

Comentários

Esta página foi útil?

Partilhar via

HttpRequest Classe

Definição

Exemplos

Comentários

Construtores

Propriedades

Métodos

Aplica-se a

Comentários