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í bloků nahrazení odpovědí do odpovědi, což umožňuje dynamické generování zadaných oblastí odpovědí 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
Metodu WriteSubstitution pro nahrazení po mezipaměti můžete použít na stránkách s výstupní mezipamětí. Předáním objektu HttpContext metodě zpětného volání s předepsaného HttpResponseSubstitutionCallback podpisu můžete nahradit výstupní obsah uložený v mezipaměti v libovolném místě v mezipaměti stránky. Chcete-li zahájit nahrazení, zavolejte metodu WriteSubstitution a předejte ji metodu zpětného volání, která musí být bezpečná pro vlákno a může to být některý z následujících způsobů:
- Statická metoda na stránce kontejneru nebo 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á WriteSubstitution delegáta, HttpResponseSubstitutionCallback aby vytvořil výstup. Pak přidá vyrovnávací paměť náhrady do odpovědi, která zachová delegáta pro volání budoucích požadavků. Nakonec snižuje možnosti mezipaměti na straně klienta z veřejné na server, čímž zajistí, aby budoucí požadavky na stránku znovu vyvolaly delegáta tím, že se neukládají do mezipaměti na klientovi.
Note
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žije ukládání výstupu do mezipaměti. Označuje se také jako ukládání do mezipaměti fragmentů. Další informace najdete v tématu Caching Části stránky ASP.NET.
