HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) Metoda

  • Reference

Definice

Obor názvů:
System.Web
Sestavení:
System.Web.dll

Umožňuje vložení náhradních bloků odpovědí do odpovědi, což umožňuje dynamické generování zadaných oblastí odpovědi pro výstupní odpovědi uložené v mezipaměti.

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)

Parametry

callback
HttpResponseSubstitutionCallback

Metoda, uživatelský ovládací prvek nebo objekt, který chcete nahradit.

Výjimky

ArgumentException

Cíl parametru callback je typu Control.

Poznámky

Na stránkách s výstupem v mezipaměti můžete použít metodu WriteSubstitution pro nahrazení po mezipaměti. Předáním objektu HttpContext metodě zpětného volání s předaným HttpResponseSubstitutionCallback podpisem můžete nahradit výstupní obsah uložený v mezipaměti v libovolném umístění v mezipaměti stránky. Chcete-li zahájit nahrazení, zavolejte metodu WriteSubstitution a předejte jí metodu zpětného volání, která musí být bezpečná pro přístup z více vláken a může mít jednu z následujících možností:

  • Statická metoda na stránce kontejneru nebo na uživatelském ovládacím prvku.
  • Statická metoda nebo metoda instance na jiném libovolném objektu.

Při prvním požadavku na stránku volá delegátaHttpResponseSubstitutionCallback, WriteSubstitution který vygeneruje výstup. Potom do odpovědi přidá náhradní vyrovnávací paměť, která si zachová delegáta pro volání v budoucích požadavcích. Nakonec se snižuje mezipaměť na straně klienta z veřejné na serverovou a zajišťuje, aby budoucí požadavky na stránku znovu vyvolaly delegáta tím, že v klientovi nebudou uloženy do mezipaměti.

Poznámka

Náhrada po mezipaměti není podporována pro uživatelský ovládací prvek uložený v mezipaměti, kde se na úrovni uživatelského ovládacího prvku používá ukládání výstupu do mezipaměti. To se také označuje jako ukládání fragmentů do mezipaměti. Další informace najdete v tématu Ukládání částí ASP.NET stránky do mezipaměti.

Platí pro

Viz také