HttpCacheVaryByContentEncodings HttpCacheVaryByContentEncodings HttpCacheVaryByContentEncodings HttpCacheVaryByContentEncodings Class

Définition

Fournit une manière de type sécurisé pour définir la propriété VaryByContentEncodings de la classe HttpCachePolicy.Provides a type-safe way to set the VaryByContentEncodings property of the HttpCachePolicy class.

public ref class HttpCacheVaryByContentEncodings sealed
public sealed class HttpCacheVaryByContentEncodings
type HttpCacheVaryByContentEncodings = class
Public NotInheritable Class HttpCacheVaryByContentEncodings
Héritage
HttpCacheVaryByContentEncodingsHttpCacheVaryByContentEncodingsHttpCacheVaryByContentEncodingsHttpCacheVaryByContentEncodings

Exemples

L’exemple suivant montre comment activer une réponse compressée de façon dynamique qui peut être fournie par le cache de sortie.The following example shows how to enable a dynamically compressed response that can be served from the output cache. L’encodage est acceptable est « gzip » et est définie à l’aide de la VaryByContentEncodings attribut de la directive.The encoding that is acceptable is "gzip" and is set by using the VaryByContentEncodings attribute of the directive. Si le serveur Web qui héberge la page n’a pas la compression dynamique est activée, le cache de sortie n’aura pas d’une réponse mise en cache pour l’encodage du contenu spécifié.If the Web server that hosts the page does not have dynamic compression enabled, the output cache will not have a cached response for the specified content encoding.

<%@ Page Language="C#" %>
<%@ OutputCache VaryByParam="none" Duration="10" VaryByContentEncodings="gzip" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>Varying Output Cache By Content Encoding</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    <%= DateTime.Now.ToString() %>
    </div>
    </form>
</body>
</html>
<%@ Page Language="VB" %>
<%@ OutputCache VaryByParam="none" Duration="10" VaryByContentEncodings="gzip" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>Varying Output Cache By Content Encoding</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    <%= DateTime.Now.ToString() %>
    </div>
    </form>
</body>
</html>

Remarques

Le VaryByContentEncodings propriété est utilisée pour spécifier si les réponses compressées de façon dynamique sont mis en cache.The VaryByContentEncodings property is used to specify whether dynamically compressed responses are cached. La mise en cache des réponses compressées de façon dynamique signifie que le coût de compression est facturé qu’une seule fois, lors de la première demande pour la ressource (ou après un redémarrage de l’application) et lorsque l’élément de cache expire.Caching dynamically compressed responses means that the cost of compression is incurred only one time, during the first request for the resource (or after an application restart) and when the cache item expires.

Le VaryByContentEncodings propriété de la HttpCachePolicy classe identifie les paramètres d’en-tête de demande ASP.NET utilise pour identifier de manière unique une variation de la réponse s’il existe plusieurs réponses mises en cache pour une ressource.The VaryByContentEncodings property of the HttpCachePolicy class identifies which request header parameters ASP.NET uses to uniquely identify a variation of the response if there are multiple cached responses for a resource. Cela est utile lorsqu’une réponse dépend d’un ensemble d’entrées de client, telles que des en-têtes, des paramètres ou des encodages de contenu.This is useful when a response depends on a set of client inputs, such as headers, parameters, or content encodings.

Le HttpCacheVaryByContentEncodings classe n’est pas directement liée aux en-têtes de contrôle du cache HTTP.The HttpCacheVaryByContentEncodings class is not directly related to HTTP cache-control headers. Toutefois, il permet de s’assurer qu’une réponse à un client ou un proxy varie selon l’encodage du contenu spécifié.However, it helps make sure that a response to a client or a proxy varies by the specified content encoding. Le cache varient selon le codage du contenu permet à ASP.NET de varier la réponse par le Accept-Encoding en-tête.Setting the cache to vary by content encoding enables ASP.NET to vary the response by the Accept-Encoding header. Lorsqu’une demande est traitée, le Accept-Encoding est vérifié et le premier codage acceptable est identifié et utilisé pour effectuer l’une des actions suivantes :When a request is processed, the Accept-Encoding header is checked and the first acceptable encoding is identified and used to take one of the following actions:

  • Si un codage correspondant est également trouvé dans la VaryByContentEncodings liste et une réponse mise en cache existent, la réponse mise en cache est envoyée.If a matching encoding is also found in the VaryByContentEncodings list and a cached response exists, the cached response is sent.

  • Si un codage correspondant est également trouvé dans la VaryByContentEncodings liste mais une réponse mise en cache n’existe pas, une réponse est générée et insérée dans le cache.If a matching encoding is also found in the VaryByContentEncodings list but a cached response does not exist, a response is generated and inserted into the cache.

  • Si un codage correspondant est introuvable dans le VaryByContentEncodings , le cache de recherche est effectuée pour une réponse non codée, également appelée la réponse d’identité.If a matching encoding is not found in the VaryByContentEncodings list, the cache is searched for a non-encoded response, also referred to as the identity response. Si la réponse d’identité est trouvée, il est envoyé.If the identity response is found, it is sent. Sinon, une nouvelle réponse non codée est générée et stockée dans le cache.Otherwise a new non-encoded response is generated and stored in the cache.

Pour plus d’informations sur la VaryByContentEncodings propriété, consultez le document RFC 2616 : Hypertext Transfer Protocol--HTTP/1.1, disponible sur le site Web du World Wide Web Consortium (W3C).For more information about the VaryByContentEncodings property, see RFC 2616: Hypertext Transfer Protocol -- HTTP/1.1, available on the World Wide Web Consortium (W3C) Web site. Consultez la section 14, « Définitions de champ d’en-tête », pour plus d’informations.See section 14, "Header Field Definitions", for complete details.

Vous pouvez définir le VaryByContentEncodings propriété à l’aide de la directive ou en ajoutant un profil à l’élément dans le fichier Web.config.You can set the VaryByContentEncodings property by using the directive or by adding a profile to the element in the Web.config file.

Constructeurs

HttpCacheVaryByContentEncodings() HttpCacheVaryByContentEncodings() HttpCacheVaryByContentEncodings() HttpCacheVaryByContentEncodings()

Initialise une nouvelle instance de la classe HttpCacheVaryByContentEncodings.Initializes a new instance of the HttpCacheVaryByContentEncodings class.

Propriétés

Item[String] Item[String] Item[String] Item[String]

Obtient ou définit une valeur qui indique si le cache varie en fonction du codage de contenu spécifié.Gets or sets a value that indicates whether the cache varies according to the specified content encoding.

Méthodes

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)
GetContentEncodings() GetContentEncodings() GetContentEncodings() GetContentEncodings()

Obtient un tableau de valeurs qui spécifient les encodages de contenu devant être utilisés pour faire varier le cache.Gets an array of values which specify the content encodings to be used for varying the cache.

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

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

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
SetContentEncodings(String[]) SetContentEncodings(String[]) SetContentEncodings(String[]) SetContentEncodings(String[])

Définit un tableau de valeurs qui spécifient les encodages de contenu devant être utilisés pour faire varier le cache.Sets an array of values which specify the content encodings to be used for varying the cache.

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)

S’applique à

Voir aussi