Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe Substitution

 

Especifica uma seção em uma página da Web de cache de saída que é isenta de cache. Nesse local, o conteúdo dinâmico é recuperado e substituído pelo controle Substitution.

Namespace:   System.Web.UI.WebControls
Assembly:  System.Web (em System.Web.dll)

System.Object
  System.Web.UI.Control
    System.Web.UI.WebControls.Substitution

public class Substitution : Control

NomeDescrição
System_CAPS_pubmethodSubstitution()

Inicializa uma nova instância da classe Substitution.

NomeDescrição
System_CAPS_protpropertyAdapter

Obtém as especificações do navegador para o controle. (Herdado de Control.)

System_CAPS_pubpropertyAppRelativeTemplateSourceDirectory

Obtém ou define o diretório virtual relativo de aplicativo do objeto Page ou UserControl que contém este controle.(Herdado de Control.)

System_CAPS_pubpropertyBindingContainer

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Obtém o controle que contém a vinculação de dados desse controle.(Herdado de Control.)

System_CAPS_protpropertyChildControlsCreated

Obtém um valor que indica se os controles filho do controle de servidor foram criados.(Herdado de Control.)

System_CAPS_pubpropertyClientID

Obtém o identificador do controle gerado pelo ASP.NET. (Herdado de Control.)

System_CAPS_pubpropertyClientIDMode

Obtém ou define o algoritmo usado para gerar o valor da propriedade ClientID.(Herdado de Control.)

System_CAPS_protpropertyClientIDSeparator

Obtém um valor de caractere que representa o caractere separador usado na propriedade ClientID.(Herdado de Control.)

System_CAPS_protpropertyContext

Obtém o objeto HttpContext associado ao controle de servidor para a solicitação da Web atual.(Herdado de Control.)

System_CAPS_pubpropertyControls

Obtém um objeto ControlCollection que representa os controles filho para um controle de servidor especificado na hierarquia de interface do usuário.(Herdado de Control.)

System_CAPS_pubpropertyDataItemContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataItemContainer.(Herdado de Control.)

System_CAPS_pubpropertyDataKeysContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataKeysControl.(Herdado de Control.)

System_CAPS_protpropertyDesignMode

Obtém um valor que indica se um controle está sendo usado em uma superfície de design.(Herdado de Control.)

System_CAPS_pubpropertyEnableTheming

Obtém ou define um valor que indica se os temas se aplicam a esse controle.(Herdado de Control.)

System_CAPS_pubpropertyEnableViewState

Obtém ou define um valor que indica se o controle de servidor persiste seu estado de exibição e o estado de exibição de quaisquer controles filho que ele contém, para o cliente solicitante.(Herdado de Control.)

System_CAPS_protpropertyEvents

Obtém uma lista de delegados de manipulador de eventos para o controle. Esta propriedade é somente para leitura.(Herdado de Control.)

System_CAPS_protpropertyHasChildViewState

Obtém um valor indicando se os atuais controles filhos do controle do servidor têm quaisquer configurações do estado de visualização salvas.(Herdado de Control.)

System_CAPS_pubpropertyID

Obtém ou define o identificador programático atribuído ao controle de servidor.(Herdado de Control.)

System_CAPS_protpropertyIdSeparator

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Obtém o caractere usado para separar identificadores de controle.(Herdado de Control.)

System_CAPS_protpropertyIsChildControlStateCleared

Obtém um valor que indica se os controles contidos dentro deste controle têm estado do controle.(Herdado de Control.)

System_CAPS_protpropertyIsTrackingViewState

Obtém um valor que indica se o controle de servidor está salvando as alterações em seu estado de exibição.(Herdado de Control.)

System_CAPS_protpropertyIsViewStateEnabled

Obtém um valor que indica se o estado de exibição está habilitado para esse controle.(Herdado de Control.)

System_CAPS_protpropertyLoadViewStateByID

Obtém um valor que indica se o controle participa do carregamento do estado de exibição por ID em vez do índice.(Herdado de Control.)

System_CAPS_pubpropertyMethodName

Obtém ou define o nome do método de retorno de chamada para chamar quando o Substitution controle executa.

System_CAPS_pubpropertyNamingContainer

Obtém uma referência ao contêiner de nomenclatura do controle do servidor, que cria um namespace exclusivo para diferenciar entre os controles de servidor com o mesmo valor da propriedade Control.ID.(Herdado de Control.)

System_CAPS_pubpropertyPage

Obtém uma referência para a instância Page que contém o controle de servidor.(Herdado de Control.)

System_CAPS_pubpropertyParent

Obtém uma referência ao controle pai do controle de servidor na hierarquia de controle da página.(Herdado de Control.)

System_CAPS_pubpropertyRenderingCompatibility

Obtém um valor que especifica a versão do ASP.NET com a qual o HTML renderizado será compatível.(Herdado de Control.)

System_CAPS_pubpropertySite

Obtém informações sobre o contêiner que hospeda o controle atual quando renderizados em uma superfície de design.(Herdado de Control.)

System_CAPS_pubpropertySkinID

Obtém ou define a capa a ser aplicada ao controle.(Herdado de Control.)

System_CAPS_pubpropertyTemplateControl

Obtém ou define uma referência ao modelo que contém este controle.(Herdado de Control.)

System_CAPS_pubpropertyTemplateSourceDirectory

Obtém o diretório virtual do Page ou UserControl que contém o controle do servidor atual.(Herdado de Control.)

System_CAPS_pubpropertyUniqueID

Obtém o identificador exclusivo, qualificado segundo a hierarquia, para o controle de servidor.(Herdado de Control.)

System_CAPS_pubpropertyValidateRequestMode

Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador para valores potencialmente perigosos.(Herdado de Control.)

System_CAPS_protpropertyViewState

Obtém um dicionário de informações de estado que permite você salvar e restaurar o estado de exibição de um controle de servidor nas várias solicitações para a mesma página. (Herdado de Control.)

System_CAPS_protpropertyViewStateIgnoresCase

Obtém um valor que indica se o objeto StateBag não diferencia maiúsculas de minúsculas.(Herdado de Control.)

System_CAPS_pubpropertyViewStateMode

Obtém ou define o modo de estado de exibição deste controle.(Herdado de Control.)

System_CAPS_pubpropertyVisible

Obtém ou define um valor que indica se um controle de servidor é renderizado como uma interface do usuário na página.(Herdado de Control.)

NomeDescrição
System_CAPS_protmethodAddedControl(Control, Int32)

Chamado após um controle filho ser adicionado à coleção Controls do objeto Control.(Herdado de Control.)

System_CAPS_protmethodAddParsedSubObject(Object)

Notifica o controle de servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto ControlCollection do controle de servidor.(Herdado de Control.)

System_CAPS_pubmethodApplyStyleSheetSkin(Page)

Aplica as propriedades de estilo definidas na folha de estilos da página ao controle.(Herdado de Control.)

System_CAPS_protmethodBeginRenderTracing(TextWriter, Object)

Começa o rastreamento de tempo de design de dados de renderização.(Herdado de Control.)

System_CAPS_protmethodBuildProfileTree(String, Boolean)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Reúne informações sobre o controle de servidor e enviá-lo para o Trace propriedade a ser exibida quando o rastreamento está habilitado para a página.(Herdado de Control.)

System_CAPS_protmethodClearCachedClientID()

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Define o valor ClientID armazenado em cache como null.(Herdado de Control.)

System_CAPS_protmethodClearChildControlState()

Exclui as informações de estado de controle para os controles filho do controle de servidor.(Herdado de Control.)

System_CAPS_protmethodClearChildState()

Exclui as informações de estado de exibição e estado de controle para controles filho de todo o controle de servidor.(Herdado de Control.)

System_CAPS_protmethodClearChildViewState()

Exclui as informações de estado de exibição para todos os controles filho do controle de servidor.(Herdado de Control.)

System_CAPS_protmethodClearEffectiveClientIDMode()

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Conjuntos de ClientIDMode propriedade da instância atual do controle e de todos os controles filho para Inherit.(Herdado de Control.)

System_CAPS_protmethodCreateChildControls()

Chamado pela estrutura da página ASP.NET para notificar os controles de servidor que usam implementação baseada em composição para criar os controles filho que eles contêm em preparação para postagem ou processamento. (Herdado de Control.)

System_CAPS_protmethodCreateControlCollection()

Retorna um EmptyControlCollection objeto, indicando que o Substitution controle não dá suporte a controles filho.(Substitui o Control.CreateControlCollection().)

System_CAPS_pubmethodDataBind()

Associa uma fonte de dados ao controle de servidor chamado e a todos os seus controles filho.(Herdado de Control.)

System_CAPS_protmethodDataBind(Boolean)

Associa uma fonte de dados ao controle de servidor invocado e todos os seus controles filho com uma opção para gerar o evento DataBinding.(Herdado de Control.)

System_CAPS_protmethodDataBindChildren()

Associa uma fonte de dados para os controles filho do controle de servidor.(Herdado de Control.)

System_CAPS_pubmethodDispose()

Permite que um controle de servidor execute a limpeza final antes do lançamento da memória.(Herdado de Control.)

System_CAPS_protmethodEndRenderTracing(TextWriter, Object)

Termina o rastreamento em tempo de design de dados de renderização.(Herdado de Control.)

System_CAPS_protmethodEnsureChildControls()

Determinará se o controle de servidor contiver controles filho. Se ele não contiver, ele criará controles filho.(Herdado de Control.)

System_CAPS_protmethodEnsureID()

Cria um identificador para controles que não têm um identificador atribuído.(Herdado de Control.)

System_CAPS_pubmethodEquals(Object)

Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)

System_CAPS_protmethodFinalize()

Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)

System_CAPS_pubmethodFindControl(String)

Procura o atual contêiner de nomenclatura de um controle de servidor com o parâmetro id especificado.(Herdado de Control.)

System_CAPS_protmethodFindControl(String, Int32)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Procura o contêiner de nomenclatura atual para um controle de servidor com o id especificado e um inteiro especificado no parâmetro pathOffset, que auxilia na pesquisa. Você não deve substituir esta versão do método FindControl.(Herdado de Control.)

System_CAPS_pubmethodFocus()

Define o foco de entrada para um controle.(Herdado de Control.)

System_CAPS_protmethodGetDesignModeState()

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Obtém dados de tempo de design para um controle.(Herdado de Control.)

System_CAPS_pubmethodGetHashCode()

Serve como a função de hash padrão.(Herdado de Object.)

System_CAPS_pubmethodGetRouteUrl(Object)

Obtém a URL que corresponde a um conjunto de parâmetros de rota.(Herdado de Control.)

System_CAPS_pubmethodGetRouteUrl(RouteValueDictionary)

Obtém a URL que corresponde a um conjunto de parâmetros de rota.(Herdado de Control.)

System_CAPS_pubmethodGetRouteUrl(String, Object)

Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota.(Herdado de Control.)

System_CAPS_pubmethodGetRouteUrl(String, RouteValueDictionary)

Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota.(Herdado de Control.)

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_pubmethodGetUniqueIDRelativeTo(Control)

Retorna a parte prefixada da propriedade UniqueID do controle especificado.(Herdado de Control.)

System_CAPS_pubmethodHasControls()

Determina se o controle de servidor contém algum controle filho.(Herdado de Control.)

System_CAPS_protmethodHasEvents()

Retorna um valor que indica se os eventos são registrados para o controle ou qualquer controle filho.(Herdado de Control.)

System_CAPS_protmethodIsLiteralContent()

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Determina se o controle de servidor contém apenas o conteúdo literal.(Herdado de Control.)

System_CAPS_protmethodLoadControlState(Object)

Restaura informações de estado de controle de uma solicitação de página anterior que foi salva pelo método SaveControlState.(Herdado de Control.)

System_CAPS_protmethodLoadViewState(Object)

Restaura informações de estado de exibição de uma solicitação de página anterior salva pelo método SaveViewState.(Herdado de Control.)

System_CAPS_protmethodMapPathSecure(String)

Recupera o caminho físico que é mapeado para um caminho virtual, relativo ou absoluto.(Herdado de Control.)

System_CAPS_protmethodMemberwiseClone()

Cria uma cópia superficial do Object atual.(Herdado de Object.)

System_CAPS_protmethodOnBubbleEvent(Object, EventArgs)

Determina se o evento do controle de servidor é passado um nível acima da hierarquia de controle de servidor da interface do usuário da página.(Herdado de Control.)

System_CAPS_protmethodOnDataBinding(EventArgs)

Aciona o evento DataBinding.(Herdado de Control.)

System_CAPS_protmethodOnInit(EventArgs)

Aciona o evento Init.(Herdado de Control.)

System_CAPS_protmethodOnLoad(EventArgs)

Aciona o evento Load.(Herdado de Control.)

System_CAPS_protmethodOnPreRender(EventArgs)

Gera o PreRender evento.(Substitui o Control.OnPreRender(EventArgs).)

System_CAPS_protmethodOnUnload(EventArgs)

Aciona o evento Unload.(Herdado de Control.)

System_CAPS_protmethodOpenFile(String)

Obtém um Stream usado para ler um arquivo.(Herdado de Control.)

System_CAPS_protmethodRaiseBubbleEvent(Object, EventArgs)

Atribui quaisquer fontes de evento e suas informações para o pai do controle.(Herdado de Control.)

System_CAPS_protmethodRemovedControl(Control)

Chamado após a remoção de um controle filho a Controls coleção do Control objeto.(Herdado de Control.)

System_CAPS_protmethodRender(HtmlTextWriter)

Envia o conteúdo do controle de servidor a um fornecido HtmlTextWriter objeto, que grava o conteúdo a ser renderizado na Web(Substitui o Control.Render(HtmlTextWriter).)

System_CAPS_protmethodRenderChildren(HtmlTextWriter)

Gera o conteúdo de filhos de um controle de servidor a um objeto HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente.(Herdado de Control.)

System_CAPS_pubmethodRenderControl(HtmlTextWriter)

Gera o conteúdo do controle de servidor para um objeto HtmlTextWriter fornecido e armazena informações de rastreamento sobre o controle caso o rastreamento esteja habilitado.(Herdado de Control.)

System_CAPS_protmethodRenderControl(HtmlTextWriter, ControlAdapter)

Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido.(Herdado de Control.)

System_CAPS_protmethodResolveAdapter()

Obtém o adaptador de controle responsável por processar o controle especificado.(Herdado de Control.)

System_CAPS_pubmethodResolveClientUrl(String)

Obtém uma URL que pode ser usada pelo navegador.(Herdado de Control.)

System_CAPS_pubmethodResolveUrl(String)

Converte uma URL em uma que possa ser usada no cliente solicitante.(Herdado de Control.)

System_CAPS_protmethodSaveControlState()

Salva as alterações de estado do controle de servidor que ocorreram desde a hora em que ocorreu o postback da página no servidor.(Herdado de Control.)

System_CAPS_protmethodSaveViewState()

Salva quaisquer alterações no viewstate de um controle de servidor que ocorreram apos o último postback da página.(Herdado de Control.)

System_CAPS_protmethodSetDesignModeState(IDictionary)

Define os dados de tempo de design para um controle.(Herdado de Control.)

System_CAPS_pubmethodSetRenderMethodDelegate(RenderMethod)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Atribui um delegado do manipulador de eventos para renderizar o controle de servidor e seu conteúdo em seu controle pai.(Herdado de Control.)

System_CAPS_pubmethodSetTraceData(Object, Object)

Conjuntos de dados de rastreamento de dados de renderização, usando a chave de dados de rastreamento e o valor de dados de rastreamento de tempo de design de rastreamento.(Herdado de Control.)

System_CAPS_pubmethodSetTraceData(Object, Object, Object)

Conjuntos de dados de rastreamento de dados de renderização, usando o objeto rastreado, a chave de dados de rastreamento e o valor de dados de rastreamento de tempo de design de rastreamento.(Herdado de Control.)

System_CAPS_pubmethodToString()

Retorna uma string que representa o objeto atual.(Herdado de Object.)

System_CAPS_protmethodTrackViewState()

Causa o acompanhamento das alterações de estado de exibição para o controle de servidor, para que elas possam ser armazenadas no objeto StateBag do controle de servidor. Esse objeto é acessível por meio da propriedade Control.ViewState.(Herdado de Control.)

NomeDescrição
System_CAPS_pubeventDataBinding

Ocorre quando o server control vincula a uma fonte de dados.(Herdado de Control.)

System_CAPS_pubeventDisposed

Ocorre quando um server control é liberado da memória, que é a última etapa do ciclo de vida do server contorl quando uma página ASP.NET é solicitada.(Herdado de Control.)

System_CAPS_pubeventInit

Ocorre quando o server control é inicializado, que é o primeiro passo em seu ciclo de vida.(Herdado de Control.)

System_CAPS_pubeventLoad

Ocorre quando o controle de servidor é carregado no objeto Page.(Herdado de Control.)

System_CAPS_pubeventPreRender

Ocorre depois que o objeto Control é carregado, mas antes da renderização.(Herdado de Control.)

System_CAPS_pubeventUnload

Ocorre quando o server control é descarregado da memória.(Herdado de Control.)

NomeDescrição
System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.GetDesignModeState()

Para obter uma descrição desse membro, consulte IControlDesignerAccessor.GetDesignModeState.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetDesignModeState(IDictionary)

Para obter uma descrição desse membro, consulte IControlDesignerAccessor.SetDesignModeState.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetOwnerControl(Control)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Para obter uma descrição desse membro, consulte IControlDesignerAccessor.SetOwnerControl.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIParserAccessor.AddParsedSubObject(Object)

Para obter uma descrição desse membro, consulte IParserAccessor.AddParsedSubObject.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlBuilderAccessor.ControlBuilder

Para obter uma descrição desse membro, consulte IControlBuilderAccessor.ControlBuilder.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlDesignerAccessor.UserData

Para obter uma descrição desse membro, consulte IControlDesignerAccessor.UserData.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.DataBindings

Para obter uma descrição desse membro, consulte IDataBindingsAccessor.DataBindings.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.HasDataBindings

Para obter uma descrição desse membro, consulte IDataBindingsAccessor.HasDataBindings.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.Expressions

Para obter uma descrição desse membro, consulte IExpressionsAccessor.Expressions.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.HasExpressions

Para obter uma descrição desse membro, consulte IExpressionsAccessor.HasExpressions.(Herdado de Control.)

NomeDescrição
System_CAPS_pubmethodFindDataSourceControl()

Retorna a fonte de dados associada ao controle de dados do controle especificado.(Definido pelo DynamicDataExtensions.)

System_CAPS_pubmethodFindFieldTemplate(String)

Retorna que o modelo de campo para a coluna especificada no controle especificado do contêiner de nomeação.(Definido pelo DynamicDataExtensions.)

System_CAPS_pubmethodFindMetaTable()

Retorna o objeto metatable contendo o controle de dados.(Definido pelo DynamicDataExtensions.)

Use the T:System.Web.UI.WebControls.Substitution control to specify a section on an output-cached Web page where you want dynamic content substituted for the control. The T:System.Web.UI.WebControls.Substitution control offers a simplified solution to partial page caching for pages where the majority of the content is cached. You can output-cache the entire page, and then use T:System.Web.UI.WebControls.Substitution controls to specify the parts of the page that are exempt from caching. Cached regions execute only once and are replayed from the cache until the cache entry expires or is purged. Dynamic regions execute each time the page is requested. This caching model simplifies the code for pages that are primarily static, because you do not have to encapsulate the sections to cache in Web user controls. For example, this caching model is useful in a scenario where you have a page that contains static content, such as news stories, and an T:System.Web.UI.WebControls.AdRotator control that displays advertisements. The news stories do not change, which means that they can be cached. However, each time a user requests the page, you want to display a new advertisement. The T:System.Web.UI.WebControls.AdRotator control directly supports post-cache substitution and renders a new advertisement each time the page posts back, regardless of whether the page is cached.

System_CAPS_noteObservação

You can place a T:System.Web.UI.WebControls.Substitution control in a user control that is contained in a cached page. However, you cannot place a T:System.Web.UI.WebControls.Substitution control in an output-cached user control.

When the T:System.Web.UI.WebControls.Substitution control executes, it calls a method that returns a string. The string that the method returns is the content to display on the page at the location of the T:System.Web.UI.WebControls.Substitution control. Use the P:System.Web.UI.WebControls.Substitution.MethodName property to specify the name of the callback method to invoke when the T:System.Web.UI.WebControls.Substitution control executes. The callback method that you specify must be a static method on the page or user control that contains the T:System.Web.UI.WebControls.Substitution control. The signature for the callback method must match the signature for an T:System.Web.HttpResponseSubstitutionCallback delegate that takes an T:System.Web.HttpContext parameter and returns a string.

To manipulate the output cache for a page, you can use the @ OutputCache directive, the T:System.Web.HttpCachePolicy class, or the P:System.Web.HttpResponse.Cache property. For more information on caching pages, see Caching ASP.NET Pages and Caching Portions of an ASP.NET Page.

As an alternative to using the T:System.Web.UI.WebControls.Substitution control, you can also get substitution caching behavior using a T:System.Web.HttpResponseSubstitutionCallback delegate. In addition, you can get substitution caching behavior on controls, such as the T:System.Web.UI.WebControls.AdRotator control, that directly support this feature. For more information, see Dynamically Updating Portions of a Cached Page.

<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"
/>

The following code example demonstrates how to add a T:System.Web.UI.WebControls.Substitution control declaratively to an output-cached Web page. When the page loads, the current date and time are displayed to the user in a label. This section of the page is cached and updated only every 60 seconds. When the T:System.Web.UI.WebControls.Substitution control executes, it calls the GetCurrentDateTime method. The string returned by GetCurrentDateTime is displayed to the user. This section of the page is not cached and is updated each time the page is refreshed.

<%@ 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>

.NET Framework
Disponível desde 2.0

Quaisquer membros estáticos públicos ( Compartilhado no Visual Basic) desse tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Retornar ao início
Mostrar: