HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) Méthode

  • Référence

Définition

Espace de noms:
System.Web
Assembly:
System.Web.dll

Autorise l'insertion de blocs de substitution de réponse dans la réponse ; cette technique permet la génération dynamique de régions de réponse spécifiées pour les réponses de sortie mises en cache.

public:
 void WriteSubstitution(System::Web::HttpResponseSubstitutionCallback ^ callback);
public void WriteSubstitution (System.Web.HttpResponseSubstitutionCallback callback);
member this.WriteSubstitution : System.Web.HttpResponseSubstitutionCallback -> unit
Public Sub WriteSubstitution (callback As HttpResponseSubstitutionCallback)

Paramètres

callback
HttpResponseSubstitutionCallback

La méthode, le contrôle utilisateur ou l'objet à substituer.

Exceptions

ArgumentException

La cible du paramètre callback est de type Control.

Remarques

Vous pouvez utiliser la méthode pour la WriteSubstitution substitution post-cache dans vos pages mises en cache de sortie. En passant un HttpContext objet à une méthode de rappel avec une signature prescrite HttpResponseSubstitutionCallback , vous pouvez remplacer le contenu mis en cache de sortie à n’importe quel emplacement donné dans le cache de page. Pour lancer le remplacement, appelez la WriteSubstitution méthode en lui passant la méthode de rappel, qui doit être thread-safe et peut être l’une des suivantes :

  • Méthode statique sur la page de conteneur ou le contrôle utilisateur.
  • Méthode statique ou instance sur un autre objet arbitraire.

Lors de la première demande à la page, le WriteSubstitution appelle le HttpResponseSubstitutionCallback délégué pour produire la sortie. Ensuite, il ajoute une mémoire tampon de substitution à la réponse, qui conserve le délégué pour appeler sur les demandes futures. Enfin, il dégrade la mise en cache côté client du niveau public au niveau serveur uniquement, garantissant ainsi que les futures demandes adressées à la page révoquaient le délégué en ne mettant pas en cache sur le client.

Notes

La substitution post-cache n’est pas prise en charge pour un contrôle utilisateur mis en cache où la mise en cache de sortie est appliquée au niveau du contrôle utilisateur. C’est également ce qu’on appelle la mise en cache de fragments. Pour plus d’informations, consultez Mise en cache de parties d’une page ASP.NET.

S’applique à

Voir aussi