HttpServerUtility HttpServerUtility HttpServerUtility HttpServerUtility Class

Définition

Fournit des méthodes d'assistance pour le traitement des requêtes web.Provides helper methods for processing Web requests.

public ref class HttpServerUtility sealed
public sealed class HttpServerUtility
type HttpServerUtility = class
Public NotInheritable Class HttpServerUtility
Héritage
HttpServerUtilityHttpServerUtilityHttpServerUtilityHttpServerUtility

Exemples

Un projet de site Web Visual Studio avec le code source est disponible pour accompagner cette rubrique: Téléchargez.A Visual Studio Web site project with source code is available to accompany this topic: Download.

L’exemple suivant montre comment utiliser la HtmlEncode méthode et la UrlEncode méthode de la HttpServerUtility classe.The following example demonstrates how to use the HtmlEncode method and the UrlEncode method of the HttpServerUtility class. La HtmlEncode méthode permet de s’assurer que toutes les entrées de chaîne fournies par l’utilisateur seront rendues sous forme de texte statique dans les navigateurs au lieu d’un script exécutable ou d’éléments HTML.The HtmlEncode method helps ensure that any user-supplied string input will be rendered as static text in browsers instead of executable script or HTML elements. La UrlEncode méthode encode les URL afin qu’elles soient correctement transmises dans le flux http.The UrlEncode method encodes URLs so that they are correctly transmitted in the HTTP stream.

<%@ 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 HttpServerUtility la classe sont exposées par le Server biais de l’objet intrinsèque fourni par ASP.net.The methods and properties of the HttpServerUtility class are exposed through the intrinsic Server object provided by ASP.NET.

Propriétés

MachineName MachineName MachineName MachineName

Obtient le nom d'ordinateur du serveur.Gets the server's computer name.

ScriptTimeout ScriptTimeout ScriptTimeout ScriptTimeout

Obtient ou définit la valeur du délai d'attente de la requête, exprimée en secondes.Gets or sets the request time-out value in seconds.

Méthodes

ClearError() ClearError() ClearError() ClearError()

Efface l'exception précédente.Clears the previous exception.

CreateObject(String) CreateObject(String) CreateObject(String) CreateObject(String)

Crée une instance serveur d'un objet COM identifiée par l'identificateur programmatique (ProgID) de l'objet.Creates a server instance of a COM object identified by the object's programmatic identifier (ProgID).

CreateObject(Type) CreateObject(Type) CreateObject(Type) CreateObject(Type)

Crée une instance serveur d'un objet COM identifiée par le type de l'objet.Creates a server instance of a COM object identified by the object's type.

CreateObjectFromClsid(String) CreateObjectFromClsid(String) CreateObjectFromClsid(String) CreateObjectFromClsid(String)

Crée une instance serveur d'un objet COM identifiée par l'identificateur de classe (CLSID) de l'objet.Creates a server instance of a COM object identified by the object's class identifier (CLSID).

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Execute(IHttpHandler, TextWriter, Boolean) Execute(IHttpHandler, TextWriter, Boolean) Execute(IHttpHandler, TextWriter, Boolean) Execute(IHttpHandler, TextWriter, Boolean)

Exécute le gestionnaire du chemin d'accès virtuel spécifié dans le contexte de la requête actuelle.Executes the handler for the specified virtual path in the context of the current request. 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.A TextWriter captures output from the executed handler and a Boolean parameter specifies whether to clear the QueryString and Form collections.

Execute(String) Execute(String) Execute(String) Execute(String)

Exécute le gestionnaire du chemin d'accès virtuel spécifié dans le contexte de la requête actuelle.Executes the handler for the specified virtual path in the context of the current request.

Execute(String, Boolean) Execute(String, Boolean) Execute(String, Boolean) 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.Executes the handler for the specified virtual path in the context of the current request and specifies whether to clear the QueryString and Form collections.

Execute(String, TextWriter) Execute(String, TextWriter) Execute(String, TextWriter) Execute(String, TextWriter)

Exécute le gestionnaire du chemin d'accès virtuel spécifié dans le contexte de la requête actuelle.Executes the handler for the specified virtual path in the context of the current request. TextWriter intercepte la sortie du gestionnaire exécuté.A TextWriter captures output from the executed handler.

Execute(String, TextWriter, Boolean) Execute(String, TextWriter, Boolean) Execute(String, TextWriter, Boolean) Execute(String, TextWriter, Boolean)

Exécute le gestionnaire du chemin d'accès virtuel spécifié dans le contexte de la requête actuelle.Executes the handler for the specified virtual path in the context of the current request. 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.A TextWriter captures output from the page and a Boolean parameter specifies whether to clear the QueryString and Form collections.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetLastError() GetLastError() GetLastError() GetLastError()

Retourne l'exception précédente.Returns the previous exception.

GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
HtmlDecode(String) HtmlDecode(String) HtmlDecode(String) HtmlDecode(String)

Décode une chaîne codée en HTML et retourne la chaîne décodée.Decodes an HTML-encoded string and returns the decoded string.

HtmlDecode(String, TextWriter) HtmlDecode(String, TextWriter) HtmlDecode(String, TextWriter) HtmlDecode(String, TextWriter)

Décode une chaîne encodée en HTML et envoie le résultat vers un flux de sortie TextWriter.Decodes an HTML-encoded string and sends the resulting output to a TextWriter output stream.

HtmlEncode(String) HtmlEncode(String) HtmlEncode(String) HtmlEncode(String)

Encode une chaîne au format HTML et retourne la chaîne encodée.HTML-encodes a string and returns the encoded string.

HtmlEncode(String, TextWriter) HtmlEncode(String, TextWriter) HtmlEncode(String, TextWriter) HtmlEncode(String, TextWriter)

Encode une chaîne au format HTML et envoie le résultat vers un flux de sortie TextWriter.HTML-encodes a string and sends the resulting output to a TextWriter output stream.

MapPath(String) MapPath(String) MapPath(String) MapPath(String)

Retourne le chemin d’accès au fichier physique qui correspond au chemin d’accès virtuel spécifié.Returns the physical file path that corresponds to the specified virtual path.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)
Transfer(IHttpHandler, Boolean) Transfer(IHttpHandler, Boolean) Transfer(IHttpHandler, Boolean) 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.Terminates execution of the current page and starts execution of a new request by using a custom HTTP handler that implements the IHttpHandler interface and specifies whether to clear the QueryString and Form collections.

Transfer(String) Transfer(String) Transfer(String) Transfer(String)

Pour la requête en cours, termine l'exécution de la page en cours 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.For the current request, terminates execution of the current page and starts execution of a new page by using the specified URL path of the page.

Transfer(String, Boolean) Transfer(String, Boolean) Transfer(String, Boolean) Transfer(String, Boolean)

Termine l'exécution de la page en cours 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.Terminates execution of the current page and starts execution of a new page by using the specified URL path of the page. Spécifie s'il faut effacer les collections QueryString et Form.Specifies whether to clear the QueryString and Form collections.

TransferRequest(String) TransferRequest(String) TransferRequest(String) TransferRequest(String)

Réalise une exécution asynchrone de l'URL spécifiée.Performs an asynchronous execution of the specified URL.

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

Exécute une exécution asynchrone de l'URL spécifiée et conserve les paramètres de chaînes de requête.Performs an asynchronous execution of the specified URL and preserves query string parameters.

TransferRequest(String, Boolean, String, NameValueCollection) TransferRequest(String, Boolean, String, NameValueCollection) TransferRequest(String, Boolean, String, NameValueCollection) 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.Performs an asynchronous execution of the specified URL using the specified HTTP method and headers.

TransferRequest(String, Boolean, String, NameValueCollection, Boolean) TransferRequest(String, Boolean, String, NameValueCollection, Boolean) TransferRequest(String, Boolean, String, NameValueCollection, Boolean) 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.Performs an asynchronous execution of the specified URL using the specified HTTP method, headers, and path, and optionally preserves form values and the user identity.

UrlDecode(String) UrlDecode(String) UrlDecode(String) UrlDecode(String)

Décode une chaîne URL et retourne la chaîne décodée.URL-decodes a string and returns the decoded string.

UrlDecode(String, TextWriter) UrlDecode(String, TextWriter) UrlDecode(String, TextWriter) 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.Decodes an HTML string received in a URL and sends the resulting output to a TextWriter output stream.

UrlEncode(String) UrlEncode(String) UrlEncode(String) UrlEncode(String)

Code une chaîne en URL et retourne la chaîne codée.URL-encodes a string and returns the encoded string.

UrlEncode(String, TextWriter) UrlEncode(String, TextWriter) UrlEncode(String, TextWriter) UrlEncode(String, TextWriter)

Code une chaîne au format URL et envoie le résultat vers un flux de sortie TextWriter.URL-encodes a string and sends the resulting output to a TextWriter output stream.

UrlPathEncode(String) UrlPathEncode(String) UrlPathEncode(String) UrlPathEncode(String)

À ne pas utiliser ; conçu uniquement pour la compatibilité avec le navigateur.Do not use; intended only for browser compatibility. Utilisez UrlEncode(String).Use UrlEncode(String).

UrlTokenDecode(String) UrlTokenDecode(String) UrlTokenDecode(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.Decodes a URL string token to its equivalent byte array using base 64 digits.

UrlTokenEncode(Byte[]) UrlTokenEncode(Byte[]) UrlTokenEncode(Byte[]) UrlTokenEncode(Byte[])

Code 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.Encodes a byte array into its equivalent string representation using base 64 digits, which is usable for transmission on the URL.

S’applique à

Voir aussi