HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) Method

Definición

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.Allows insertion of response substitution blocks into the response, which allows dynamic generation of specified response regions for output cached responses.

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)

Parámetros

callback
HttpResponseSubstitutionCallback HttpResponseSubstitutionCallback HttpResponseSubstitutionCallback HttpResponseSubstitutionCallback

Método, control de usuario u objeto que se va a sustituir.The method, user control, or object to substitute.

Excepciones

El destino del parámetro callback es de tipo Control.The target of the callback parameter is of type Control.

Comentarios

Puede usar el método WriteSubstitution para la sustitución posterior a la caché en las páginas almacenadas en caché de salida.You can use the WriteSubstitution method for post-cache substitution in your output-cached pages. Al pasar un HttpContext objeto a un método de devolución de llamada HttpResponseSubstitutionCallback con una firma prescrita, puede reemplazar el contenido almacenado en caché de salida en cualquier ubicación determinada en la caché de páginas.By passing a HttpContext object to a callback method with a prescribed HttpResponseSubstitutionCallback signature, you can replace output cached content at any given location in the page cache. Para iniciar el reemplazo, llame WriteSubstitution al método, pasándole el método de devolución de llamada, que debe ser seguro para subprocesos y puede ser cualquiera de los siguientes:To initiate the replacement, call the WriteSubstitution method, passing it the callback method, which must be thread safe and can be either of the following:

  • Un método estático en la página del contenedor o en el control de usuario.A static method on the container page or user control.

  • Un método estático o de instancia en otro objeto arbitrario.A static or instance method on another arbitrary object.

En la primera solicitud a la página, el WriteSubstitution HttpResponseSubstitutionCallback llama al delegado para generar la salida.On the first request to the page, the WriteSubstitution calls the HttpResponseSubstitutionCallback delegate to produce the output. A continuación, agrega un búfer de sustitución a la respuesta, que conserva el delegado al que se llamará en futuras solicitudes.Then, it adds a substitution buffer to the response, which retains the delegate to call on future requests. Por último, degrada la caché del lado cliente de solo de público a servidor, lo que garantiza que las solicitudes futuras a la página vuelvan a invocar el delegado al no almacenar en memoria caché en el cliente.Finally, it degrades client-side cacheability from public to server-only, ensuring future requests to the page re-invoke the delegate by not caching on the client.

Nota

No se admite la sustitución posterior a la caché en un control de usuario almacenado en caché donde el almacenamiento en caché de resultados se aplica en el nivel de control de usuario.Post-cache substitution is not supported for a cached user control where output caching is applied at the user control level. Esto también se conoce como almacenamiento en caché de fragmentos.This is also known as fragment caching. Para obtener más información, vea almacenar en caché partes de una página de ASP.net.For more information, see Caching Portions of an ASP.NET Page.

Se aplica a

Consulte también: