HttpServerUtility Classe

  • Referência

Definição

Namespace:
System.Web
Assembly:
System.Web.dll

Fornece métodos auxiliares para o processamento de solicitações da Web.

public ref class HttpServerUtility sealed
public sealed class HttpServerUtility
type HttpServerUtility = class
Public NotInheritable Class HttpServerUtility
Herança
Object
HttpServerUtility

Exemplos

Um Visual Studio projeto de site da Web com código-fonte está disponível para acompanhar este tópico: Baixar.

O exemplo a seguir demonstra como usar o HtmlEncode método e o UrlEncode método da HttpServerUtility classe. O HtmlEncode método ajuda a garantir que qualquer entrada de cadeia de caracteres fornecida pelo usuário seja renderizada como texto estático em navegadores, em vez de elementos HTML ou script executável. O UrlEncode método codifica URLs para que elas sejam transmitidas corretamente no fluxo HTTP.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    protected void Button1_Click(object sender, EventArgs e)
    {
        if (!String.IsNullOrEmpty(TextBox1.Text))
        {
            // Access the HttpServerUtility methods through
            // the intrinsic Server object.
            Label1.Text = "Welcome, " +
                Server.HtmlEncode(TextBox1.Text) +
                ".<br/> The url is " + 
                Server.UrlEncode(Request.Url.ToString());
        }
    }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HttpServerUtility Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        Enter your name:<br />

        <asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>
        <asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="Submit" />
        <br />
        <asp:Label ID="Label1" runat="server"/>
        </div>
    </form>
</body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    Protected Sub Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)

        If (Not String.IsNullOrEmpty(TextBox1.Text)) Then
            
            ' Access the HttpServerUtility methods through
            ' the intrinsic Server object.
            Label1.Text = "Welcome, " & _
                Server.HtmlEncode(TextBox1.Text) & _
                ".<br/> The url is " & _
                Server.UrlEncode(Request.Url.ToString())
        End If
        
        
        
    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>HttpServerUtility Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        Enter your name:<br />

        <asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>
        <asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="Submit" />
        <br />
        <asp:Label ID="Label1" runat="server"/>
        </div>
    </form>
</body>
</html>

Comentários

Os métodos e as propriedades da HttpServerUtility classe são expostos por meio do objeto intrínseco Server fornecido pelo ASP.NET.

Propriedades

MachineName

Obtém o nome do computador do servidor.
ScriptTimeout

Obtém ou define o valor de tempo limite da solicitação em segundos.

Métodos

ClearError()

Limpa a exceção anterior.
CreateObject(String)

Cria uma instância de servidor de um objeto COM identificado pelo ProgID (identificador programático) do objeto.
CreateObject(Type)

Cria uma instância de servidor de um objeto COM identificado pelo tipo do objeto.
CreateObjectFromClsid(String)

Cria uma instância de servidor de um objeto COM identificado pelo CLSID (identificador de classe) do objeto.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
Execute(IHttpHandler, TextWriter, Boolean)

Executa o manipulador do caminho virtual especificado no contexto da solicitação atual. Um TextWriter captura a saída do manipulador executado e um parâmetro booliano especifica se as coleções QueryString e Form serão limpas.
Execute(String)

Executa o manipulador do caminho virtual especificado no contexto da solicitação atual.
Execute(String, Boolean)

Executa o manipulador do caminho virtual especificado no contexto da solicitação atual e especifica se é necessário limpar as coleções QueryString e Form.
Execute(String, TextWriter)

Executa o manipulador do caminho virtual especificado no contexto da solicitação atual. Um TextWriter captura a saída do manipulador executado.
Execute(String, TextWriter, Boolean)

Executa o manipulador do caminho virtual especificado no contexto da solicitação atual. Um TextWriter captura a saída da página e um parâmetro booliano especifica se as coleções QueryString e Form serão limpas.
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetLastError()

Retorna a exceção anterior.
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
HtmlDecode(String)

Decodifica uma cadeia de caracteres codificada em HTML e retorna a cadeia de caracteres decodificada.
HtmlDecode(String, TextWriter)

Decodifica uma cadeia de caracteres codificada em HTML e envia a saída resultante a um fluxo de saída TextWriter.
HtmlEncode(String)

Codifica uma cadeia de caracteres em HTML e retorna a cadeia de caracteres codificada.
HtmlEncode(String, TextWriter)

Codifica uma cadeia de caracteres em HTML e envia a saída resultante para um fluxo de saída TextWriter.
MapPath(String)

Retorna o caminho de arquivo físico que corresponde ao caminho virtual especificado.
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)
Transfer(IHttpHandler, Boolean)

Finaliza a execução da página atual e inicia a execução de uma nova solicitação usando um manipulador HTTP personalizado, que implementa a interface IHttpHandler e especifica se as coleções QueryString e Form devem ser apagadas.
Transfer(String)

Para a solicitação atual, finaliza a execução da página atual e inicia a execução de uma nova página usando o caminho de URL especificado da página.
Transfer(String, Boolean)

Finaliza a execução da página atual e inicia a execução de uma nova página usando o caminho especificado da URL da página. Especifica se é necessário limpar as coleções QueryString e Form.
TransferRequest(String)

Realiza uma execução assíncrona da URL especificada.
TransferRequest(String, Boolean)

Executa uma execução assíncrona da URL especificada e preserva os parâmetros da cadeia de consulta.
TransferRequest(String, Boolean, String, NameValueCollection)

Realiza a execução assíncrona da URL especificada usando o método HTTP e os cabeçalhos especificados.
TransferRequest(String, Boolean, String, NameValueCollection, Boolean)

Realiza a execução assíncrona da URL especificada usando o caminho, os cabeçalhos e o método HTTP especificados e, opcionalmente, preserva os valores de formulário e a identidade do usuário.
UrlDecode(String)

Decodifica uma cadeia de caracteres em URL e retorna a cadeia de caracteres decodificada.
UrlDecode(String, TextWriter)

Decodifica uma cadeia de caracteres HTML recebida em uma URL e envia a saída resultante para um fluxo de saída TextWriter.
UrlEncode(String)

Codifica uma cadeia de caracteres em URL e retorna a cadeia de caracteres codificada.
UrlEncode(String, TextWriter)

Codifica uma cadeia de caracteres em URL e envia a saída resultante para um fluxo de saída TextWriter.
UrlPathEncode(String)

Não use. Destinado apenas para compatibilidade com o navegador. Use UrlEncode(String).
UrlTokenDecode(String)

Decodifica um token de cadeia de caracteres de URL em sua matriz de bytes equivalente usando dígitos de base 64.
UrlTokenEncode(Byte[])

Codifica uma matriz de bytes em sua representação de cadeia de caracteres equivalente usando dígitos de base 64, que é útil para transmissão na URL.

Aplica-se a

Confira também