HttpServerUtility Classe

Definizione

Fornisce metodi di supporto per l'elaborazione delle richieste Web.Provides helper methods for processing Web requests.

public ref class HttpServerUtility sealed
public sealed class HttpServerUtility
type HttpServerUtility = class
Public NotInheritable Class HttpServerUtility
Ereditarietà
HttpServerUtility

Esempi

Per accompagnare questo argomento, è disponibile un progetto di sito Web di Visual Studio con codice sorgente: Scaricare.A Visual Studio Web site project with source code is available to accompany this topic: Download.

Nell'esempio seguente viene illustrato come utilizzare il HtmlEncode metodo e il UrlEncode metodo della HttpServerUtility classe.The following example demonstrates how to use the HtmlEncode method and the UrlEncode method of the HttpServerUtility class. Il HtmlEncode metodo consente di garantire che qualsiasi input di stringa fornito dall'utente venga sottoposto a rendering come testo statico nei browser anziché negli elementi HTML o script eseguibili.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. Il UrlEncode metodo codifica gli URL in modo che vengano trasmessi correttamente nel flusso 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>

Commenti

I metodi e le proprietà della HttpServerUtility classe vengono esposti tramite l'oggetto Server intrinseco fornito da ASP.NET.The methods and properties of the HttpServerUtility class are exposed through the intrinsic Server object provided by ASP.NET.

Proprietà

MachineName

Restituisce il nome del computer server.Gets the server's computer name.

ScriptTimeout

Ottiene o imposta il valore di timeout della richiesta in secondi.Gets or sets the request time-out value in seconds.

Metodi

ClearError()

Cancella l'eccezione precedente.Clears the previous exception.

CreateObject(String)

Crea un'istanza del server di un oggetto COM identificato dall'identificatore a livello di codice (ProgID) dell'oggetto.Creates a server instance of a COM object identified by the object's programmatic identifier (ProgID).

CreateObject(Type)

Consente di creare un'istanza del server di un oggetto COM identificato dal tipo di oggetto.Creates a server instance of a COM object identified by the object's type.

CreateObjectFromClsid(String)

Crea un'istanza del server di un oggetto COM identificato dall'identificatore di classe (CLSID) dell'oggetto.Creates a server instance of a COM object identified by the object's class identifier (CLSID).

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
Execute(IHttpHandler, TextWriter, Boolean)

Esegue il gestore per il percorso virtuale specificato nel contesto della richiesta corrente.Executes the handler for the specified virtual path in the context of the current request. L'output del gestore eseguito viene acquisito dall'oggetto TextWriter e un parametro booleano specifica se gli insiemi QueryString e Form devono essere cancellati.A TextWriter captures output from the executed handler and a Boolean parameter specifies whether to clear the QueryString and Form collections.

Execute(String)

Esegue il gestore per il percorso virtuale specificato nel contesto della richiesta corrente.Executes the handler for the specified virtual path in the context of the current request.

Execute(String, Boolean)

Esegue il gestore per il percorso specificato nel contesto della richiesta corrente e specifica se è necessario cancellare gli insiemi QueryString e 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)

Esegue il gestore per il percorso virtuale specificato nel contesto della richiesta corrente.Executes the handler for the specified virtual path in the context of the current request. L'output del gestore eseguito viene acquisito dall'oggetto TextWriter.A TextWriter captures output from the executed handler.

Execute(String, TextWriter, Boolean)

Esegue il gestore per il percorso virtuale specificato nel contesto della richiesta corrente.Executes the handler for the specified virtual path in the context of the current request. L'output della pagina viene acquisito dall'oggetto TextWriter e un parametro booleano specifica se gli insiemi QueryString e Form devono essere cancellati.A TextWriter captures output from the page and a Boolean parameter specifies whether to clear the QueryString and Form collections.

GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetLastError()

Restituisce l'eccezione precedente.Returns the previous exception.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
HtmlDecode(String)

Consente di decodificare una stringa HTML codificata e restituisce la stringa decodificata.Decodes an HTML-encoded string and returns the decoded string.

HtmlDecode(String, TextWriter)

Consente di decodificare una stringa codificata HTML e di inviare l'output risultante al flusso di output di un oggetto TextWriter.Decodes an HTML-encoded string and sends the resulting output to a TextWriter output stream.

HtmlEncode(String)

Consente di codificare in HTML una stringa e restituisce la stringa codificata.HTML-encodes a string and returns the encoded string.

HtmlEncode(String, TextWriter)

Codifica in HTML una stringa e invia l'output risultante a un flusso di output di TextWriter.HTML-encodes a string and sends the resulting output to a TextWriter output stream.

MapPath(String)

Restituisce il percorso fisico al file che corrisponde al percorso virtuale specificato.Returns the physical file path that corresponds to the specified virtual path.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)
Transfer(IHttpHandler, Boolean)

Termina l'esecuzione della pagina corrente e inizia l'esecuzione di una nuova richiesta tramite un gestore HTTP personalizzato che implementa l'interfaccia IHttpHandler e specifica se gli insiemi QueryString e Form devono essere cancellati.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)

Per la richiesta corrente, termina l'esecuzione della pagina corrente e avvia l'esecuzione di una nuova pagina utilizzando il percorso URL di pagina specificato.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)

Termina l'esecuzione della pagina corrente e avvia l'esecuzione di una nuova pagina utilizzando il percorso URL di pagina specificato.Terminates execution of the current page and starts execution of a new page by using the specified URL path of the page. Consente di specificare se eliminare gli insiemi QueryString e Form.Specifies whether to clear the QueryString and Form collections.

TransferRequest(String)

Esegue un'esecuzione asincrona dell'URL specificato.Performs an asynchronous execution of the specified URL.

TransferRequest(String, Boolean)

Esegue un'esecuzione asincrona dell'URL specificato e mantiene i parametri della stringa di query.Performs an asynchronous execution of the specified URL and preserves query string parameters.

TransferRequest(String, Boolean, String, NameValueCollection)

Esegue un'esecuzione asincrona dell'URL specificato utilizzando il metodo e le intestazioni HTTP specificati.Performs an asynchronous execution of the specified URL using the specified HTTP method and headers.

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

Effettua un'esecuzione asincrona dell'URL specificato utilizzando il metodo HTTP, le intestazioni e il percorso specificati e, facoltativamente, mantiene i valori del form e l'identità dell'utente.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)

Consente di decodificare una stringa URL e restituisce la stringa decodificata.URL-decodes a string and returns the decoded string.

UrlDecode(String, TextWriter)

Consente di decodificare una stringa HTML ricevuta in un URL e di inviare l'output risultante a un flusso di output di TextWriter.Decodes an HTML string received in a URL and sends the resulting output to a TextWriter output stream.

UrlEncode(String)

Consente di codificare una stringa in URL e restituisce la stringa codificata.URL-encodes a string and returns the encoded string.

UrlEncode(String, TextWriter)

Consente di codificare in URL una stringa e di inviare l'output risultante a un flusso di output di TextWriter.URL-encodes a string and sends the resulting output to a TextWriter output stream.

UrlPathEncode(String)

Non utilizzare. Progettato solo per compatibilità con browser.Do not use; intended only for browser compatibility. Usare UrlEncode(String).Use UrlEncode(String).

UrlTokenDecode(String)

Consente di decodificare il token di una stringa URL nella relativa matrice di byte equivalente utilizzando cifre in base 64.Decodes a URL string token to its equivalent byte array using base 64 digits.

UrlTokenEncode(Byte[])

Consente di codificare una matrice di byte nella rappresentazione di stringa equivalente con cifre Base 64, indicate per la trasmissione nell'URL.Encodes a byte array into its equivalent string representation using base 64 digits, which is usable for transmission on the URL.

Si applica a

Vedi anche