Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase PartialCachingAttribute

 

Publicado: octubre de 2016

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

Espacio de nombres:   System.Web.UI
Ensamblado:  System.Web (en System.Web.dll)

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

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

NombreDescripción
System_CAPS_pubmethodPartialCachingAttribute(Int32)

Inicializa una nueva instancia de la PartialCachingAttribute clase con la duración especificada asignada al control de usuario en la caché.

System_CAPS_pubmethodPartialCachingAttribute(Int32, String, String, String)

Inicializa una nueva instancia de la PartialCachingAttribute clase, especificando la duración del almacenamiento en caché, cualquier GET y POST valores, nombres de control y caché de resultados personalizado utilizados para variar la memoria caché de requisitos.

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

Inicializa una nueva instancia de la PartialCachingAttribute (clase), especificando la duración del almacenamiento en caché, cualquier GET y POST valores, nombres de control, personalizado requisitos de almacenamiento en caché utilizados para variar la caché de resultados, y si el control de usuario de salida puede compartirse con varias páginas.

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

Inicializa una nueva instancia de la PartialCachingAttribute (clase), especificando la duración del almacenamiento en caché, cualquier GET y POST nombres de control, personalizado resultados requisitos de caché utilizados para variar la caché, las dependencias de la base de datos, y si el control de usuario de salida puede compartirse con varias páginas.

NombreDescripción
System_CAPS_pubpropertyDuration

Obtiene la cantidad de tiempo, en segundos, que deben permanecer elementos almacenados en caché en la caché de resultados.

System_CAPS_pubpropertyProviderName

Obtiene o establece el nombre del proveedor que se utiliza para almacenar los datos de la caché de resultados para el control asociado.

System_CAPS_pubpropertyShared

Obtiene un valor que indica si el resultado del control de usuario puede compartirse con varias páginas.

System_CAPS_pubpropertySqlDependency

Obtiene una cadena delimitada que identifica una o varias bases de datos y tabla de pares de nombre que depende el control de usuario almacenado en caché.

System_CAPS_pubpropertyTypeId

Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute.(Heredado de Attribute).

System_CAPS_pubpropertyVaryByControls

Obtiene una lista de propiedades del control de usuario que utiliza la caché de resultados para modificar el control de usuario.

System_CAPS_pubpropertyVaryByCustom

Obtiene una lista de cadenas personalizadas que utilizará la caché de resultados para modificar el control de usuario.

System_CAPS_pubpropertyVaryByParams

Obtiene una lista de cadenas de consulta o formulario POST parámetros que utilizará la caché de resultados para modificar el control de usuario.

NombreDescripción
System_CAPS_pubmethodEquals(Object)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Devuelve un valor que indica si esta instancia equivale al objeto especificado. (Heredado de Attribute).

System_CAPS_pubmethodGetHashCode()

Devuelve el código hash de esta instancia.(Heredado de Attribute).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodIsDefaultAttribute()

Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada.(Heredado de Attribute).

System_CAPS_pubmethodMatch(Object)

Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual al objeto especificado. (Heredado de Attribute).

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío.(Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Obtiene la información del tipo de un objeto, que puede utilizarse para obtener la información del tipo de una interfaz. (Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfoCount(UInt32)

Recupera el número de interfaces de tipo de información que suministra un objeto (0 ó 1)

(Heredado de Attribute).

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

Proporciona acceso a las propiedades y los métodos expuestos por un objeto.(Heredado de Attribute).

La PartialCachingAttribute clase atributo marca los controles de usuario (archivos .ascx) que admiten el almacenamiento en caché de fragmentos y encapsula la configuración de caché que ASP.NET utiliza al almacenar en caché el control. Los desarrolladores de páginas y controles utilizan el PartialCachingAttribute atributo para habilitar el almacenamiento en caché para un control de usuario en un archivo de código subyacente de la salida.

Mediante el PartialCachingAttribute se salida de varias maneras, puede habilitar el almacenamiento en caché. La lista siguiente describe los métodos que puede utilizar para habilitar el almacenamiento en caché de salida.

  • Utilice la directiva para habilitar la caché de resultados en escenarios declarativos.

  • Utilice la PartialCachingAttribute para habilitar el almacenamiento en caché para un control de usuario en un archivo de código subyacente.

  • Utilice la ControlCachePolicy clase para especificar mediante programación la configuración de la caché en escenarios de programación en el que está trabajando con BasePartialCachingControl instancias.

Si un control de usuario contiene una directiva o tiene un PartialCachingAttribute aplicado, el analizador ASP.NET genera una instancia de la PartialCachingControl clase para encapsular el control de usuario.

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

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

  • Una clase parcial, ctlMine, que hereda de la UserControl clase base y a la que el PartialCachingAttribute se aplica el atributo.

  • Un control de usuario que se usa con la ctlMine clase parcial.

  • Una 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 el PartialCachingAttribute se aplica el 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");

        }
    }
}

La segunda parte del ejemplo muestra un control de usuario que se utiliza con el ejemplo anterior para mostrar el almacenamiento en caché de 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" />

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>

.NET Framework
Disponible desde 1.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: