HttpServerUtility HttpServerUtility HttpServerUtility HttpServerUtility Class

Definición

Proporciona métodos del asistente para procesar las solicitudes web.Provides helper methods for processing Web requests.

public ref class HttpServerUtility sealed
public sealed class HttpServerUtility
type HttpServerUtility = class
Public NotInheritable Class HttpServerUtility
Herencia
HttpServerUtilityHttpServerUtilityHttpServerUtilityHttpServerUtility

Ejemplos

Un proyecto de sitio web de Visual Studio con código fuente está disponible para acompañar este tema: Descargar.A Visual Studio Web site project with source code is available to accompany this topic: Download.

En el ejemplo siguiente se muestra cómo usar HtmlEncode el método y UrlEncode el método de HttpServerUtility la clase.The following example demonstrates how to use the HtmlEncode method and the UrlEncode method of the HttpServerUtility class. El HtmlEncode método ayuda a garantizar que cualquier entrada de cadena proporcionada por el usuario se representará como texto estático en exploradores en lugar de como scripts ejecutables o elementos HTML.The HtmlEncode method helps ensure that any user-supplied string input will be rendered as static text in browsers instead of executable script or HTML elements. El UrlEncode método codifica las direcciones URL para que se transmitan correctamente en la secuencia http.The UrlEncode method encodes URLs so that they are correctly transmitted in the HTTP stream.

<%@ 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>

Comentarios

Los métodos y las propiedades de HttpServerUtility la clase se exponen Server a través del objeto intrínseco proporcionado por ASP.net.The methods and properties of the HttpServerUtility class are exposed through the intrinsic Server object provided by ASP.NET.

Propiedades

MachineName MachineName MachineName MachineName

Obtiene el nombre del equipo del servidor.Gets the server's computer name.

ScriptTimeout ScriptTimeout ScriptTimeout ScriptTimeout

Obtiene o establece el valor de tiempo de espera de las solicitudes, en segundos.Gets or sets the request time-out value in seconds.

Métodos

ClearError() ClearError() ClearError() ClearError()

Borra la excepción anterior.Clears the previous exception.

CreateObject(String) CreateObject(String) CreateObject(String) CreateObject(String)

Crea una instancia de servidor de un objeto COM identificado mediante su identificador de programación (ProgID).Creates a server instance of a COM object identified by the object's programmatic identifier (ProgID).

CreateObject(Type) CreateObject(Type) CreateObject(Type) CreateObject(Type)

Crea una instancia en el servidor de un objeto COM identificado por el tipo de objeto.Creates a server instance of a COM object identified by the object's type.

CreateObjectFromClsid(String) CreateObjectFromClsid(String) CreateObjectFromClsid(String) CreateObjectFromClsid(String)

Crea una instancia de servidor de un objeto COM identificado por su identificador de clase (CLSID).Creates a server instance of a COM object identified by the object's class identifier (CLSID).

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Execute(IHttpHandler, TextWriter, Boolean) Execute(IHttpHandler, TextWriter, Boolean) Execute(IHttpHandler, TextWriter, Boolean) Execute(IHttpHandler, TextWriter, Boolean)

Ejecuta el controlador para la ruta de acceso virtual especificada en el contexto de la solicitud actual.Executes the handler for the specified virtual path in the context of the current request. Una clase TextWriter captura los resultados del controlador ejecutado y un parámetro Boolean especifica si se van a borrar las colecciones de QueryString y Form.A TextWriter captures output from the executed handler and a Boolean parameter specifies whether to clear the QueryString and Form collections.

Execute(String) Execute(String) Execute(String) Execute(String)

Ejecuta el controlador para la ruta de acceso virtual especificada en el contexto de la solicitud actual.Executes the handler for the specified virtual path in the context of the current request.

Execute(String, Boolean) Execute(String, Boolean) Execute(String, Boolean) Execute(String, Boolean)

Ejecuta el controlador para la ruta de acceso virtual especificada en el contexto de la solicitud actual y especifica si se van a borrar las colecciones de QueryString y Form.Executes the handler for the specified virtual path in the context of the current request and specifies whether to clear the QueryString and Form collections.

Execute(String, TextWriter) Execute(String, TextWriter) Execute(String, TextWriter) Execute(String, TextWriter)

Ejecuta el controlador para la ruta de acceso virtual especificada en el contexto de la solicitud actual.Executes the handler for the specified virtual path in the context of the current request. Una clase TextWriter captura los resultados del controlador ejecutado.A TextWriter captures output from the executed handler.

Execute(String, TextWriter, Boolean) Execute(String, TextWriter, Boolean) Execute(String, TextWriter, Boolean) Execute(String, TextWriter, Boolean)

Ejecuta el controlador para la ruta de acceso virtual especificada en el contexto de la solicitud actual.Executes the handler for the specified virtual path in the context of the current request. Una clase TextWriter captura los resultados de la página y un parámetro Boolean especifica si se van a borrar las colecciones de QueryString y Form.A TextWriter captures output from the page and a Boolean parameter specifies whether to clear the QueryString and Form collections.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetLastError() GetLastError() GetLastError() GetLastError()

Devuelve la excepción anterior.Returns the previous exception.

GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
HtmlDecode(String) HtmlDecode(String) HtmlDecode(String) HtmlDecode(String)

Descodifica una cadena con código HTML y devuelve la cadena descodificada.Decodes an HTML-encoded string and returns the decoded string.

HtmlDecode(String, TextWriter) HtmlDecode(String, TextWriter) HtmlDecode(String, TextWriter) HtmlDecode(String, TextWriter)

Descodifica una cadena con código HTML y envía el resultado a un flujo de salida de TextWriter.Decodes an HTML-encoded string and sends the resulting output to a TextWriter output stream.

HtmlEncode(String) HtmlEncode(String) HtmlEncode(String) HtmlEncode(String)

Codifica una cadena en HTML y devuelve la cadena codificada.HTML-encodes a string and returns the encoded string.

HtmlEncode(String, TextWriter) HtmlEncode(String, TextWriter) HtmlEncode(String, TextWriter) HtmlEncode(String, TextWriter)

Codifica mediante HTML una cadena y envía el resultado a un flujo de salida de TextWriter.HTML-encodes a string and sends the resulting output to a TextWriter output stream.

MapPath(String) MapPath(String) MapPath(String) MapPath(String)

Devuelve la ruta de acceso del archivo físico que corresponde a la ruta de acceso virtual especificada.Returns the physical file path that corresponds to the specified virtual path.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)
Transfer(IHttpHandler, Boolean) Transfer(IHttpHandler, Boolean) Transfer(IHttpHandler, Boolean) Transfer(IHttpHandler, Boolean)

Finaliza la ejecución de la página actual e inicia la ejecución de una nueva solicitud utilizando un controlador HTTP personalizado que implementa la interfaz IHttpHandler, y especifica si se deben borrar las colecciones de QueryString y Form.Terminates execution of the current page and starts execution of a new request by using a custom HTTP handler that implements the IHttpHandler interface and specifies whether to clear the QueryString and Form collections.

Transfer(String) Transfer(String) Transfer(String) Transfer(String)

En el caso de la solicitud actual, finaliza la ejecución de la página actual e inicia la ejecución de una nueva página utilizando la ruta de acceso a la dirección URL de la página.For the current request, terminates execution of the current page and starts execution of a new page by using the specified URL path of the page.

Transfer(String, Boolean) Transfer(String, Boolean) Transfer(String, Boolean) Transfer(String, Boolean)

Finaliza la ejecución de la página actual e inicia la ejecución de una nueva página utilizando la ruta de acceso a la dirección URL de la página.Terminates execution of the current page and starts execution of a new page by using the specified URL path of the page. Especifica si borrar las colecciones QueryString y Form.Specifies whether to clear the QueryString and Form collections.

TransferRequest(String) TransferRequest(String) TransferRequest(String) TransferRequest(String)

Realiza una ejecución asincrónica de la dirección URL especificada.Performs an asynchronous execution of the specified URL.

TransferRequest(String, Boolean) TransferRequest(String, Boolean) TransferRequest(String, Boolean) TransferRequest(String, Boolean)

Realiza una ejecución asincrónica de la dirección URL especificada y conserva los parámetros de cadena de consulta.Performs an asynchronous execution of the specified URL and preserves query string parameters.

TransferRequest(String, Boolean, String, NameValueCollection) TransferRequest(String, Boolean, String, NameValueCollection) TransferRequest(String, Boolean, String, NameValueCollection) TransferRequest(String, Boolean, String, NameValueCollection)

Realiza una ejecución asincrónica de la dirección URL especificada utilizando el método y los encabezados HTTP especificados.Performs an asynchronous execution of the specified URL using the specified HTTP method and headers.

TransferRequest(String, Boolean, String, NameValueCollection, Boolean) TransferRequest(String, Boolean, String, NameValueCollection, Boolean) TransferRequest(String, Boolean, String, NameValueCollection, Boolean) TransferRequest(String, Boolean, String, NameValueCollection, Boolean)

Realiza una ejecución asincrónica de la dirección URL especificada mediante el método, los encabezados y la ruta de acceso HTTP indicados, y conserva opcionalmente los valores del formulario y la identidad del usuario.Performs an asynchronous execution of the specified URL using the specified HTTP method, headers, and path, and optionally preserves form values and the user identity.

UrlDecode(String) UrlDecode(String) UrlDecode(String) UrlDecode(String)

Descodifica mediante URL una cadena y devuelve la cadena descodificada.URL-decodes a string and returns the decoded string.

UrlDecode(String, TextWriter) UrlDecode(String, TextWriter) UrlDecode(String, TextWriter) UrlDecode(String, TextWriter)

Descodifica una cadena HTML recibida en una dirección URL y envía el resultado a un flujo de salida de TextWriter.Decodes an HTML string received in a URL and sends the resulting output to a TextWriter output stream.

UrlEncode(String) UrlEncode(String) UrlEncode(String) UrlEncode(String)

Codifica mediante URL una cadena y devuelve la cadena codificada.URL-encodes a string and returns the encoded string.

UrlEncode(String, TextWriter) UrlEncode(String, TextWriter) UrlEncode(String, TextWriter) UrlEncode(String, TextWriter)

Codifica mediante URL una cadena y envía el resultado a un flujo de salida de TextWriter.URL-encodes a string and sends the resulting output to a TextWriter output stream.

UrlPathEncode(String) UrlPathEncode(String) UrlPathEncode(String) UrlPathEncode(String)

No usar; diseñado sólo para la compatibilidad con el explorador.Do not use; intended only for browser compatibility. Use UrlEncode(String).Use UrlEncode(String).

UrlTokenDecode(String) UrlTokenDecode(String) UrlTokenDecode(String) UrlTokenDecode(String)

Descodifica un símbolo (token) de cadena de dirección URL en su matriz de bytes equivalente utilizando dígitos de base 64.Decodes a URL string token to its equivalent byte array using base 64 digits.

UrlTokenEncode(Byte[]) UrlTokenEncode(Byte[]) UrlTokenEncode(Byte[]) UrlTokenEncode(Byte[])

Codifica una matriz de bytes en su representación de cadena equivalente, utilizando dígitos de base 64, lo que permite su transmisión en la dirección URL.Encodes a byte array into its equivalent string representation using base 64 digits, which is usable for transmission on the URL.

Se aplica a

Consulte también: