HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Permite la inserción de bloques de sustitución de respuestas en la respuesta, lo que permite generar dinámicamente regiones de respuesta especificadas para las respuestas almacenadas en caché de salida.
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)Parámetros
- callback
- HttpResponseSubstitutionCallback
Método, control de usuario o objeto que se va a sustituir.
Excepciones
El destino del callback parámetro es de tipo Control.
Comentarios
Puede usar el método para la sustitución posterior a la WriteSubstitution caché en las páginas almacenadas en caché de salida. Si pasa un HttpContext objeto a un método de devolución de llamada con una firma prescrita HttpResponseSubstitutionCallback , puede reemplazar el contenido almacenado en caché de salida en cualquier ubicación determinada de la memoria caché de páginas. Para iniciar el reemplazo, llame al WriteSubstitution método , pasándolo el método de devolución de llamada, que debe ser seguro para subprocesos y puede ser cualquiera de los siguientes:
- Un método estático en la página de contenedor o el control de usuario.
- Método estático o de instancia en otro objeto arbitrario.
En la primera solicitud a la página, WriteSubstitution llama al HttpResponseSubstitutionCallback delegado para generar la salida. A continuación, agrega un búfer de sustitución a la respuesta, que conserva el delegado para llamar a solicitudes futuras. Por último, reduce la capacidad de caché del lado cliente de solo servidor a público, lo que garantiza que las solicitudes futuras a la página vuelvan a invocar el delegado sin almacenar en caché en el cliente.
Note
La sustitución posterior a la caché no se admite para un control de usuario almacenado en caché en el que se aplica el almacenamiento en caché de salida en el nivel de control de usuario. Esto también se conoce como almacenamiento en caché de fragmentos. Para obtener más información, vea Caching Partes de una página de ASP.NET.