HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> unitPublic 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
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.
