HttpServerUtility Classe

Definizione

Fornisce metodi helper per l'elaborazione delle richieste Web.

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

Esempio

Un progetto di sito Web di Visual Studio con codice sorgente è disponibile per accompagnare questo argomento: download.

Nell'esempio seguente viene illustrato come utilizzare il HtmlEncode metodo e il UrlEncode metodo della HttpServerUtility classe. 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. Il UrlEncode metodo codifica gli URL in modo che vengano trasmessi correttamente nel flusso 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>

Commenti

I metodi e le proprietà della HttpServerUtility classe vengono esposti tramite l'oggetto intrinseco Server fornito da ASP.NET.

Proprietà

MachineName

Restituisce il nome del computer server.

ScriptTimeout

Ottiene o imposta il valore di timeout della richiesta in secondi.

Metodi

ClearError()

Cancella l'eccezione precedente.

CreateObject(String)

Crea un'istanza del server di un oggetto COM identificato dall'identificatore a livello di codice (ProgID) dell'oggetto.

CreateObject(Type)

Crea un'istanza del server di un oggetto COM identificato dal tipo di oggetto.

CreateObjectFromClsid(String)

Crea un'istanza del server di un oggetto COM identificato dall'identificatore di classe (CLSID) dell'oggetto.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

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

Esegue il gestore per il percorso virtuale specificato nel contesto della richiesta corrente. L'output del gestore eseguito viene acquisito dall'oggetto TextWriter e un parametro booleano specifica se gli insiemi QueryString e Form devono essere cancellati.

Execute(String)

Esegue il gestore per il percorso virtuale specificato nel contesto della richiesta corrente.

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.

Execute(String, TextWriter)

Esegue il gestore per il percorso virtuale specificato nel contesto della richiesta corrente. L'output del gestore eseguito viene acquisito dall'oggetto TextWriter.

Execute(String, TextWriter, Boolean)

Esegue il gestore per il percorso virtuale specificato nel contesto della richiesta corrente. L'output della pagina viene acquisito dall'oggetto TextWriter e un parametro booleano specifica se gli insiemi QueryString e Form devono essere cancellati.

GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetLastError()

Restituisce l'eccezione precedente.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
HtmlDecode(String)

Decodifica una stringa codificata in HTML e restituisce la stringa decodificata.

HtmlDecode(String, TextWriter)

Consente di decodificare una stringa codificata HTML e di inviare l'output risultante al flusso di output di un oggetto TextWriter.

HtmlEncode(String)

Codifica in HTML una stringa e restituisce la stringa codificata.

HtmlEncode(String, TextWriter)

Codifica in HTML una stringa e invia l'output risultante a un flusso di output di TextWriter.

MapPath(String)

Restituisce il percorso fisico al file che corrisponde al percorso virtuale specificato.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(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.

Transfer(String)

Per la richiesta corrente, termina l'esecuzione della pagina corrente e avvia l'esecuzione di una nuova pagina usando il percorso URL di pagina specificato.

Transfer(String, Boolean)

Termina l'esecuzione della pagina corrente e avvia l'esecuzione di una nuova pagina usando il percorso URL di pagina specificato. Consente di specificare se eliminare gli insiemi QueryString e Form.

TransferRequest(String)

Esegue un'esecuzione asincrona dell'URL specificato.

TransferRequest(String, Boolean)

Esegue un'esecuzione asincrona dell'URL specificato e mantiene i parametri della stringa di query.

TransferRequest(String, Boolean, String, NameValueCollection)

Esegue un'esecuzione asincrona dell'URL specificato usando il metodo e le intestazioni HTTP specificati.

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

Esegue un'esecuzione asincrona dell'URL specificato usando il metodo HTTP, le intestazioni e il percorso specificati e, facoltativamente, mantiene i valori del form e l'identità dell'utente.

UrlDecode(String)

Decodifica una stringa in URL e restituisce la stringa decodificata.

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.

UrlEncode(String)

Codifica una stringa in URL e restituisce la stringa codificata.

UrlEncode(String, TextWriter)

Consente di codificare in URL una stringa e di inviare l'output risultante a un flusso di output di TextWriter.

UrlPathEncode(String)

Non usare. Progettato solo per compatibilità browser. Usare UrlEncode(String).

UrlTokenDecode(String)

Decodifica il token di una stringa URL nella relativa matrice di byte equivalente usando cifre Base64.

UrlTokenEncode(Byte[])

Codifica una matrice di byte nella rappresentazione di stringa equivalente con cifre Base64, indicate per la trasmissione nell'URL.

Si applica a

Vedi anche