HttpServerUtility Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Fornece métodos auxiliares para o processamento de pedidos na Web.
public ref class HttpServerUtility sealed
public sealed class HttpServerUtility
type HttpServerUtility = class
Public NotInheritable Class HttpServerUtility
- Herança
-
HttpServerUtility
Exemplos
O exemplo seguinte demonstra como usar o HtmlEncode método e o UrlEncode método da HttpServerUtility turma. O HtmlEncode método ajuda a garantir que qualquer entrada de string fornecida pelo utilizador será renderizada como texto estático nos navegadores, em vez de script executável ou elementos HTML. O UrlEncode método codifica URLs para que 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>
Observações
Os métodos e propriedades da classe HttpServerUtility são expostos através do objeto intrínseco Server fornecido por ASP.NET.
Propriedades
| Name | Description |
|---|---|
| MachineName |
Fica com o nome do computador do servidor. |
| ScriptTimeout |
Recebe ou define o valor de time-out do pedido em segundos. |
Métodos
| Name | Description |
|---|---|
| ClearError() |
Elimina a exceção anterior. |
| CreateObject(String) |
Cria uma instância de servidor de um objeto COM identificado pelo identificador programático do objeto (ProgID). |
| CreateObject(Type) |
Cria uma instância de servidor de um objeto COM identificada pelo tipo do objeto. |
| CreateObjectFromClsid(String) |
Cria uma instância de servidor de um objeto COM identificado pelo identificador de classe do objeto (CLSID). |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| Execute(IHttpHandler, TextWriter, Boolean) |
Executa o handler para o caminho virtual especificado no contexto do pedido atual. A TextWriter captura a saída do handler executado e um parâmetro booleano especifica se deve limpar as QueryString coleções e Form . |
| Execute(String, Boolean) |
Executa o handler para o caminho virtual especificado no contexto do pedido atual e especifica se deve limpar as QueryString coleções e Form . |
| Execute(String, TextWriter, Boolean) |
Executa o handler para o caminho virtual especificado no contexto do pedido atual. A TextWriter captura a saída da página e um parâmetro booleano especifica se deve apagar as QueryString coleções e Form . |
| Execute(String, TextWriter) |
Executa o handler para o caminho virtual especificado no contexto do pedido atual. A TextWriter captura a saída do manipulador executado. |
| Execute(String) |
Executa o handler para o caminho virtual especificado no contexto do pedido atual. |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetLastError() |
Devolve a exceção anterior. |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| HtmlDecode(String, TextWriter) |
Descodifica uma cadeia codificada em HTML e envia a saída resultante para um TextWriter fluxo de saída. |
| HtmlDecode(String) |
Descodifica uma cadeia codificada em HTML e devolve a cadeia decodificada. |
| HtmlEncode(String, TextWriter) |
O HTML codifica uma cadeia e envia a saída resultante para um TextWriter fluxo de saída. |
| HtmlEncode(String) |
HTML codifica uma cadeia e devolve a cadeia codificada. |
| MapPath(String) |
Devolve o caminho físico do ficheiro que corresponde ao caminho virtual especificado. |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
| Transfer(IHttpHandler, Boolean) |
Termina a execução da página atual e inicia a execução de um novo pedido usando um handler HTTP personalizado que implementa a IHttpHandler interface e especifica se deve limpar as QueryString coleções and Form . |
| Transfer(String, Boolean) |
Termina a execução da página atual e inicia a execução de uma nova página usando o caminho URL especificado da página. Especifica se deve limpar as QueryString coleções e.Form |
| Transfer(String) |
Para o pedido atual, termina a execução da página atual e inicia a execução de uma nova página usando o caminho URL especificado da página. |
| TransferRequest(String, Boolean, String, NameValueCollection, Boolean) |
Realiza uma execução assíncrona do URL especificado usando o método HTTP especificado, cabeçalhos e caminho, e opcionalmente preserva os valores do formulário e a identidade do utilizador. |
| TransferRequest(String, Boolean, String, NameValueCollection) |
Realiza uma execução assíncrona da URL especificada usando o método HTTP e os cabeçalhos especificados. |
| TransferRequest(String, Boolean) |
Realiza uma execução assíncrona da URL especificada e preserva os parâmetros da cadeia de consulta. |
| TransferRequest(String) |
Realiza uma execução assíncrona da URL especificada. |
| UrlDecode(String, TextWriter) |
Descodifica uma string HTML recebida numa URL e envia a saída resultante para um TextWriter fluxo de saída. |
| UrlDecode(String) |
URL decodifica uma cadeia e devolve a cadeia decodificada. |
| UrlEncode(String, TextWriter) |
O URL codifica uma cadeia e envia a saída resultante para um TextWriter fluxo de saída. |
| UrlEncode(String) |
URL codifica uma cadeia e devolve a cadeia codificada. |
| UrlPathEncode(String) |
Não usar; destinado apenas à compatibilidade do navegador. Utilize UrlEncode(String). |
| UrlTokenDecode(String) |
Descodifica um token de string de URL para o seu array de bytes equivalente usando a base de 64 dígitos. |
| UrlTokenEncode(Byte[]) |
Codifica um array de bytes na sua representação equivalente de cadeias usando a base 64 dígitos, que é utilizável para transmissão na URL. |