HttpServerUtility Classe
Definição
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.
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
-
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. |