PartialCachingAttribute Clase

Definición

Espacio de nombres:: System.Web.UI

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Define el atributo de metadatos que los controles de usuario de Formularios Web Forms (archivos .ascx) usan para indicar si y cómo se almacena en caché su salida. Esta clase no puede heredarse.

public ref class PartialCachingAttribute sealed : Attribute

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

[<System.AttributeUsage(System.AttributeTargets.Class)>]
type PartialCachingAttribute = class
    inherit Attribute

Public NotInheritable Class PartialCachingAttribute
Inherits Attribute

Herencia: Object

Attribute
PartialCachingAttribute

Atributos: AttributeUsageAttribute

Ejemplos

En el ejemplo de código siguiente se muestra el uso de PartialCachingAttribute. Este ejemplo tiene tres partes:

Clase parcial, ctlMine, que hereda de la UserControl clase base y a la que se aplica el PartialCachingAttribute atributo.
Control de usuario que se usa con la ctlMine clase parcial.
Página de formularios Web Forms que hospeda el control de usuario.

La primera parte del ejemplo muestra una clase parcial que hereda de la UserControl clase base y a la que se aplica el PartialCachingAttribute atributo . En este ejemplo, el atributo especifica que el control de usuario debe almacenarse en caché durante 20 segundos.

// [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");
        }
    }
}

' Filename is partialcache.vb
' 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.
Imports System.IO
Imports System.Data
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls

Namespace Samples.AspNet.VB.Controls

    ' Set the PartialCachingAttribute.Duration property to 20 seconds.
    <PartialCaching(20)> _
    Partial Class ctlMine
        Inherits UserControl

        Protected Sub Page_Load(ByVal Src As [Object], ByVal E As EventArgs)
            Dim ds As New DataSet()

            Dim fs As New FileStream(Server.MapPath("schemadata.xml"), FileMode.Open, FileAccess.Read)
            Dim reader As New StreamReader(fs)
            ds.ReadXml(reader)
            fs.Close()

            Dim [Source] As New DataView(ds.Tables(0))
            ' Use the LiteralControl constructor to create a new
            ' instance of the class.
            Dim myLiteral As 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")
        End Sub
    End Class
End Namespace

La segunda parte del ejemplo muestra un control de usuario que se usa con el ejemplo anterior para demostrar el almacenamiento en caché del control de usuario.

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

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

  <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 tercera parte del ejemplo muestra una página de Formularios Web Forms que hospeda el control de usuario.

<!-- 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>

<!-- The WebForms page that contains the user control generated
     by partialcache.vb. -->
<%@ Register TagPrefix="Acme" TagName="Cache" Src="partialcache.vb.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="vb" runat="server">

   Sub Page_Load(Src As [Object], E As EventArgs) 
      TimeMsg.Text = DateTime.Now.ToString("G")
   End Sub 'Page_Load

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

Comentarios

La clase de atributo /> PartialCachingAttribute almacenamiento en caché de salida para un control de usuario en un archivo de código subyacente.

El uso de es una de las varias maneras de habilitar el PartialCachingAttribute almacenamiento en caché de salida. En la lista siguiente se describen los métodos que puede usar para habilitar el almacenamiento en caché de salida.

Use la directiva para habilitar el @ OutputCache almacenamiento en caché de salida en escenarios declarativos.
Use para habilitar el PartialCachingAttribute almacenamiento en caché para un control de usuario en un archivo de código subyacente.
Use la ControlCachePolicy clase para especificar mediante programación la configuración de caché en escenarios mediante programación en los que se trabaja con BasePartialCachingControl instancias.

Si un control de usuario contiene una directiva /> , el analizador de ASP.NET genera una instancia de la clase para encapsular el control de usuario.

Para obtener más información sobre el almacenamiento en caché de ASP.NET, consulte Caching. Para obtener más información sobre el uso de atributos, vea Atributos.

Constructores

Nombre	Description
PartialCachingAttribute(Int32, String, String, String, Boolean)	Inicializa una nueva instancia de la PartialCachingAttribute clase , especificando la duración del almacenamiento en caché, los valores y `POST` los `GET` nombres de control, los requisitos de almacenamiento en caché de salida personalizados usados para variar la memoria caché y si la salida del control de usuario se puede compartir con varias páginas.
PartialCachingAttribute(Int32, String, String, String, String, Boolean)	Inicializa una nueva instancia de la PartialCachingAttribute clase , especificando la duración del almacenamiento en caché, los valores y `POST` los `GET` nombres de control, los requisitos de almacenamiento en caché de salida personalizados usados para variar la memoria caché, las dependencias de la base de datos y si la salida del control de usuario se puede compartir con varias páginas.
PartialCachingAttribute(Int32, String, String, String)	Inicializa una nueva instancia de la PartialCachingAttribute clase , especificando la duración del almacenamiento en caché, los valores GET y POST, los nombres de control y los requisitos de almacenamiento en caché de salida personalizados que se usan para variar la memoria caché.
PartialCachingAttribute(Int32)	Inicializa una nueva instancia de la PartialCachingAttribute clase con la duración especificada asignada al control de usuario que se va a almacenar en caché.

Propiedades

Nombre	Description
Duration	Obtiene la cantidad de tiempo, en segundos, que los elementos almacenados en caché deben permanecer en la memoria caché de salida.
ProviderName	Obtiene o establece el nombre del proveedor que se usa para almacenar los datos almacenados en caché de salida para el control asociado.
Shared	Obtiene un valor que indica si la salida del control de usuario se puede compartir con varias páginas.
SqlDependency	Obtiene una cadena delimitada que identifica uno o varios pares de nombre de base de datos y tabla de los que depende el control de usuario almacenado en caché.
TypeId	Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute. (Heredado de Attribute)
VaryByControls	Obtiene una lista de propiedades de control de usuario que usa la memoria caché de salida para variar el control de usuario.
VaryByCustom	Obtiene una lista de cadenas personalizadas que usará la caché de salida para variar el control de usuario.
VaryByParams	Obtiene una lista de parámetros de cadena de consulta o formulario `POST` que usará la caché de salida para variar el control de usuario.

Métodos

Nombre	Description
Equals(Object)	Devuelve un valor que indica si esta instancia es igual a un objeto especificado. (Heredado de Attribute)
GetHashCode()	Devuelve el código hash de esta instancia. (Heredado de Attribute)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IsDefaultAttribute()	Cuando se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada. (Heredado de Attribute)
Match(Object)	Cuando se reemplaza en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado. (Heredado de Attribute)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

Nombre	Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío. (Heredado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Recupera la información de tipo de un objeto, que se puede usar para obtener la información de tipo de una interfaz. (Heredado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1). (Heredado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Proporciona acceso a propiedades y métodos expuestos por un objeto . (Heredado de Attribute)

Se aplica a

Consulte también

Comentaris

Us ha resultat útil aquesta pàgina?