Substitution Třída
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í.
Určuje oddíl na webové stránce uložené ve výstupní mezipaměti, která je vyloučena z ukládání do mezipaměti. V tomto umístění se dynamický obsah načte a nahradí ovládací prvek Substitution .
public ref class Substitution : System::Web::UI::Control
public class Substitution : System.Web.UI.Control
type Substitution = class
inherit Control
Public Class Substitution
Inherits Control
- Dědičnost
Příklady
Následující příklad kódu ukazuje, jak přidat Substitution ovládací prvek deklarativně do výstupní mezipaměti webové stránky. Po načtení stránky se uživateli v popisku zobrazí aktuální datum a čas. Tento oddíl stránky se ukládá do mezipaměti a aktualizuje se pouze každých 60 sekund. Při spuštění Substitution ovládacího prvku volá metodu GetCurrentDateTime
. Uživateli se zobrazí řetězec vrácený nástrojem GetCurrentDateTime
. Tento oddíl stránky není uložen v mezipaměti a aktualizuje se při každé aktualizaci stránky.
<%@ outputcache duration="60" varybyparam="none" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server" language="C#">
void Page_Load(object sender, System.EventArgs e)
{
// Display the current date and time in the label.
// Output caching applies to this section of the page.
CachedDateLabel.Text = DateTime.Now.ToString();
}
// The Substitution control calls this method to retrieve
// the current date and time. This section of the page
// is exempt from output caching.
public static string GetCurrentDateTime (HttpContext context)
{
return DateTime.Now.ToString ();
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Substitution Class Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Substitution Class Example</h3>
<p>This section of the page is not cached:</p>
<asp:substitution id="Substitution1"
methodname="GetCurrentDateTime"
runat="Server">
</asp:substitution>
<br />
<p>This section of the page is cached:</p>
<asp:label id="CachedDateLabel"
runat="Server">
</asp:label>
<br /><br />
<asp:button id="RefreshButton"
text="Refresh Page"
runat="Server">
</asp:button>
</form>
</body>
</html>
<%@ outputcache duration="60" varybyparam="none" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server" language="VB">
Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
' Display the current date and time in the label.
' Output caching applies to this section of the page.
CachedDateLabel.Text = DateTime.Now.ToString()
End Sub
' The Substitution control calls this method to retrieve
' the current date and time. This section of the page
' is exempt from output caching.
Shared Function GetCurrentDateTime(ByVal context As HttpContext) As String
Return DateTime.Now.ToString()
End Function
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>Substitution Class Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>Substitution Class Example</h3>
<p>This section of the page is not cached:</p>
<asp:substitution id="Substitution1"
methodname="GetCurrentDateTime"
runat="Server">
</asp:substitution>
<br />
<p>This section of the page is cached:</p>
<asp:label id="CachedDateLabel"
runat="Server">
</asp:label>
<br /><br />
<asp:button id="RefreshButton"
text="Refresh Page"
runat="Server">
</asp:button>
</form>
</body>
</html>
Poznámky
V tomto tématu:
Úvod
Substitution Pomocí ovládacího prvku určete oddíl na webové stránce s mezipamětí, kde má být ovládací prvek nahrazen dynamickým obsahem. Tento Substitution ovládací prvek nabízí zjednodušené řešení částečného ukládání stránek do mezipaměti pro stránky, na kterých se ukládá většina obsahu do mezipaměti. Výstupem můžete uložit do mezipaměti celou stránku a pak pomocí Substitution ovládacích prvků určit části stránky, které jsou z ukládání do mezipaměti vyloučené. Oblasti v mezipaměti se spouštějí pouze jednou a přehrávají se z mezipaměti, dokud nevyprší platnost položky mezipaměti nebo se nevyprázdní. Dynamické oblasti se spustí při každém požadavku na stránku. Tento model ukládání do mezipaměti zjednodušuje kód pro stránky, které jsou primárně statické, protože není nutné zapouzdřovat oddíly pro ukládání do mezipaměti v uživatelských ovládacích prvcích webu. Tento model ukládání do mezipaměti je například užitečný ve scénáři, kdy máte stránku, která obsahuje statický obsah, například příspěvky, a AdRotator ovládací prvek, který zobrazuje reklamy. Příspěvky se nemění, což znamená, že se dají ukládat do mezipaměti. Pokaždé, když ale uživatel požádá o stránku, chcete zobrazit novou reklamu. Ovládací AdRotator prvek přímo podporuje nahrazení po mezipaměti a vykresluje novou reklamu pokaždé, když se stránka vrátí, bez ohledu na to, jestli je stránka uložená v mezipaměti.
Poznámka
Ovládací prvek můžete umístit Substitution do uživatelského ovládacího prvku, který je součástí stránky uložené v mezipaměti. Ovládací prvek však nelze umístit do Substitution uživatelského ovládacího prvku uloženého ve výstupní mezipaměti.
Substitution Při spuštění ovládacího prvku volá metodu, která vrací řetězec. Řetězec, který metoda vrátí, je obsah, který se má zobrazit na stránce v umístění Substitution ovládacího prvku. MethodName Pomocí vlastnosti zadejte název metody zpětného volání, která se má vyvolat při Substitution spuštění ovládacího prvku. Metoda zpětného volání, kterou zadáte, musí být statickou metodou na stránce nebo uživatelským ovládacím Substitution prvku, který obsahuje ovládací prvek. Podpis metody zpětného volání se musí shodovat s podpisem delegáta HttpResponseSubstitutionCallback , který přebírá HttpContext parametr a vrací řetězec.
Pokud chcete pracovat s výstupní mezipamětí stránky, můžete použít direktivu @ OutputCache , HttpCachePolicy třídu nebo Cache vlastnost . Další informace o ukládání stránek do mezipaměti najdete v tématech Ukládání ASP.NET stránek do mezipaměti a Ukládání částí ASP.NET stránky do mezipaměti.
Jako alternativu k použití Substitution ovládacího prvku můžete také získat chování při ukládání náhradních do mezipaměti pomocí delegáta HttpResponseSubstitutionCallback . Kromě toho můžete získat chování při ukládání náhradních položek do mezipaměti u ovládacích prvků, jako AdRotator je například ovládací prvek, které tuto funkci přímo podporují. Další informace najdete v tématu Dynamická aktualizace částí stránky v mezipaměti.
Deklarativní syntaxe
<asp:Substitution
EnableTheming="True|False"
EnableViewState="True|False"
ID="string"
MethodName="string"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
runat="server"
SkinID="string"
Visible="True|False"
/>
Konstruktory
Substitution() |
Inicializuje novou instanci Substitution třídy . |
Vlastnosti
Adapter |
Získá adaptér specifické pro prohlížeč pro ovládací prvek. (Zděděno od Control) |
AppRelativeTemplateSourceDirectory |
Získá nebo nastaví aplikaci relativní virtuální adresář nebo UserControl objektuPage, který obsahuje tento ovládací prvek. (Zděděno od Control) |
BindingContainer |
Získá ovládací prvek, který obsahuje datové vazby tohoto ovládacího prvku. (Zděděno od Control) |
ChildControlsCreated |
Získá hodnotu, která označuje, zda byly vytvořeny podřízené ovládací prvky serverového ovládacího prvku. (Zděděno od Control) |
ClientID |
Získá ID ovládacího prvku pro kód HTML, který je generován ASP.NET. (Zděděno od Control) |
ClientIDMode |
Získá nebo nastaví algoritmus, který se používá k vygenerování hodnoty ClientID vlastnosti. (Zděděno od Control) |
ClientIDSeparator |
Získá hodnotu znaku představující znak oddělovače použitý ve ClientID vlastnosti . (Zděděno od Control) |
Context |
HttpContext Získá objekt přidružený k ovládacímu prvku serveru pro aktuální webový požadavek. (Zděděno od Control) |
Controls |
ControlCollection Získá objekt, který představuje podřízené ovládací prvky pro zadaný serverový ovládací prvek v hierarchii uživatelského rozhraní. (Zděděno od Control) |
DataItemContainer |
Získá odkaz na názvový kontejner, pokud názvový kontejner implementuje IDataItemContainer. (Zděděno od Control) |
DataKeysContainer |
Získá odkaz na názvový kontejner, pokud názvový kontejner implementuje IDataKeysControl. (Zděděno od Control) |
DesignMode |
Získá hodnotu označující, zda je ovládací prvek použit na návrhové ploše. (Zděděno od Control) |
EnableTheming |
Získá nebo nastaví hodnotu označující, zda motivy použít pro tento ovládací prvek. (Zděděno od Control) |
EnableViewState |
Získá nebo nastaví hodnotu označující, zda serverový ovládací prvek zachová svůj stav zobrazení a stav zobrazení všech podřízených ovládacích prvků, které obsahuje, do žádajícího klienta. (Zděděno od Control) |
Events |
Získá seznam delegátů obslužné rutiny události pro ovládací prvek. Tato vlastnost je jen ke čtení. (Zděděno od Control) |
HasChildViewState |
Získá hodnotu označující, zda podřízené ovládací prvky aktuálního serveru mají nějaké uložené nastavení stavu zobrazení. (Zděděno od Control) |
ID |
Získá nebo nastaví programový identifikátor přiřazený k ovládacímu prvku serveru. (Zděděno od Control) |
IdSeparator |
Získá znak použitý k oddělení identifikátorů ovládacích prvků. (Zděděno od Control) |
IsChildControlStateCleared |
Získá hodnotu označující, zda ovládací prvky obsažené v tomto ovládacím prvku mají stav řízení. (Zděděno od Control) |
IsTrackingViewState |
Získá hodnotu, která označuje, zda serverový ovládací prvek ukládá změny do stavu zobrazení. (Zděděno od Control) |
IsViewStateEnabled |
Získá hodnotu označující, zda je stav zobrazení povolen pro tento ovládací prvek. (Zděděno od Control) |
LoadViewStateByID |
Získá hodnotu označující, zda se ovládací prvek účastní načítání stavu zobrazení namísto ID indexu. (Zděděno od Control) |
MethodName |
Získá nebo nastaví název metody zpětné volání vyvolá při Substitution spuštění ovládacího prvku. |
NamingContainer |
Získá odkaz na názvový kontejner serverového ovládacího prvku, který vytvoří jedinečný obor názvů pro odlizení mezi ovládacími prvky serveru se stejnou ID hodnotou vlastnosti. (Zděděno od Control) |
Page |
Získá odkaz na Page instanci, která obsahuje serverový ovládací prvek. (Zděděno od Control) |
Parent |
Získá odkaz na nadřazený ovládací prvek serveru v hierarchii ovládacích prvků stránky. (Zděděno od Control) |
RenderingCompatibility |
Získá hodnotu, která určuje ASP.NET verze, která vykreslovala HTML bude kompatibilní s. (Zděděno od Control) |
Site |
Získá informace o kontejneru, který je hostitelem aktuálního ovládacího prvku při vykreslení na návrhové ploše. (Zděděno od Control) |
SkinID |
Získá nebo nastaví vzhled pro použití ovládacího prvku. (Zděděno od Control) |
TemplateControl |
Získá nebo nastaví odkaz na šablonu, která obsahuje tento ovládací prvek. (Zděděno od Control) |
TemplateSourceDirectory |
Získá virtuální adresář Page nebo UserControl , který obsahuje aktuální serverový ovládací prvek. (Zděděno od Control) |
UniqueID |
Získá jedinečný hierarchicky kvalifikovaný identifikátor serverového ovládacího prvku. (Zděděno od Control) |
ValidateRequestMode |
Získá nebo nastaví hodnotu, která označuje, zda ovládací prvek kontroluje vstup klienta z prohlížeče pro potenciálně nebezpečné hodnoty. (Zděděno od Control) |
ViewState |
Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení serverového ovládacího prvku napříč více požadavky na stejnou stránku. (Zděděno od Control) |
ViewStateIgnoresCase |
Získá hodnotu, která označuje, zda StateBag objekt nerozlišuje malá a velká písmena. (Zděděno od Control) |
ViewStateMode |
Získá nebo nastaví režim zobrazení stavu tohoto ovládacího prvku. (Zděděno od Control) |
Visible |
Získá nebo nastaví hodnotu, která označuje, zda je serverový ovládací prvek vykreslen jako uživatelské rozhraní na stránce. (Zděděno od Control) |
Metody
AddedControl(Control, Int32) |
Volá se po přidání podřízeného ovládacího prvku do Controls kolekce objektu Control . (Zděděno od Control) |
AddParsedSubObject(Object) |
Upozorní ovládací prvek serveru, že byl analyzován element XML nebo HTML, a přidá element do objektu serverového ControlCollection ovládacího prvku. (Zděděno od Control) |
ApplyStyleSheetSkin(Page) |
Použije na ovládací prvek vlastnosti stylu definované v šabloně stylů stránky. (Zděděno od Control) |
BeginRenderTracing(TextWriter, Object) |
Začíná trasování vykreslovaných dat v době návrhu. (Zděděno od Control) |
BuildProfileTree(String, Boolean) |
Shromáždí informace o serverovém ovládacím prvku a předá je vlastnosti Trace , která se má zobrazit, když je pro stránku povoleno trasování. (Zděděno od Control) |
ClearCachedClientID() |
Nastaví hodnotu v ClientID mezipaměti na |
ClearChildControlState() |
Odstraní informace o stavu ovládacího prvku pro podřízené ovládací prvky serveru. (Zděděno od Control) |
ClearChildState() |
Odstraní informace o stavu zobrazení a stavu řízení pro všechny podřízené ovládací prvky serveru. (Zděděno od Control) |
ClearChildViewState() |
Odstraní informace o stavu zobrazení pro všechny podřízené ovládací prvky serveru. (Zděděno od Control) |
ClearEffectiveClientIDMode() |
ClientIDMode Nastaví vlastnost instance aktuálního ovládacího prvku a všech podřízených ovládacích prvků na Inherit. (Zděděno od Control) |
CreateChildControls() |
Volána rozhraním ASP.NET stránky k upozornění serverových ovládacích prvků, které používají implementaci založenou na složení k vytvoření všech podřízených ovládacích prvků, které obsahují při přípravě na zaúčtování zpět nebo vykreslení. (Zděděno od Control) |
CreateControlCollection() |
EmptyControlCollection Vrátí objekt, který označuje, že Substitution ovládací prvek nepodporuje podřízené ovládací prvky. |
DataBind() |
Vytvoří vazbu zdroje dat na vyvolaný serverový ovládací prvek a všechny jeho podřízené ovládací prvky. (Zděděno od Control) |
DataBind(Boolean) |
Vytvoří vazbu zdroje dat na vyvolaný ovládací prvek serveru a všechny jeho podřízené ovládací prvky s možností vyvolat DataBinding událost. (Zděděno od Control) |
DataBindChildren() |
Vytvoří vazbu zdroje dat na podřízené ovládací prvky serveru. (Zděděno od Control) |
Dispose() |
Umožňuje ovládacímu prvku serveru provést konečné vyčištění před uvolněním z paměti. (Zděděno od Control) |
EndRenderTracing(TextWriter, Object) |
Ukončí trasování doby návrhu vykreslovaných dat. (Zděděno od Control) |
EnsureChildControls() |
Určuje, zda serverový ovládací prvek obsahuje podřízené ovládací prvky. Pokud ne, vytvoří podřízené ovládací prvky. (Zděděno od Control) |
EnsureID() |
Vytvoří identifikátor pro ovládací prvky, které nemají přiřazený identifikátor. (Zděděno od Control) |
Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
FindControl(String) |
Vyhledá v aktuálním názvovém kontejneru serverový ovládací prvek se zadaným |
FindControl(String, Int32) |
Vyhledá v aktuálním kontejneru pojmenování serverový ovládací prvek se zadaným |
Focus() |
Nastaví fokus vstupu na ovládací prvek. (Zděděno od Control) |
GetDesignModeState() |
Získá data v době návrhu pro ovládací prvek. (Zděděno od Control) |
GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
GetRouteUrl(Object) |
Získá adresu URL, která odpovídá sadě parametrů trasy. (Zděděno od Control) |
GetRouteUrl(RouteValueDictionary) |
Získá adresu URL, která odpovídá sadě parametrů trasy. (Zděděno od Control) |
GetRouteUrl(String, Object) |
Získá adresu URL, která odpovídá sadě parametrů trasy a název trasy. (Zděděno od Control) |
GetRouteUrl(String, RouteValueDictionary) |
Získá adresu URL, která odpovídá sadě parametrů trasy a název trasy. (Zděděno od Control) |
GetType() |
Type Získá z aktuální instance. (Zděděno od Object) |
GetUniqueIDRelativeTo(Control) |
Vrátí část UniqueID vlastnosti zadaného ovládacího prvku s předponou. (Zděděno od Control) |
HasControls() |
Určuje, zda serverový ovládací prvek obsahuje nějaké podřízené ovládací prvky. (Zděděno od Control) |
HasEvents() |
Vrátí hodnotu označující, zda jsou události registrovány pro ovládací prvek nebo jakékoli podřízené ovládací prvky. (Zděděno od Control) |
IsLiteralContent() |
Určuje, zda serverový ovládací prvek obsahuje pouze obsah literálu. (Zděděno od Control) |
LoadControlState(Object) |
Obnoví informace o stavu řízení z předchozího požadavku stránky, který byl uložen metodou SaveControlState() . (Zděděno od Control) |
LoadViewState(Object) |
Obnoví informace o stavu zobrazení z předchozího požadavku stránky, který byl uložen metodou SaveViewState() . (Zděděno od Control) |
MapPathSecure(String) |
Načte fyzickou cestu, na kterou se mapuje virtuální cesta, absolutní nebo relativní. (Zděděno od Control) |
MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
OnBubbleEvent(Object, EventArgs) |
Určuje, zda je událost serverového ovládacího prvku předána hierarchii serveru uživatelského rozhraní stránky. (Zděděno od Control) |
OnDataBinding(EventArgs) |
DataBinding Vyvolá událost. (Zděděno od Control) |
OnInit(EventArgs) |
Init Vyvolá událost. (Zděděno od Control) |
OnLoad(EventArgs) |
Load Vyvolá událost. (Zděděno od Control) |
OnPreRender(EventArgs) |
PreRender Vyvolá událost. |
OnUnload(EventArgs) |
Unload Vyvolá událost. (Zděděno od Control) |
OpenFile(String) |
Stream Získá používá ke čtení souboru. (Zděděno od Control) |
RaiseBubbleEvent(Object, EventArgs) |
Přiřadí všechny zdroje události a její informace nadřazené ovládacímu prvku. (Zděděno od Control) |
RemovedControl(Control) |
Volá se po odebrání podřízeného ovládacího prvku z Controls kolekce objektu Control . (Zděděno od Control) |
Render(HtmlTextWriter) |
Odesílá obsah řízení serveru do zadaného HtmlTextWriter objektu, který zapisuje obsah, který se má vykreslit na klientovi. |
RenderChildren(HtmlTextWriter) |
Vypíše obsah podřízených položek serverového ovládacího prvku do zadaného HtmlTextWriter objektu, který zapíše obsah, který se má vykreslit na klientovi. (Zděděno od Control) |
RenderControl(HtmlTextWriter) |
Vypíše obsah ovládacího prvku serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je trasování povoleno. (Zděděno od Control) |
RenderControl(HtmlTextWriter, ControlAdapter) |
Vypíše obsah řízení serveru do zadaného HtmlTextWriter objektu pomocí zadaného ControlAdapter objektu. (Zděděno od Control) |
ResolveAdapter() |
Získá adaptér ovládacího prvku zodpovědný za vykreslení zadaného ovládacího prvku. (Zděděno od Control) |
ResolveClientUrl(String) |
Získá adresu URL, kterou lze použít v prohlížeči. (Zděděno od Control) |
ResolveUrl(String) |
Převede adresu URL na adresu URL, která je použitelná v žádajícím klientovi. (Zděděno od Control) |
SaveControlState() |
Uloží všechny změny stavu ovládacích prvků serveru, ke kterým došlo od okamžiku, kdy byla stránka odeslána zpět na server. (Zděděno od Control) |
SaveViewState() |
Uloží všechny změny stavu zobrazení ovládacích prvků serveru, ke kterým došlo od okamžiku, kdy byla stránka odeslána zpět na server. (Zděděno od Control) |
SetDesignModeState(IDictionary) |
Nastaví data v době návrhu ovládacího prvku. (Zděděno od Control) |
SetRenderMethodDelegate(RenderMethod) |
Přiřadí delegáta obslužné rutiny události pro vykreslení serverového ovládacího prvku a jeho obsahu do nadřazeného ovládacího prvku. (Zděděno od Control) |
SetTraceData(Object, Object) |
Nastaví trasovací data pro trasování vykreslovaných dat v době návrhu pomocí datového klíče trasování a hodnoty dat trasování. (Zděděno od Control) |
SetTraceData(Object, Object, Object) |
Nastaví trasovací data pro trasování vykreslovaných dat v době návrhu pomocí trasovaného objektu, datového klíče trasování a hodnoty dat trasování. (Zděděno od Control) |
ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
TrackViewState() |
Způsobí sledování změn stavu zobrazení v ovládacím prvku serveru, aby mohly být uloženy v objektu ovládacího prvku StateBag serveru. Tento objekt je přístupný prostřednictvím ViewState vlastnosti . (Zděděno od Control) |
Událost
DataBinding |
Vyvolá se při vytvoření vazby serverového ovládacího prvku na zdroj dat. (Zděděno od Control) |
Disposed |
Vyvolá se při uvolnění serverového ovládacího prvku z paměti, což je poslední fáze životního cyklu řízení serveru, když je požadována ASP.NET stránka. (Zděděno od Control) |
Init |
Vyvolá se při inicializaci serverového ovládacího prvku, což je první krok v jeho životním cyklu. (Zděděno od Control) |
Load |
Vyvolá se při načtení serverového ovládacího prvku do objektu Page . (Zděděno od Control) |
PreRender |
Vyvolá se po načtení objektu Control , ale před vykreslením. (Zděděno od Control) |
Unload |
Vyvolá se při uvolnění serverového ovládacího prvku z paměti. (Zděděno od Control) |
Explicitní implementace rozhraní
Metody rozšíření
FindDataSourceControl(Control) |
Vrátí zdroj dat přidružený k ovládacímu prvku dat pro zadaný ovládací prvek. |
FindFieldTemplate(Control, String) |
Vrátí šablonu pole pro zadaný sloupec v kontejneru názvů zadaného ovládacího prvku. |
FindMetaTable(Control) |
Vrátí objekt metatable pro ovládací prvek obsahující data. |