HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) Méthode
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.
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 -> unitPublic Sub WriteSubstitution (callback As HttpResponseSubstitutionCallback)Paramètres
- callback
- HttpResponseSubstitutionCallback
La méthode, le contrôle utilisateur ou l'objet à substituer.
Exceptions
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.
