Home Biblioteca Aprender Galeria Downloads Suporte Comunidade Fóruns
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original
Este tópico ainda não foi avaliado como - Avalie este tópico

Classe HttpRequest

.NET Framework 4.5

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

System.Object
  System.Web.HttpRequest

Namespace:  System.Web
Assembly:  System.Web (em System.Web.dll)
C#
C++
F#
VB
Copiar 
public sealed class HttpRequest

O tipo HttpRequest expõe os membros a seguir.

  NomeDescrição
Método públicoHttpRequestInfraestrutura. inicializa um objeto de HttpRequest .
Superior
  NomeDescrição
Propriedade públicaAcceptTypesObtém uma matriz de cadeias de caracteres de MIME cliente que aceitam tipos.
Propriedade públicaAnonymousIDObtém o identificador anônimo para o usuário, se presente.
Propriedade públicaApplicationPathObtém o caminho virtual da raiz do aplicativo de aplicativo do ASP.NET no servidor.
Propriedade públicaAppRelativeCurrentExecutionFilePathObtém o caminho virtual da raiz do aplicativo e o torna relativo usando o caractere til (~) notação para a raiz do aplicativo (como em ~/page.aspx “”).
Propriedade públicaBrowserObtém ou define informações sobre os recursos do navegador do cliente solicitante.
Propriedade públicaClientCertificateObtém o certificado de segurança atual do cliente de solicitação.
Propriedade públicaContentEncodingObtém ou define o conjunto de caracteres de entidade- corpo.
Propriedade públicaContentLengthEspecifica o tamanho, em bytes, do conteúdo enviados pelo cliente.
Propriedade públicaContentTypeObtém ou define o tipo MIME de conteúdo da solicitação de entrada.
Propriedade públicaCookiesObtém uma coleção de cookies enviadas pelo cliente.
Propriedade públicaCurrentExecutionFilePathObtém o caminho virtual da solicitação atual.
Propriedade públicaCurrentExecutionFilePathExtensionObtém a extensão de nome de arquivo especificado na propriedade de CurrentExecutionFilePath .
Propriedade públicaFilePathObtém o caminho virtual da solicitação atual.
Propriedade públicaFilesObtém a coleção de arquivos carregados pelo cliente, no formato de várias partes de MIME.
Propriedade públicaFilterObtém ou define o filtro a ser usado ao ler o fluxo de entrada atual.
Propriedade públicaFormObtém uma coleção de variáveis do formulário.
Propriedade públicaHeadersObtém uma coleção de cabeçalhos HTTP.
Propriedade públicaHttpChannelBindingObtém o objeto de ChannelBinding da instância atual de HttpWorkerRequest .
Propriedade públicaHttpMethodObtém o método de transferência de dados HTTP (como GET, POST, ou HEAD) usado pelo cliente.
Propriedade públicaInputStreamObtém o conteúdo do corpo de entrada de entidade HTTP.
Propriedade públicaIsAuthenticatedObtém um valor indicando se a solicitação foi autenticada.
Propriedade públicaIsLocalObtém um valor indicando se a solicitação for do computador local.
Propriedade públicaIsSecureConnectionObtém um valor indicando se os usos de conexão HTTP protegem os soquetes (isto é, HTTPS).
Propriedade públicaItemObtém o objeto especificado de QueryString, de Form, de Cookies, ou das coleções de ServerVariables .
Propriedade públicaLogonUserIdentityObtém o tipo de WindowsIdentity para o usuário atual.
Propriedade públicaParamsObtém uma coleção de QueryStringcombinada, de Form, de Cookies, e itens de ServerVariables .
Propriedade públicaPathObtém o caminho virtual da solicitação atual.
Propriedade públicaPathInfoObtém as informações de caminho adicional para um recurso com uma extensão URL.
Propriedade públicaPhysicalApplicationPathObtém o caminho físico do sistema de arquivos do diretório raiz do aplicativo para servidores atualmente em execução.
Propriedade públicaPhysicalPathObtém o caminho do sistema de arquivo físico que corresponde à URL solicitada.
Propriedade públicaQueryStringObtém a coleção de variáveis de cadeia de caracteres de consulta HTTP.
Propriedade públicaRawUrlObtém o URL " bruto " da solicitação atual.
Propriedade públicaReadEntityBodyModeObtém um valor que indica se o corpo da entidade de solicitação foi lido, e em caso afirmativo, como ele foi lido.
Propriedade públicaRequestContextObtém a instância de RequestContext da solicitação atual.
Propriedade públicaRequestTypeObtém ou define o método de transferência de dados HTTP (ou)GETPOSTusado pelo cliente.
Propriedade públicaServerVariablesObtém uma coleção de variáveis do servidor Web.
Propriedade públicaTimedOutTokenObtém um objeto de CancellationToken que é tropeçado quando tempo limite de uma solicitação.
Propriedade públicaTotalBytesObtém o número de bytes no fluxo de entrada atual.
Propriedade públicaUnvalidatedFornece acesso aos valores de solicitação HTTP sem disparar validação de solicitação.
Propriedade públicaUrlObtém informações sobre o URL da solicitação atual.
Propriedade públicaUrlReferrerObtém informações sobre o URL de solicitação anterior de cliente que vinculou à URL atual.
Propriedade públicaUserAgentObtém a cadeia de caracteres " bruto " do agente de usuário do navegador do cliente.
Propriedade públicaUserHostAddressObtém o host de endereço IP de cliente remoto.
Propriedade públicaUserHostNameObtém o nome DNS de cliente remoto.
Propriedade públicaUserLanguagesObtém uma matriz classificada de cadeia de caracteres de preferência de idioma do cliente.
Superior
  NomeDescrição
Método públicoAbortFinaliza forçosamente a conexão subjacente TCP, causando qualquer E/S como falhar.
Método públicoBinaryReadExecuta uma leitura de binária de um número especificado de fluxo de bytes de entrada atual.
Método públicoEquals(Object) Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
Método públicoGetBufferedInputStreamObtém um objeto de Stream que pode ser usado para ler o corpo de entrada de entidade HTTP.
Método públicoGetBufferlessInputStream()Obtém um objeto de Stream que pode ser usado para ler o corpo de entrada de entidade HTTP.
Método públicoGetBufferlessInputStream(Boolean)Obtém um objeto de Stream que pode ser usado para ler o corpo de entrada de entidade HTTP, desativando opcionalmente o limite de solicitação tamanho que é definido na propriedade de MaxRequestLength .
Método públicoGetHashCodeServe como uma função hash para um tipo específico. (Herdado de Object.)
Método públicoGetType Obtém o Type da instância atual. (Herdado de Object.)
Método públicoInsertEntityBody()Fornece o IIS com uma cópia do corpo da entidade de solicitação HTTP.
Método públicoInsertEntityBody(Byte[], Int32, Int32)Fornece o IIS com uma cópia do corpo da entidade de solicitação HTTP e com informações sobre o objeto do objeto de solicitação.
Método públicoMapImageCoordinatesMapeia um parâmetro de entrada de formulário de imagens para campo apropriado valores de coordenada x e y coordenada.
Método públicoMapPath(String)Mapeia o caminho virtual especificado para um caminho físico.
Método públicoMapPath(String, String, Boolean)Mapeia o caminho virtual especificado para um caminho físico.
Método públicoMapRawImageCoordinatesMapeia um parâmetro de entrada de formulário do campo de imagem em valores apropriados de coordenadas x e y.
Método públicoSaveAsSalva uma solicitação HTTP no disco.
Método públicoToStringRetorna uma string que representa o objeto atual. (Herdado de Object.)
Método públicoValidateInputFaz com que a validação ocorre para coleções acessadas através de Cookies, de Form, e propriedades de QueryString .
Superior

Os métodos e propriedades da classe de HttpRequest são expostos através das propriedades de Request de HttpApplication, de HttpContext, de Page, e as classes de UserControl .

ObservaçãoObservação

Suporte a Unicode para membros de classe de HttpRequest requer ao IIS versão 6,0 ou posterior.

TopicLocation
Como: PASS Values Between Páginas Web ASP.NETdv_aspnetcon
Como: Passar valores entre páginas da Web do ASP.NETBuilding ASP .NET Web Applications in Visual Studio
Como: Passar valores entre páginas da Web ASP.NETdv_vwdcon

Um projeto web Visual Studio com o código-fonte está disponível para rastrear este tópico: Baixar.

O exemplo seguinte usa a classe de StreamWriter para gravar os valores de várias propriedades da classe de HttpRequest a um arquivo. Para propriedades que são do tipo cadeia de caracteres, os valores são codificados como HTML são gravados no arquivo. Propriedades que representam uma coleção são fornecidas um loop através de, e cada par chave/valor que contêm são escritas no arquivo. Em a marcação do ASP.NET, a palavra-chave de Request refere-se ao objeto de HttpRequest .

Observação de segurançaObservação de segurança

Este exemplo tem uma caixa de texto que aceita entrada do usuário, que é uma ameaça potencial de segurança. Por padrão, páginas Web ASP.NET validam se as entradas de usuário não incluem scripts ou elementos HTML. Para mais informações, acesse Visão Geral de Scripts Maliciosos.

C#
VB
Copiar 

<%@ 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
        {
            // 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));

            // 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));
            }

            // 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));
            }

            // 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));

            // 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");
            }

            // 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));

            // 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]));
            }
       }

       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>

.NET Framework

Com suporte em: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte .Requisitos de sistema do NET Framework.
Quaisquer membros estático (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.
Isso foi útil para você?
(1500 caracteres restantes)

Contribuições da comunidade

ADICIONAR
© 2013 Microsoft. Todos os direitos reservados.
|
Comentários sobre o site
© 2013 Microsoft. Todos os direitos reservados.