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
È disponibile un progetto di sito Web Visual Studio con codice sorgente associato a questo argomento: Download.
Nell'esempio seguente viene illustrato come utilizzare il HtmlEncode metodo e il UrlEncode metodo della HttpServerUtility classe . Il HtmlEncode metodo garantisce che qualsiasi input stringa fornito dall'utente venga sottoposto a rendering 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 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. |