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 substitución de respuesta en la respuesta, lo que permite la generación dinámica de regiones de respuesta especificadas para las respuestas almacenadas en la caché de resultados.
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 u objeto que se va a sustituir.
Excepciones
El destino del parámetro callback 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. Al pasar un HttpContext objeto a un método de devolución de llamada con una firma recetada 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 y pase 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 del contenedor o el control de usuario.
- Un 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 en solicitudes futuras. Por último, degrada la capacidad de caché del lado cliente de público a solo servidor, lo que garantiza que las solicitudes futuras a la página vuelvan a invocar el delegado sin almacenar en caché en el cliente.
Nota
La sustitución posterior a la caché no se admite para un control de usuario almacenado en caché donde 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 Almacenamiento en caché de partes de una página de ASP.NET.
