HttpServerUtility Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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
Nell'esempio seguente viene illustrato come utilizzare il HtmlEncode metodo e il UrlEncode metodo della HttpServerUtility classe . Il HtmlEncode metodo consente di garantire che il rendering di qualsiasi input stringa fornito dall'utente venga eseguito come testo statico nei browser anziché come script eseguibile o elementi HTML. 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 classe HttpServerUtility vengono esposti tramite l'oggetto intrinseco Server fornito da ASP.NET.
Proprietà
| Nome | Descrizione |
|---|---|
| MachineName |
Ottiene il nome del computer del server. |
| ScriptTimeout |
Ottiene o imposta il valore di timeout della richiesta in secondi. |
Metodi
| Nome | Descrizione |
|---|---|
| ClearError() |
Cancella l'eccezione precedente. |
| CreateObject(String) |
Crea un'istanza del server di un oggetto COM identificato dall'identificatore programmatico dell'oggetto (ProgID). |
| CreateObject(Type) |
Crea un'istanza del server di un oggetto COM identificato dal tipo dell'oggetto. |
| CreateObjectFromClsid(String) |
Crea un'istanza del server di un oggetto COM identificato dall'identificatore di classe dell'oggetto (CLSID). |
| 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. Un TextWriter oggetto acquisisce l'output dal gestore eseguito e un parametro booleano specifica se cancellare le QueryString raccolte e Form . |
| Execute(String, Boolean) |
Esegue il gestore per il percorso virtuale specificato nel contesto della richiesta corrente e specifica se cancellare le QueryString raccolte e Form . |
| Execute(String, TextWriter, Boolean) |
Esegue il gestore per il percorso virtuale specificato nel contesto della richiesta corrente. Un TextWriter oggetto acquisisce l'output dalla pagina e un parametro booleano specifica se cancellare le QueryString raccolte e Form . |
| Execute(String, TextWriter) |
Esegue il gestore per il percorso virtuale specificato nel contesto della richiesta corrente. Un TextWriter oggetto acquisisce l'output dal gestore eseguito. |
| Execute(String) |
Esegue il gestore per il percorso virtuale specificato nel contesto della richiesta corrente. |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetLastError() |
Restituisce l'eccezione precedente. |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| HtmlDecode(String, TextWriter) |
Decodifica una stringa con codifica HTML e invia l'output risultante a un TextWriter flusso di output. |
| HtmlDecode(String) |
Decodifica una stringa con codifica HTML e restituisce la stringa decodificata. |
| HtmlEncode(String, TextWriter) |
Html codifica una stringa e invia l'output risultante a un TextWriter flusso di output. |
| HtmlEncode(String) |
Codifica HTML una stringa e restituisce la stringa codificata. |
| MapPath(String) |
Restituisce il percorso del file fisico che corrisponde al percorso virtuale specificato. |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (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 avvia l'esecuzione di una nuova richiesta usando un gestore HTTP personalizzato che implementa l'interfaccia IHttpHandler e specifica se cancellare le QueryString raccolte e Form . |
| Transfer(String, Boolean) |
Termina l'esecuzione della pagina corrente e avvia l'esecuzione di una nuova pagina usando il percorso URL specificato della pagina. Specifica se cancellare le QueryString raccolte e Form . |
| Transfer(String) |
Per la richiesta corrente, termina l'esecuzione della pagina corrente e avvia l'esecuzione di una nuova pagina usando il percorso URL specificato della pagina. |
| 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 modulo e l'identità utente. |
| TransferRequest(String, Boolean, String, NameValueCollection) |
Esegue un'esecuzione asincrona dell'URL specificato usando il metodo HTTP e le intestazioni specificati. |
| TransferRequest(String, Boolean) |
Esegue un'esecuzione asincrona dell'URL specificato e mantiene i parametri della stringa di query. |
| TransferRequest(String) |
Esegue un'esecuzione asincrona dell'URL specificato. |
| UrlDecode(String, TextWriter) |
Decodifica una stringa HTML ricevuta in un URL e invia l'output risultante a un TextWriter flusso di output. |
| UrlDecode(String) |
URL decodifica una stringa e restituisce la stringa decodificata. |
| UrlEncode(String, TextWriter) |
L'URL codifica una stringa e invia l'output risultante a un TextWriter flusso di output. |
| UrlEncode(String) |
L'URL codifica una stringa e restituisce la stringa codificata. |
| UrlPathEncode(String) |
Non usare; destinato solo alla compatibilità del browser. Utilizzare il UrlEncode(String). |
| UrlTokenDecode(String) |
Decodifica un token di stringa URL nella matrice di byte equivalente usando cifre base 64. |
| UrlTokenEncode(Byte[]) |
Codifica una matrice di byte nella rappresentazione di stringa equivalente usando cifre base 64, utilizzabile per la trasmissione nell'URL. |