Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original
Este tema aún no ha recibido ninguna valoración - Valorar este tema

PartialCachingAttribute (Clase)

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

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

Espacio de nombres:  System.Web.UI
Ensamblado:  System.Web (en System.Web.dll)
[AttributeUsageAttribute(AttributeTargets.Class)]
public sealed class PartialCachingAttribute : Attribute

El tipo PartialCachingAttribute expone los siguientes miembros.

  NombreDescripción
Método públicoPartialCachingAttribute(Int32)Inicializa una nueva instancia de la clase PartialCachingAttribute con la duración especificada asignada al control de usuario que se va a almacenar en caché.
Método públicoPartialCachingAttribute(Int32, String, String, String)Inicializa una nueva instancia de la clase PartialCachingAttribute, especificando la duración del almacenamiento en memoria caché, cualquier valor GET y POST, nombres de control y requisitos personalizados de almacenamiento en la caché de resultados utilizados para modificar la memoria caché.
Método públicoPartialCachingAttribute(Int32, String, String, String, Boolean)Inicializa una nueva instancia de la clase PartialCachingAttribute, especificando la duración del almacenamiento en caché, cualquier valor GET y POST, nombres de control, requisitos de almacenamiento en la caché de resultados personalizados utilizados para variar la caché, y si el resultado del control de usuario puede compartirse con varias páginas o no.
Método públicoPartialCachingAttribute(Int32, String, String, String, String, Boolean)Inicializa una nueva instancia de la clase PartialCachingAttribute, especificando la duración del almacenamiento en caché, cualquier valor GET y POST, nombres de control, requisitos de almacenamiento en la caché de resultados personalizados utilizados para variar la caché, las dependencias de la base de datos y si el resultado del control de usuario puede compartirse con varias páginas o no.
Arriba
  NombreDescripción
Propiedad públicaDurationObtiene el periodo de tiempo, en segundos, que deben permanecer en la caché de resultados los elementos almacenados en memoria caché.
Propiedad públicaProviderNameObtiene o establece el nombre del proveedor que se utiliza para almacenar los datos en la caché de resultados para el control asociado.
Propiedad públicaSharedObtiene un valor que indica si varias páginas pueden compartir el resultado de un control de usuario.
Propiedad públicaSqlDependencyObtiene una cadena delimitada que identifica una o más bases de datos y pares de nombres de tabla de los que depende el control de usuario almacenado en memoria caché.
Propiedad públicaTypeIdCuando se implementa en una clase derivada, obtiene un identificador único para este Attribute. (Se hereda de Attribute).
Propiedad públicaVaryByControlsObtiene una lista de propiedades de control de usuario que utiliza la caché de resultados para modificar el control de usuario.
Propiedad públicaVaryByCustomObtiene una lista de cadenas personalizadas que utilizará la caché de resultados para modificar el control de usuario.
Propiedad públicaVaryByParamsObtiene una lista de los parámetros de cadena de consulta o de formulario POST que utilizará la caché de resultados para modificar el control de usuario.
Arriba
  NombreDescripción
Método públicoEqualsInfraestructura. Devuelve un valor que indica si esta instancia equivale a un objeto especificado. (Se hereda de Attribute).
Método públicoGetHashCodeDevuelve el código hash de esta instancia. (Se hereda de Attribute).
Método públicoGetTypeObtiene el objeto Type de la instancia actual. (Se hereda de Object).
Método públicoIsDefaultAttributeCuando se invalida en una clase derivada, indica si el valor de esta instancia es el valor predeterminado para la clase derivada. (Se hereda de Attribute).
Método públicoMatchCuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado. (Se hereda de Attribute).
Método públicoToStringDevuelve una cadena que representa el objeto actual. (Se hereda de Object).
Arriba
  NombreDescripción
Implementación explícita de interfacesMétodo privado_Attribute.GetIDsOfNamesAsigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío. (Se hereda de Attribute).
Implementación explícita de interfacesMétodo privado_Attribute.GetTypeInfoObtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz. (Se hereda de Attribute).
Implementación explícita de interfacesMétodo privado_Attribute.GetTypeInfoCount

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

(Se hereda de Attribute).
Implementación explícita de interfacesMétodo privado_Attribute.InvokeProporciona acceso a las propiedades y los métodos expuestos por un objeto. (Se hereda de Attribute).
Arriba

La clase de atributos PartialCachingAttribute 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 memoria caché el control. Los desarrolladores de páginas y controles utilizan el atributo PartialCachingAttribute para habilitar el almacenamiento en caché de resultados de un control de usuario en un archivo de código subyacente.

Utilizar PartialCachingAttribute es una de las diversas maneras con las que puede permitir el almacenamiento en la caché de resultados. En la lista siguiente se describen los métodos que se pueden utilizar para habilitar el almacenamiento en la caché de resultados.

  • Utilice la directiva @ OutputCache para habilitar el almacenamiento en la caché de resultados en escenarios declarativos.

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

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

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

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

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

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

  • Un control de usuario utilizado con la clase parcial ctlMine.

  • Una página de formularios Web Forms que hospeda el control de usuario.

En la primera parte del ejemplo se muestra una clase parcial que hereda de la clase base UserControl y a la que se aplica el atributo PartialCachingAttribute. En este ejemplo, el atributo especifica que el control de usuario se debe almacenar en memoria 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");

        }
    }
}


En la segunda parte del ejemplo se muestra un control de usuario utilizado con el ejemplo anterior para mostrar 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" />


En la tercera parte del ejemplo se 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

Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.
¿Te ha resultado útil?
(Caracteres restantes: 1500)

Adiciones de comunidad

AGREGAR
© 2013 Microsoft. Reservados todos los derechos.