HttpServerUtility Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit des méthodes d'assistance pour le traitement des requêtes web.
public ref class HttpServerUtility sealed
public sealed class HttpServerUtility
type HttpServerUtility = class
Public NotInheritable Class HttpServerUtility
- Héritage
-
HttpServerUtility
Exemples
Un projet de site web Visual Studio avec du code source est disponible pour accompagner cette rubrique : Télécharger.
L’exemple suivant montre comment utiliser la HtmlEncode méthode et la UrlEncode méthode de la HttpServerUtility classe. La HtmlEncode méthode permet de s’assurer que toute entrée de chaîne fournie par l’utilisateur sera affichée en tant que texte statique dans les navigateurs au lieu d’un script exécutable ou d’éléments HTML. La UrlEncode méthode encode les URL afin qu’elles soient correctement transmises dans le flux 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>
Remarques
Les méthodes et les propriétés de la HttpServerUtility classe sont exposées via l’objet intrinsèque Server fourni par ASP.NET.
Propriétés
MachineName |
Obtient le nom d'ordinateur du serveur. |
ScriptTimeout |
Obtient ou définit la valeur du délai d’expiration des requêtes, en secondes. |
Méthodes
ClearError() |
Efface l'exception précédente. |
CreateObject(String) |
Crée une instance serveur d'un objet COM identifiée par l'identificateur programmatique (ProgID) de l'objet. |
CreateObject(Type) |
Crée une instance serveur d'un objet COM identifiée par le type de l'objet. |
CreateObjectFromClsid(String) |
Crée une instance serveur d'un objet COM identifiée par l'identificateur de classe (CLSID) de l'objet. |
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
Execute(IHttpHandler, TextWriter, Boolean) |
Exécute le gestionnaire du chemin d’accès virtuel spécifié dans le contexte de la requête actuelle. Un TextWriter intercepte la sortie du gestionnaire exécuté, et un paramètre Boolean spécifie s'il faut ou non effacer les collections QueryString et Form. |
Execute(String) |
Exécute le gestionnaire du chemin d’accès virtuel spécifié dans le contexte de la requête actuelle. |
Execute(String, Boolean) |
Exécute le gestionnaire du chemin d'accès virtuel spécifié dans le contexte de la requête actuelle, et spécifie s'il faut ou non effacer les collections QueryString et Form. |
Execute(String, TextWriter) |
Exécute le gestionnaire du chemin d’accès virtuel spécifié dans le contexte de la requête actuelle. TextWriter intercepte la sortie du gestionnaire exécuté. |
Execute(String, TextWriter, Boolean) |
Exécute le gestionnaire du chemin d’accès virtuel spécifié dans le contexte de la requête actuelle. Un TextWriter intercepte la sortie de la page, et un paramètre Boolean spécifie s'il faut ou non effacer les collections QueryString et Form. |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetLastError() |
Retourne l'exception précédente. |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
HtmlDecode(String) |
Décode une chaîne codée en HTML et retourne la chaîne décodée. |
HtmlDecode(String, TextWriter) |
Décode une chaîne encodée en HTML et envoie le résultat vers un flux de sortie TextWriter. |
HtmlEncode(String) |
Encode une chaîne au format HTML et retourne la chaîne encodée. |
HtmlEncode(String, TextWriter) |
Encode une chaîne au format HTML et envoie le résultat vers un flux de sortie TextWriter. |
MapPath(String) |
Retourne le chemin d’accès au fichier physique qui correspond au chemin d’accès virtuel spécifié. |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
Transfer(IHttpHandler, Boolean) |
Termine l'exécution de la page actuelle et commence celle d'une nouvelle requête en utilisant un gestionnaire HTTP personnalisé qui implémente l'interface IHttpHandler et spécifie s'il faut ou non effacer les collections QueryString et Form. |
Transfer(String) |
Pour la requête actuelle, termine l’exécution de la page actuelle et commence l’exécution d’une nouvelle page en utilisant le chemin d’accès de l’URL spécifié pour accéder à la page. |
Transfer(String, Boolean) |
Termine l’exécution de la page actuelle et commence celle d’une nouvelle page en utilisant le chemin d’accès de l’URL spécifié pour accéder à la page. Spécifie s'il faut effacer les collections QueryString et Form. |
TransferRequest(String) |
Réalise une exécution asynchrone de l'URL spécifiée. |
TransferRequest(String, Boolean) |
Exécute une exécution asynchrone de l'URL spécifiée et conserve les paramètres de chaîne de requête. |
TransferRequest(String, Boolean, String, NameValueCollection) |
Exécute une exécution asynchrone de l'URL spécifiée à l'aide de la méthode et des en-têtes HTTP spécifiés. |
TransferRequest(String, Boolean, String, NameValueCollection, Boolean) |
Exécute de façon asynchrone l'URL spécifiée à l'aide de la méthode HTTP, des en-têtes et du chemin d'accès spécifiés, et conserve éventuellement les valeurs de formulaire et l'identité de l'utilisateur. |
UrlDecode(String) |
Décode une chaîne URL et retourne la chaîne décodée. |
UrlDecode(String, TextWriter) |
Décode une chaîne HTML reçue dans une URL et envoie le résultat vers un flux de sortie TextWriter. |
UrlEncode(String) |
Encode une chaîne en URL et retourne la chaîne codée. |
UrlEncode(String, TextWriter) |
Code une chaîne au format URL et envoie le résultat vers un flux de sortie TextWriter. |
UrlPathEncode(String) |
À ne pas utiliser ; conçu uniquement pour la compatibilité avec le navigateur. Utilisez UrlEncode(String). |
UrlTokenDecode(String) |
Décode un jeton de chaîne d'URL selon une base numérique 64 pour le convertir en tableau d'octets équivalent. |
UrlTokenEncode(Byte[]) |
Encode un tableau d'octets dans une représentation de type chaîne équivalente, selon une base numérique 64 et un format approprié à la transmission sur l'URL. |