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
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 rendue 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 classe HttpServerUtility sont exposées via l’objet Server intrinsèque fourni par ASP.NET.
Propriétés
| Nom | Description |
|---|---|
| MachineName |
Obtient le nom de l’ordinateur du serveur. |
| ScriptTimeout |
Obtient ou définit la valeur de délai d’expiration de la requête en secondes. |
Méthodes
| Nom | Description |
|---|---|
| ClearError() |
Efface l’exception précédente. |
| CreateObject(String) |
Crée une instance de serveur d’un objet COM identifié par l’identificateur programmatique de l’objet (ProgID). |
| CreateObject(Type) |
Crée une instance de serveur d’un objet COM identifié par le type de l’objet. |
| CreateObjectFromClsid(String) |
Crée une instance de serveur d’un objet COM identifié par l’identificateur de classe de l’objet (CLSID). |
| 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 pour le chemin d’accès virtuel spécifié dans le contexte de la requête actuelle. Une TextWriter capture la sortie du gestionnaire exécuté et d’un paramètre booléen spécifie s’il faut effacer les collections et Form les QueryString supprimer. |
| Execute(String, Boolean) |
Exécute le gestionnaire pour le chemin d’accès virtuel spécifié dans le contexte de la requête actuelle et spécifie s’il faut effacer les collections et Form les QueryString supprimer. |
| Execute(String, TextWriter, Boolean) |
Exécute le gestionnaire pour le chemin d’accès virtuel spécifié dans le contexte de la requête actuelle. Une TextWriter capture de sortie de la page et d’un paramètre booléen spécifie s’il faut effacer les collections et Form les QueryString collections. |
| Execute(String, TextWriter) |
Exécute le gestionnaire pour le chemin d’accès virtuel spécifié dans le contexte de la requête actuelle. Une TextWriter capture la sortie du gestionnaire exécuté. |
| Execute(String) |
Exécute le gestionnaire pour le chemin d’accès virtuel spécifié dans le contexte de la requête actuelle. |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetLastError() |
Retourne l’exception précédente. |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| HtmlDecode(String, TextWriter) |
Décode une chaîne encodée HTML et envoie la sortie obtenue à un TextWriter flux de sortie. |
| HtmlDecode(String) |
Décode une chaîne encodée HTML et retourne la chaîne décodée. |
| HtmlEncode(String, TextWriter) |
Code HTML encode une chaîne et envoie la sortie obtenue à un TextWriter flux de sortie. |
| HtmlEncode(String) |
Code HTML encode une chaîne et retourne la chaîne encodée. |
| 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 Objectactuel. (Hérité de Object) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
| Transfer(IHttpHandler, Boolean) |
Met fin à l’exécution de la page active et démarre l’exécution d’une nouvelle requête à l’aide d’un gestionnaire HTTP personnalisé qui implémente l’interface IHttpHandler et spécifie s’il faut effacer les collections et QueryString les Form supprimer. |
| Transfer(String, Boolean) |
Met fin à l’exécution de la page active et démarre l’exécution d’une nouvelle page à l’aide du chemin d’URL spécifié de la page. Spécifie s’il faut effacer les collections et QueryString les Form collections. |
| Transfer(String) |
Pour la requête actuelle, arrête l’exécution de la page active et démarre l’exécution d’une nouvelle page à l’aide du chemin d’URL spécifié de la page. |
| TransferRequest(String, Boolean, String, NameValueCollection, Boolean) |
Effectue une exécution asynchrone de 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. |
| TransferRequest(String, Boolean, String, NameValueCollection) |
Exécute une exécution asynchrone de l’URL spécifiée à l’aide de la méthode HTTP et des en-têtes spécifiés. |
| 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) |
Exécute une exécution asynchrone de l’URL spécifiée. |
| UrlDecode(String, TextWriter) |
Décode une chaîne HTML reçue dans une URL et envoie la sortie obtenue à un TextWriter flux de sortie. |
| UrlDecode(String) |
L’URL décode une chaîne et retourne la chaîne décodée. |
| UrlEncode(String, TextWriter) |
L’URL encode une chaîne et envoie la sortie obtenue à un TextWriter flux de sortie. |
| UrlEncode(String) |
L’URL encode une chaîne et retourne la chaîne encodée. |
| UrlPathEncode(String) |
N’utilisez pas ; destiné uniquement à la compatibilité du navigateur. Utilisez UrlEncode(String). |
| UrlTokenDecode(String) |
Décode un jeton de chaîne d’URL vers son tableau d’octets équivalent à l’aide de 64 chiffres de base. |
| UrlTokenEncode(Byte[]) |
Encode un tableau d’octets dans sa représentation sous forme de chaîne équivalente à l’aide de chiffres de base 64, utilisable pour la transmission sur l’URL. |