HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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 em cache de saída.
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, controlo do utilizador ou objeto a substituir.
Exceções
O alvo do callback parâmetro é do tipo Control.
Observações
Podes usar o WriteSubstitution método para substituição pós-cache nas tuas páginas em cache de saída. Ao passar um HttpContext objeto para um método de callback com uma assinatura prescrita HttpResponseSubstitutionCallback , pode substituir o conteúdo em cache de saída em qualquer local da cache da página. Para iniciar a substituição, chama o WriteSubstitution método, passando-lhe o método de callback, que deve ser seguro contra threads e pode ser um dos seguintes:
- Um método estático na página do contentor ou controlo do utilizador.
- Um método estático ou de instância noutro objeto arbitrário.
No primeiro pedido à página, chama WriteSubstitution o HttpResponseSubstitutionCallback delegado para produzir a saída. Depois, adiciona um buffer de substituição à resposta, que mantém o delegado para chamar em pedidos futuros. Por fim, degrada a cacheabilidade do lado do cliente de público para apenas servidor, garantindo que futuros pedidos à página reinvoquem o delegado ao não armazenar em cache no cliente.
Note
A substituição pós-cache não é suportada para um controlo de utilizador em cache onde a cache de saída é aplicada ao nível de controlo do utilizador. Isto também é conhecido como cache de fragmentos. Para mais informações, consulte Cache de Partes de uma Página de ASP.NET.