HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) Método

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.

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

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.

Se aplica a

Consulte también