HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) Método

  • Referência

Definição

Namespace:
System.Web
Assembly:
System.Web.dll

Permite a inserção de blocos de substituição de resposta na resposta, o que permite a geração dinâmica de regiões de resposta especificadas para respostas de saída em cache.

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

O método, o controle de usuário ou o objeto a ser substituído.

Exceções

ArgumentException

O destino do parâmetro callback é do tipo Control.

Comentários

Você pode usar o WriteSubstitution método para substituição pós-cache em suas páginas armazenadas em cache de saída. Ao passar um HttpContext objeto para um método de retorno de chamada com uma assinatura prescrita HttpResponseSubstitutionCallback , você pode substituir o conteúdo armazenado em cache de saída em qualquer local específico no cache de páginas. Para iniciar a substituição, chame o WriteSubstitution método , passando-o para o método de retorno de chamada, que deve ser thread-safe e pode ser um dos seguintes:

  • Um método estático na página de contêiner ou controle de usuário.
  • Um método estático ou de instância em outro objeto arbitrário.

Na primeira solicitação para a página, o WriteSubstitution chama o HttpResponseSubstitutionCallback delegado para produzir a saída. Em seguida, ele adiciona um buffer de substituição à resposta, que retém o delegado para chamar em solicitações futuras. Por fim, ele degrada a capacidade de cache do lado do cliente de público para somente servidor, garantindo solicitações futuras para a página invocando novamente o delegado não armazenando em cache no cliente.

Observação

Não há suporte para substituição pós-cache para um controle de usuário armazenado em cache em que o cache de saída é aplicado no nível de controle do usuário. Isso também é conhecido como cache de fragmento. Para obter mais informações, consulte Armazenando em cache partes de uma página ASP.NET.

Aplica-se a

Confira também