Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

PartialCachingAttribute classe

 

Date de publication : novembre 2016

Définit l’attribut de métadonnées que les contrôles utilisateur Web Forms (fichiers .ascx) permet d’indiquer si et comment leur sortie est mise en cache. Cette classe ne peut pas être héritée.

Espace de noms:   System.Web.UI
Assembly:  System.Web (dans System.Web.dll)

System.Object
  System.Attribute
    System.Web.UI.PartialCachingAttribute

[AttributeUsageAttribute(AttributeTargets.Class)]
public sealed class PartialCachingAttribute : Attribute

NomDescription
System_CAPS_pubmethodPartialCachingAttribute(Int32)

Initialise une nouvelle instance de la PartialCachingAttribute classe avec la durée spécifiée assignée au contrôle utilisateur à mettre en cache.

System_CAPS_pubmethodPartialCachingAttribute(Int32, String, String, String)

Initialise une nouvelle instance de la PartialCachingAttribute classe, en spécifiant la durée de mise en cache, n’importe quel GET et POST valeurs, des noms de contrôle et les spécifications utilisées pour faire varier le cache de la mise en cache de sortie personnalisée.

System_CAPS_pubmethodPartialCachingAttribute(Int32, String, String, String, Boolean)

Initialise une nouvelle instance de la PartialCachingAttribute classe, spécifiant la durée de mise en cache, toutes GET et POST valeurs, exigences de mise en cache utilisés pour faire varier le cache de sortie personnalisée, noms de contrôle et de sortie indique si le contrôle utilisateur peut être partagée avec plusieurs pages.

System_CAPS_pubmethodPartialCachingAttribute(Int32, String, String, String, String, Boolean)

Initialise une nouvelle instance de la PartialCachingAttribute classe, spécifiant la durée de mise en cache, toutes GET et POST valeurs, noms de contrôle personnalisé de sortie mise en cache des conditions utilisées pour faire varier le cache, les dépendances de la base de données, et indique si le contrôle utilisateur de sortie peut être partagée avec plusieurs pages.

NomDescription
System_CAPS_pubpropertyDuration

Obtient la quantité de temps, en secondes, que les éléments mis en cache doivent rester dans le cache de sortie.

System_CAPS_pubpropertyProviderName

Obtient ou définit le nom du fournisseur qui est utilisé pour stocker les données de mise en cache de sortie pour le contrôle associé.

System_CAPS_pubpropertyShared

Obtient une valeur indiquant si la sortie du contrôle utilisateur peut être partagée avec plusieurs pages.

System_CAPS_pubpropertySqlDependency

Obtient une chaîne délimitée qui identifie une ou plusieurs base de données et la table nom paires dont dépend le contrôle utilisateur mis en cache.

System_CAPS_pubpropertyTypeId

Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute.(Hérité de Attribute.)

System_CAPS_pubpropertyVaryByControls

Obtient une liste de propriétés du contrôle utilisateur que le cache de sortie utilise pour faire varier le contrôle utilisateur.

System_CAPS_pubpropertyVaryByCustom

Obtient une liste des chaînes personnalisées que le cache de sortie utilisera pour faire varier le contrôle utilisateur.

System_CAPS_pubpropertyVaryByParams

Obtient une liste de chaîne de requête ou un formulaire POST paramètres du cache de sortie utilisera pour faire varier le contrôle utilisateur.

NomDescription
System_CAPS_pubmethodEquals(Object)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Retourne une valeur qui indique si cette instance est égale à un objet spécifié.(Hérité de Attribute.)

System_CAPS_pubmethodGetHashCode()

Retourne le code de hachage de cette instance.(Hérité de Attribute.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodIsDefaultAttribute()

En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut pour la classe dérivée.(Hérité de Attribute.)

System_CAPS_pubmethodMatch(Object)

En cas de substitution dans une classe dérivée, retourne une valeur qui indique si cette instance équivaut à un objet spécifié.(Hérité de Attribute.)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

NomDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch.(Hérité de Attribute.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Récupère les informations de type pour un objet, qui peuvent être utilisées pour obtenir les informations de type d'une interface.(Hérité de Attribute.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfoCount(UInt32)

Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1).(Hérité de Attribute.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fournit l'accès aux propriétés et aux méthodes exposées par un objet.(Hérité de Attribute.)

La PartialCachingAttribute classe d’attributs de marque des contrôles utilisateur (fichiers .ascx) qui prennent en charge la mise en cache de fragment et encapsule les paramètres de cache qu’ASP.NET utilise lors de la mise en cache du contrôle. Utilisent des développeurs de pages et contrôles du PartialCachingAttribute sortie d’attribut pour activer la mise en cache pour un contrôle utilisateur dans un fichier code-behind.

À l’aide de la PartialCachingAttribute de plusieurs façons, vous pouvez activer la sortie mise en cache. La liste suivante décrit les méthodes que vous pouvez utiliser pour activer la mise en cache de sortie.

  • Utilisez la directive pour activer la mise en cache de sortie dans les scénarios déclaratifs.

  • Utilisez le PartialCachingAttribute pour activer la mise en cache pour un contrôle utilisateur dans un fichier code-behind.

  • Utilisez la ControlCachePolicy classe pour spécifier des paramètres de cache dans les scénarios de programmation dans lequel vous travaillez avec BasePartialCachingControl instances.

Si un contrôle utilisateur contient une directive ou une PartialCachingAttribute appliqué, l’analyseur ASP.NET génère une instance de la PartialCachingControl classe pour encapsuler le contrôle utilisateur.

Pour plus d’informations sur la mise en cache ASP.NET, consultez la page ASP.NET Caching. Pour plus d'informations sur l'utilisation d'attributs, consultez Extension des métadonnées à l'aide des attributs.

L’exemple de code suivant montre comment utiliser le PartialCachingAttribute. Cet exemple comprend trois parties :

  • Une classe partielle, ctlMine, qui hérite de la UserControl classe de base et à laquelle le PartialCachingAttribute attribut est appliqué.

  • Un contrôle utilisateur qui est utilisé avec la ctlMine classe partielle.

  • Une page Web Forms qui héberge le contrôle utilisateur.

La première partie de l’exemple montre une classe partielle qui hérite de la UserControl classe de base et à laquelle le PartialCachingAttribute attribut est appliqué. Dans cet exemple, l’attribut spécifie que le contrôle utilisateur doit être mis en cache pendant 20 secondes.

// [filename partialcache.cs]
// Create a code-behind user control that is cached
// for 20 seconds using the PartialCachingAttribute class.
// This control uses a DataGrid server control to display
// XML data.
using System;
using System.IO;
using System.Data;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

namespace Samples.AspNet.CS.Controls
{

    // Set the PartialCachingAttribute.Duration property to 20 seconds.
    [PartialCaching(20)]
    public partial class ctlMine : UserControl
    {

        protected void Page_Load(Object Src, EventArgs E)
        {
            DataSet ds = new DataSet();

            FileStream fs = new FileStream(Server.MapPath("schemadata.xml"), FileMode.Open, FileAccess.Read);
            StreamReader reader = new StreamReader(fs);
            ds.ReadXml(reader);
            fs.Close();

            DataView Source = new DataView(ds.Tables[0]);
            // Use the LiteralControl constructor to create a new
            // instance of the class.
            LiteralControl myLiteral = new LiteralControl();
            // Set the LiteralControl.Text property to an HTML
            // string and the TableName value of a data source.
            myLiteral.Text = "<h6><font face=verdana>Caching an XML Table: " + Source.Table.TableName + " </font></h6>";
            MyDataGrid.DataSource = Source;
            MyDataGrid.DataBind();

            TimeMsg.Text = DateTime.Now.ToString("G");

        }
    }
}

La deuxième partie de l’exemple montre un contrôle utilisateur qui est utilisé avec l’exemple précédent pour illustrer la mise en cache de contrôle utilisateur.

<!-- The mark-up .ascx file that displays the output of
     the partialcache.cs user control code-behind file. -->
<%@ Control language="C#" inherits="Samples.AspNet.CS.Controls.ctlMine" CodeFile="partialcache.cs.ascx.cs" %>

  <ASP:DataGrid id="MyDataGrid" runat="server"
    Width="900"
    BackColor="#ccccff"
    BorderColor="black"
    ShowFooter="false"
    CellPadding="3"
    CellSpacing="0"
    Font-Names="Verdana"
    Font-Size="8pt"
    HeaderStyle-BackColor="#aaaadd"
    EnableViewState="false"
  />

  <br />

  <i>Control last generated on:</i> <asp:label id="TimeMsg" runat="server" />

La troisième partie de l’exemple montre une page Web Forms qui héberge le contrôle utilisateur.

<!-- The WebForms page that contains the user control generated
     by partialcache.cs. -->
<%@ Register TagPrefix="Acme" TagName="Cache" Src="partialcache.cs.ascx" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<script language="C#" runat="server">

      void Page_Load(Object Src, EventArgs E ) {

          TimeMsg.Text = DateTime.Now.ToString("G");
      }

  </script>

<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>

  <form id="form1" runat="server">
    <Acme:Cache runat="server"/>
    <br />

    <i>Page last generated on:</i> <asp:label id="TimeMsg" runat="server" />

  </form>
</body>
</html>

.NET Framework
Disponible depuis 1.1

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: