Substitution Classe

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Spécifie une section sur une page Web mise en cache de sortie qui est exemptée de la mise en cache. À cet emplacement, le contenu dynamique est récupéré et remplacé par le Substitution contrôle.

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

Héritage: Object

Control
Substitution

Exemples

L’exemple de code suivant montre comment ajouter un Substitution contrôle de manière déclarative à une page Web mise en cache de sortie. Lorsque la page se charge, la date et l’heure actuelles sont affichées à l’utilisateur dans une étiquette. Cette section de la page est mise en cache et mise à jour toutes les 60 secondes. Lorsque le Substitution contrôle s’exécute, il appelle la GetCurrentDateTime méthode. La chaîne retournée par GetCurrentDateTime est affichée à l’utilisateur. Cette section de la page n’est pas mise en cache et est mise à jour chaque fois que la page est actualisée.

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

Remarques

Dans cette rubrique :

Introduction
Syntaxe déclarative

Présentation

Utilisez le Substitution contrôle pour spécifier une section sur une page Web mise en cache de sortie dans laquelle vous souhaitez remplacer le contenu dynamique par le contrôle. Le Substitution contrôle offre une solution simplifiée à la mise en cache partielle des pages où la majorité du contenu est mise en cache. Vous pouvez mettre en cache la page entière, puis utiliser Substitution des contrôles pour spécifier les parties de la page qui sont exemptées de la mise en cache. Les régions mises en cache s’exécutent une seule fois et sont relues à partir du cache jusqu’à ce que l’entrée du cache expire ou soit vidée. Les régions dynamiques s’exécutent chaque fois que la page est demandée. Ce modèle de mise en cache simplifie le code des pages qui sont principalement statiques, car vous n’avez pas besoin d’encapsuler les sections à mettre en cache dans les contrôles utilisateur web. Par exemple, ce modèle de mise en cache est utile dans un scénario où vous avez une page qui contient du contenu statique, tel que des articles d’actualités et un AdRotator contrôle qui affiche des publicités. Les actualités ne changent pas, ce qui signifie qu’elles peuvent être mises en cache. Toutefois, chaque fois qu’un utilisateur demande la page, vous souhaitez afficher une nouvelle publicité. Le AdRotator contrôle prend directement en charge la substitution post-cache et restitue une nouvelle publication chaque fois que la page revient, que la page soit mise en cache ou non.

Note

Vous pouvez placer un Substitution contrôle dans un contrôle utilisateur contenu dans une page mise en cache. Toutefois, vous ne pouvez pas placer un Substitution contrôle dans un contrôle utilisateur mis en cache de sortie.

Lorsque le Substitution contrôle s’exécute, il appelle une méthode qui retourne une chaîne. La chaîne retournée par la méthode est le contenu à afficher sur la page à l’emplacement du Substitution contrôle. Utilisez la MethodName propriété pour spécifier le nom de la méthode de rappel à appeler lorsque le Substitution contrôle s’exécute. La méthode de rappel que vous spécifiez doit être une méthode statique sur la page ou le contrôle utilisateur qui contient le Substitution contrôle. La signature de la méthode de rappel doit correspondre à la signature d’un HttpResponseSubstitutionCallback délégué qui accepte un HttpContext paramètre et retourne une chaîne.

Pour manipuler le cache de sortie d’une page, vous pouvez utiliser la directive @ OutputCache , la HttpCachePolicy classe ou la Cache propriété. Pour plus d’informations sur la mise en cache des pages, consultez Mise en cache ASP.NET pages et parties de mise en cache d’une page ASP.NET.

En guise d’alternative à l’utilisation du Substitution contrôle, vous pouvez également obtenir le comportement de mise en cache de substitution à l’aide d’un HttpResponseSubstitutionCallback délégué. En outre, vous pouvez obtenir le comportement de mise en cache de substitution sur les contrôles, tels que le AdRotator contrôle, qui prennent directement en charge cette fonctionnalité. Pour plus d’informations, consultez Mise à jour dynamique des parties d’une page mise en cache.

Syntaxe déclarative

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

Constructeurs

Nom	Description
Substitution()	Initialise une nouvelle instance de la classe Substitution.

Propriétés

Nom	Description
Adapter	Obtient l’adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control)
AppRelativeTemplateSourceDirectory	Obtient ou définit le répertoire virtuel relatif à l’application du ou UserControl de l’objet Page qui contient ce contrôle. (Hérité de Control)
BindingContainer	Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control)
ChildControlsCreated	Obtient une valeur qui indique si les contrôles enfants du contrôle serveur ont été créés. (Hérité de Control)
ClientID	Obtient l’ID de contrôle pour le balisage HTML généré par ASP.NET. (Hérité de Control)
ClientIDMode	Obtient ou définit l’algorithme utilisé pour générer la valeur de la ClientID propriété. (Hérité de Control)
ClientIDSeparator	Obtient une valeur de caractère représentant le caractère séparateur utilisé dans la ClientID propriété. (Hérité de Control)
Context	Obtient l’objet HttpContext associé au contrôle serveur pour la requête Web actuelle. (Hérité de Control)
Controls	Obtient un ControlCollection objet qui représente les contrôles enfants d’un contrôle serveur spécifié dans la hiérarchie de l’interface utilisateur. (Hérité de Control)
DataItemContainer	Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataItemContainernoms implémente . (Hérité de Control)
DataKeysContainer	Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataKeysControlnoms implémente . (Hérité de Control)
DesignMode	Obtient une valeur indiquant si un contrôle est utilisé sur une surface de conception. (Hérité de Control)
EnableTheming	Obtient ou définit une valeur indiquant si les thèmes s’appliquent à ce contrôle. (Hérité de Control)
EnableViewState	Obtient ou définit une valeur indiquant si le contrôle serveur conserve son état d’affichage et l’état d’affichage des contrôles enfants qu’il contient, au client demandeur. (Hérité de Control)
Events	Obtient une liste de délégués de gestionnaire d’événements pour le contrôle. Cette propriété est en lecture seule. (Hérité de Control)
HasChildViewState	Obtient une valeur indiquant si les contrôles enfants du contrôle serveur actuel ont des paramètres d’état d’affichage enregistrés. (Hérité de Control)
ID	Obtient ou définit l’identificateur programmatique affecté au contrôle serveur. (Hérité de Control)
IdSeparator	Obtient le caractère utilisé pour séparer les identificateurs de contrôle. (Hérité de Control)
IsChildControlStateCleared	Obtient une valeur indiquant si les contrôles contenus dans ce contrôle ont un état de contrôle. (Hérité de Control)
IsTrackingViewState	Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d’affichage. (Hérité de Control)
IsViewStateEnabled	Obtient une valeur indiquant si l’état d’affichage est activé pour ce contrôle. (Hérité de Control)
LoadViewStateByID	Obtient une valeur indiquant si le contrôle participe au chargement de son état d’affichage ID au lieu de l’index. (Hérité de Control)
MethodName	Obtient ou définit le nom de la méthode de rappel à appeler lorsque le Substitution contrôle s’exécute.
NamingContainer	Obtient une référence au conteneur d’affectation de noms du contrôle serveur, qui crée un espace de noms unique pour la différenciation entre les contrôles serveur avec la même ID valeur de propriété. (Hérité de Control)
Page	Obtient une référence à l’instance Page qui contient le contrôle serveur. (Hérité de Control)
Parent	Obtient une référence au contrôle parent du contrôle serveur dans la hiérarchie des contrôles de page. (Hérité de Control)
RenderingCompatibility	Obtient une valeur qui spécifie la version ASP.NET avec laquelle le code HTML rendu est compatible. (Hérité de Control)
Site	Obtient des informations sur le conteneur qui héberge le contrôle actuel lors du rendu sur une surface de conception. (Hérité de Control)
SkinID	Obtient ou définit la peau à appliquer au contrôle. (Hérité de Control)
TemplateControl	Obtient ou définit une référence au modèle qui contient ce contrôle. (Hérité de Control)
TemplateSourceDirectory	Obtient le répertoire virtuel du Page UserControl ou qui contient le contrôle serveur actuel. (Hérité de Control)
UniqueID	Obtient l’identificateur unique qualifié hiérarchiquement pour le contrôle serveur. (Hérité de Control)
ValidateRequestMode	Obtient ou définit une valeur qui indique si le contrôle vérifie l’entrée du client à partir du navigateur pour obtenir des valeurs potentiellement dangereuses. (Hérité de Control)
ViewState	Obtient un dictionnaire d’informations d’état qui vous permet d’enregistrer et de restaurer l’état d’affichage d’un contrôle serveur sur plusieurs requêtes pour la même page. (Hérité de Control)
ViewStateIgnoresCase	Obtient une valeur qui indique si l’objet ne respecte pas la StateBag casse. (Hérité de Control)
ViewStateMode	Obtient ou définit le mode d’état d’affichage de ce contrôle. (Hérité de Control)
Visible	Obtient ou définit une valeur qui indique si un contrôle serveur est rendu en tant qu’interface utilisateur sur la page. (Hérité de Control)

Méthodes

Nom	Description
AddedControl(Control, Int32)	Appelé après l’ajout d’un contrôle enfant à la Controls collection de l’objet Control . (Hérité de Control)
AddParsedSubObject(Object)	Avertit le contrôle serveur qu’un élément, XML ou HTML, a été analysé et ajoute l’élément à l’objet du ControlCollection contrôle serveur. (Hérité de Control)
ApplyStyleSheetSkin(Page)	Applique les propriétés de style définies dans la feuille de style de page au contrôle. (Hérité de Control)
BeginRenderTracing(TextWriter, Object)	Commence le suivi au moment du design des données de rendu. (Hérité de Control)
BuildProfileTree(String, Boolean)	Collecte des informations sur le contrôle serveur et le remet à la Trace propriété à afficher lorsque le suivi est activé pour la page. (Hérité de Control)
ClearCachedClientID()	Définit la valeur mise en ClientID cache sur `null`. (Hérité de Control)
ClearChildControlState()	Supprime les informations d’état du contrôle pour les contrôles enfants du contrôle serveur. (Hérité de Control)
ClearChildState()	Supprime les informations d’état d’affichage et d’état de contrôle pour tous les contrôles enfants du contrôle serveur. (Hérité de Control)
ClearChildViewState()	Supprime les informations d’état d’affichage de tous les contrôles enfants du contrôle serveur. (Hérité de Control)
ClearEffectiveClientIDMode()	Définit la ClientIDMode propriété de l’instance de contrôle actuelle et de tous les contrôles enfants sur Inherit. (Hérité de Control)
CreateChildControls()	Appelé par l’infrastructure de page ASP.NET pour notifier les contrôles serveur qui utilisent l’implémentation basée sur la composition pour créer les contrôles enfants qu’ils contiennent en préparation de la publication ou du rendu. (Hérité de Control)
CreateControlCollection()	Retourne un EmptyControlCollection objet, indiquant que le Substitution contrôle ne prend pas en charge les contrôles enfants.
DataBind()	Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants. (Hérité de Control)
DataBind(Boolean)	Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants avec une option pour déclencher l’événement DataBinding . (Hérité de Control)
DataBindChildren()	Lie une source de données aux contrôles enfants du contrôle serveur. (Hérité de Control)
Dispose()	Permet à un contrôle de serveur d’effectuer le nettoyage final avant de libérer de la mémoire. (Hérité de Control)
EndRenderTracing(TextWriter, Object)	Met fin au suivi au moment du design des données de rendu. (Hérité de Control)
EnsureChildControls()	Détermine si le contrôle serveur contient des contrôles enfants. Si ce n’est pas le cas, il crée des contrôles enfants. (Hérité de Control)
EnsureID()	Crée un identificateur pour les contrôles qui n’ont pas d’identificateur affecté. (Hérité de Control)
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
FindControl(String, Int32)	Recherche dans le conteneur d’affectation de noms actuel un contrôle serveur avec l’entier spécifié `id` et spécifié dans le `pathOffset` paramètre, ce qui facilite la recherche. Vous ne devez pas remplacer cette version de la FindControl méthode. (Hérité de Control)
FindControl(String)	Recherche le conteneur d’affectation de noms actuel pour un contrôle serveur avec le paramètre spécifié `id` . (Hérité de Control)
Focus()	Définit le focus d’entrée sur un contrôle. (Hérité de Control)
GetDesignModeState()	Obtient les données au moment du design pour un contrôle. (Hérité de Control)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetRouteUrl(Object)	Obtient l’URL qui correspond à un ensemble de paramètres de routage. (Hérité de Control)
GetRouteUrl(RouteValueDictionary)	Obtient l’URL qui correspond à un ensemble de paramètres de routage. (Hérité de Control)
GetRouteUrl(String, Object)	Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire et à un nom d’itinéraire. (Hérité de Control)
GetRouteUrl(String, RouteValueDictionary)	Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire et à un nom d’itinéraire. (Hérité de Control)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
GetUniqueIDRelativeTo(Control)	Retourne la partie préfixée de la UniqueID propriété du contrôle spécifié. (Hérité de Control)
HasControls()	Détermine si le contrôle serveur contient des contrôles enfants. (Hérité de Control)
HasEvents()	Retourne une valeur indiquant si les événements sont inscrits pour le contrôle ou les contrôles enfants. (Hérité de Control)
IsLiteralContent()	Détermine si le contrôle serveur contient uniquement du contenu littéral. (Hérité de Control)
LoadControlState(Object)	Restaure les informations d’état du contrôle à partir d’une demande de page précédente qui a été enregistrée par la SaveControlState() méthode. (Hérité de Control)
LoadViewState(Object)	Restaure les informations d’état d’affichage à partir d’une demande de page précédente enregistrée par la SaveViewState() méthode. (Hérité de Control)
MapPathSecure(String)	Récupère le chemin d’accès physique auquel un chemin virtuel, absolu ou relatif, est mappé. (Hérité de Control)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnBubbleEvent(Object, EventArgs)	Détermine si l’événement pour le contrôle serveur est transmis à la hiérarchie de contrôle du serveur d’interface utilisateur de la page. (Hérité de Control)
OnDataBinding(EventArgs)	Déclenche l’événement DataBinding. (Hérité de Control)
OnInit(EventArgs)	Déclenche l’événement Init. (Hérité de Control)
OnLoad(EventArgs)	Déclenche l’événement Load. (Hérité de Control)
OnPreRender(EventArgs)	Déclenche l’événement PreRender.
OnUnload(EventArgs)	Déclenche l’événement Unload. (Hérité de Control)
OpenFile(String)	Obtient un Stream élément utilisé pour lire un fichier. (Hérité de Control)
RaiseBubbleEvent(Object, EventArgs)	Affecte toutes les sources de l’événement et ses informations au parent du contrôle. (Hérité de Control)
RemovedControl(Control)	Appelé après la suppression d’un contrôle enfant de la Controls collection de l’objet Control . (Hérité de Control)
Render(HtmlTextWriter)	Envoie le contenu du contrôle serveur à un objet fourni HtmlTextWriter , qui écrit le contenu à afficher sur le client.
RenderChildren(HtmlTextWriter)	Génère le contenu des enfants d’un contrôle serveur dans un objet fourni HtmlTextWriter , qui écrit le contenu à restituer sur le client. (Hérité de Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Génère le contenu du contrôle serveur sur un objet fourni HtmlTextWriter à l’aide d’un objet fourni ControlAdapter . (Hérité de Control)
RenderControl(HtmlTextWriter)	Génère le contenu du contrôle serveur dans un objet fourni HtmlTextWriter et stocke les informations de suivi sur le contrôle si le suivi est activé. (Hérité de Control)
ResolveAdapter()	Obtient l’adaptateur de contrôle responsable du rendu du contrôle spécifié. (Hérité de Control)
ResolveClientUrl(String)	Obtient une URL qui peut être utilisée par le navigateur. (Hérité de Control)
ResolveUrl(String)	Convertit une URL en une URL utilisable sur le client demandeur. (Hérité de Control)
SaveControlState()	Enregistre les modifications d’état de contrôle du serveur qui se sont produites depuis la publication de la page sur le serveur. (Hérité de Control)
SaveViewState()	Enregistre les modifications de l’état d’affichage du contrôle de serveur qui se sont produites depuis la publication de la page sur le serveur. (Hérité de Control)
SetDesignModeState(IDictionary)	Définit les données au moment du design pour un contrôle. (Hérité de Control)
SetRenderMethodDelegate(RenderMethod)	Affecte un délégué de gestionnaire d’événements pour restituer le contrôle serveur et son contenu dans son contrôle parent. (Hérité de Control)
SetTraceData(Object, Object, Object)	Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de l’objet suivi, de la clé de données de trace et de la valeur des données de trace. (Hérité de Control)
SetTraceData(Object, Object)	Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de la clé de données de trace et de la valeur des données de trace. (Hérité de Control)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)
TrackViewState()	Provoque le suivi des modifications d’état d’affichage apportées au contrôle serveur afin qu’ils puissent être stockés dans l’objet du StateBag contrôle serveur. Cet objet est accessible via la ViewState propriété. (Hérité de Control)

Événements

Nom	Description
DataBinding	Se produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control)
Disposed	Se produit lorsqu’un contrôle serveur est libéré de la mémoire, qui est la dernière étape du cycle de vie du contrôle de serveur lorsqu’une page ASP.NET est demandée. (Hérité de Control)
Init	Se produit lorsque le contrôle serveur est initialisé, qui est la première étape de son cycle de vie. (Hérité de Control)
Load	Se produit lorsque le contrôle serveur est chargé dans l’objet Page . (Hérité de Control)
PreRender	Se produit après le chargement de l’objet Control , mais avant le rendu. (Hérité de Control)
Unload	Se produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control)

Implémentations d’interfaces explicites

Nom	Description
IControlBuilderAccessor.ControlBuilder	Pour obtenir une description de ce membre, consultez ControlBuilder. (Hérité de Control)
IControlDesignerAccessor.GetDesignModeState()	Pour obtenir une description de ce membre, consultez GetDesignModeState(). (Hérité de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Pour obtenir une description de ce membre, consultez SetDesignModeState(IDictionary). (Hérité de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Pour obtenir une description de ce membre, consultez SetOwnerControl(Control). (Hérité de Control)
IControlDesignerAccessor.UserData	Pour obtenir une description de ce membre, consultez UserData. (Hérité de Control)
IDataBindingsAccessor.DataBindings	Pour obtenir une description de ce membre, consultez DataBindings. (Hérité de Control)
IDataBindingsAccessor.HasDataBindings	Pour obtenir une description de ce membre, consultez HasDataBindings. (Hérité de Control)
IExpressionsAccessor.Expressions	Pour obtenir une description de ce membre, consultez Expressions. (Hérité de Control)
IExpressionsAccessor.HasExpressions	Pour obtenir une description de ce membre, consultez HasExpressions. (Hérité de Control)
IParserAccessor.AddParsedSubObject(Object)	Pour obtenir une description de ce membre, consultez AddParsedSubObject(Object). (Hérité de Control)

Méthodes d’extension

Nom	Description
FindDataSourceControl(Control)	Retourne la source de données associée au contrôle de données pour le contrôle spécifié.
FindFieldTemplate(Control, String)	Retourne le modèle de champ de la colonne spécifiée dans le conteneur d’affectation de noms du contrôle spécifié.
FindMetaTable(Control)	Retourne l’objet métatable pour le contrôle de données contenant.

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?