HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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 -> unitPublic Sub WriteSubstitution (callback As HttpResponseSubstitutionCallback)Parametry
- callback
- HttpResponseSubstitutionCallback
Metoda, uživatelský ovládací prvek nebo objekt, který chcete nahradit.
Výjimky
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.
