Para ver el artículo en inglés, active la casilla Inglés. También puede ver el texto en inglés en una ventana emergente si pasa el puntero del mouse por el texto.
Traducción
Inglés
Esta documentación está archivada y no tiene mantenimiento.

CacheSection (Clase)

Configura los valores de la caché global para una aplicación ASP.NET. Esta clase no puede heredarse.

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

public sealed class CacheSection : ConfigurationSection

El tipo CacheSection expone los siguientes miembros.

  NombreDescripción
Método públicoCacheSectionInfraestructura. Inicializa una nueva instancia de la clase CacheSection.
Arriba

  NombreDescripción
Propiedad públicaCurrentConfigurationObtiene una referencia a la instancia de Configuration de nivel superior que representa la jerarquía de configuración a la que pertenece la instancia actual de ConfigurationElement. (Se hereda de ConfigurationElement).
Propiedad públicaDisableExpirationObtiene o establece un valor que indica si la expiración de la memoria caché está deshabilitado.
Propiedad públicaDisableMemoryCollectionObtiene o establece un valor que indica si la colección de la memoria caché está deshabilitada.
Propiedad públicaElementInformationObtiene un objeto ElementInformation que contiene la funcionalidad e información no personalizable del objeto ConfigurationElement. (Se hereda de ConfigurationElement).
Propiedad protegidaElementPropertyObtiene el objeto ConfigurationElementProperty que representa al propio objeto ConfigurationElement. (Se hereda de ConfigurationElement).
Propiedad protegidaEvaluationContextObtiene el objeto ContextInformation para el objeto ConfigurationElement. (Se hereda de ConfigurationElement).
Propiedad protegidaItem[ConfigurationProperty]Obtiene o establece una propiedad o atributo de este elemento de configuración. (Se hereda de ConfigurationElement).
Propiedad protegidaItem[String]Obtiene o establece una propiedad, un atributo o un elemento secundario de este elemento de configuración. (Se hereda de ConfigurationElement).
Propiedad públicaLockAllAttributesExceptObtiene la colección de atributos bloqueados. (Se hereda de ConfigurationElement).
Propiedad públicaLockAllElementsExceptObtiene la colección de elementos bloqueados. (Se hereda de ConfigurationElement).
Propiedad públicaLockAttributesObtiene la colección de atributos bloqueados. (Se hereda de ConfigurationElement).
Propiedad públicaLockElementsObtiene la colección de elementos bloqueados. (Se hereda de ConfigurationElement).
Propiedad públicaLockItemObtiene o establece un valor que indica si el elemento está bloqueado. (Se hereda de ConfigurationElement).
Propiedad públicaPercentagePhysicalMemoryUsedLimitObtiene o establece un valor que indica el porcentaje máximo de utilización de la memoria virtual.
Propiedad públicaPrivateBytesLimitObtiene o establece un valor que indica el tamaño máximo del espacio privado del proceso de trabajo.
Propiedad públicaPrivateBytesPollTimeObtiene o establece un valor que indica el intervalo de tiempo entre el sondeo de utilización de la memoria del proceso de trabajo.
Propiedad protegidaPropertiesObtiene la colección de propiedades. (Se hereda de ConfigurationElement).
Propiedad públicaSectionInformationObtiene un objeto SectionInformation que contiene la funcionalidad e información no personalizable del objeto ConfigurationSection. (Se hereda de ConfigurationSection).
Arriba

  NombreDescripción
Método protegidoDeserializeElementLee XML del archivo de configuración. (Se hereda de ConfigurationElement).
Método protegidoDeserializeSectionInfraestructura. Lee XML del archivo de configuración. (Se hereda de ConfigurationSection).
Método públicoEqualsCompara la instancia actual de ConfigurationElement con el objeto especificado. (Se hereda de ConfigurationElement).
Método protegidoFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Se hereda de Object).
Método públicoGetHashCodeObtiene un valor único que representa la instancia actual de ConfigurationElement. (Se hereda de ConfigurationElement).
Método protegidoGetRuntimeObjectDevuelve un objeto personalizado cuando se reemplaza en una clase derivada. (Se hereda de ConfigurationSection).
Método protegidoGetTransformedAssemblyStringDevuelve la versión transformada del nombre de ensamblado especificado. (Se hereda de ConfigurationElement).
Método protegidoGetTransformedTypeStringDevuelve la versión transformada del nombre de tipo especificado. (Se hereda de ConfigurationElement).
Método públicoGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método protegidoInitEstablece el objeto ConfigurationElement en su estado inicial. (Se hereda de ConfigurationElement).
Método protegidoInitializeDefaultSe utiliza para inicializar un conjunto predeterminado de valores para el objeto ConfigurationElement. (Se hereda de ConfigurationElement).
Método protegidoIsModifiedIndica si se ha modificado este elemento de configuración desde la última vez en que se guardo o cargó al implementarlo en una clase derivada. (Se hereda de ConfigurationSection).
Método públicoIsReadOnlyObtiene un valor que indica si el objeto ConfigurationElement es de sólo lectura. (Se hereda de ConfigurationElement).
Método protegidoListErrorsAgrega a la lista que se pasa los errores de propiedad no válida que hay en este objeto ConfigurationElement y en todos los subelementos. (Se hereda de ConfigurationElement).
Método protegidoMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método protegidoOnDeserializeUnrecognizedAttributeObtiene un valor que indica si se ha encontrado un atributo desconocido durante la deserialización. (Se hereda de ConfigurationElement).
Método protegidoOnDeserializeUnrecognizedElementObtiene un valor que indica si se ha encontrado un elemento desconocido durante la deserialización. (Se hereda de ConfigurationElement).
Método protegidoOnRequiredPropertyNotFoundSe inicia una excepción cuando no se encuentra una propiedad necesaria. (Se hereda de ConfigurationElement).
Método protegidoPostDeserializeSe llama a este método después de la deserialización. (Se hereda de ConfigurationElement).
Método protegidoPreSerializeSe llama a este método antes de la serialización. (Se hereda de ConfigurationElement).
Método protegidoResetRestablece el estado interno del objeto ConfigurationElement, incluyendo los bloqueos y las colecciones de propiedades. (Se hereda de ConfigurationElement).
Método protegidoResetModifiedRestablece el valor del método IsModified en false al implementarlo en una clase derivada. (Se hereda de ConfigurationSection).
Método protegidoSerializeElementEscribe el contenido de este elemento de configuración en el archivo de configuración cuando se implementa en una clase derivada. (Se hereda de ConfigurationElement).
Método protegidoSerializeSectionInfraestructura. Crea una cadena XML que contiene una vista separada del objeto ConfigurationSection como una sección única para escribir en un archivo. (Se hereda de ConfigurationSection).
Método protegidoSerializeToXmlElementEscribe las etiquetas externas de este elemento de configuración en el archivo de configuración cuando se implementa en una clase derivada. (Se hereda de ConfigurationElement).
Método protegidoSetPropertyValueEstablece una propiedad en el valor especificado. (Se hereda de ConfigurationElement).
Método protegidoSetReadOnlyEstablece la propiedad IsReadOnly para el objeto ConfigurationElement y todos los subelementos. (Se hereda de ConfigurationElement).
Método protegidoShouldSerializeElementInTargetVersionIndica si se debe serializar el elemento especificado cuando la jerarquía de objetos de configuración se serializa para la versión de destino especificada de .NET Framework. (Se hereda de ConfigurationSection).
Método protegidoShouldSerializePropertyInTargetVersionIndica si se debe serializar la propiedad especificada cuando la jerarquía de objetos de configuración se serializa para la versión de destino especificada de .NET Framework. (Se hereda de ConfigurationSection).
Método protegidoShouldSerializeSectionInTargetVersionIndica si se debe serializar la instancia actual de ConfigurationSection cuando la jerarquía de objetos de configuración se serializa para la versión de destino especificada de .NET Framework. (Se hereda de ConfigurationSection).
Método públicoToString Devuelve una cadena que representa al objeto actual. (Se hereda de Object).
Método protegidoUnmergeModifica el objeto ConfigurationElement para quitar todos los valores que no se deben guardar. (Se hereda de ConfigurationElement).
Arriba

La clase CacheSection permite obtener acceso y modificar mediante programación la sección <cache> de un archivo de configuración.

La clase Cache implementa la característica de almacenamiento en caché de ASP.NET. Para obtener más información, vea Almacenamiento en caché en ASP.NET.

NotaNota

La clase CacheSection puede escribir información en la sección relacionada del archivo de configuración según las restricciones definidas por la propiedad de la sección AllowDefinition cuyo valor es MachineToApplication. Cualquier intento de escribir en un archivo de configuración en un nivel no permitido de la jerarquía hará que el analizador genere un mensaje de error. No obstante, se puede utilizar esta clase para leer la información de configuración en cualquier nivel de la jerarquía.

Una caché es una tabla hash específica de la aplicación en la que se almacenan los datos a los que se tiene acceso con más frecuencia. El estado de la aplicación y de la sesión son similares a la caché, siendo el más parecido el estado de la aplicación, debido a que su ámbito es toda la aplicación. Una de las diferencias más grandes entre la caché y el mecanismo de estado de aplicación es que la caché admite dependencias, lo que permite compilar aplicaciones que quitan automáticamente los elementos almacenados en la memoria caché cuando se producen ciertos eventos.

El siguiente ejemplo de código muestra una página y el archivo de código relacionado utilizado para tener acceso a los atributos de la sección CacheSection.


<%@ Page Language="VB" AutoEventWireup="false" CodeFile="ReadWriteCache.aspx.vb" Inherits="ReadWriteCache" %>

<!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">
<head id="Head1" runat="server">
    <title>Read Write Application Cache</title>
</head>
<body>
    <form id="form1" runat="server">
        <h2>Read Write Application Cache</h2>

        <asp:Label ID="Label1" Text="[Application Cache goes here.]" runat="server"></asp:Label>

        <hr />

        <asp:Button ID="Button1" runat="server" onclick="Button1_Click" Text="Write Cache" /> &nbsp; &nbsp;
        <asp:Button ID="Button2" runat="server" onclick="Button2_Click" Text="Read Cache" />
    </form>
</body>
</html>



using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

public partial class ReadWriteCache : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        if (!IsPostBack)
            Label1.Text = "Application Cache goes here.";

    }

    protected void Button1_Click(object sender, EventArgs e)
    {
        // Get the application configuration file.
        System.Configuration.Configuration config =
          System.Web.Configuration.WebConfigurationManager.OpenWebConfiguration("~/");


        System.Web.Configuration.CacheSection cacheSection =
            (System.Web.Configuration.CacheSection)config.GetSection(
                "system.web/caching/cache");

        // Increase the PrivateBytesLimit property to 0.
        cacheSection.PrivateBytesLimit = 
            cacheSection.PrivateBytesLimit + 10;


        // Increase memory limit.
        cacheSection.PercentagePhysicalMemoryUsedLimit = 
            cacheSection.PercentagePhysicalMemoryUsedLimit + 1;

        // Increase poll time.
        cacheSection.PrivateBytesPollTime =
            cacheSection.PrivateBytesPollTime + TimeSpan.FromMinutes(1);


        // Enable or disable memory collection.
        cacheSection.DisableMemoryCollection = 
                !cacheSection.DisableMemoryCollection;

        // Enable or disable cache expiration.
        cacheSection.DisableExpiration =
            !cacheSection.DisableExpiration;

        // Save the configuration file.
        config.Save(System.Configuration.ConfigurationSaveMode.Modified);      

    }

    protected void Button2_Click(object sender, EventArgs e)
    {

        // Get the application configuration file.
        System.Configuration.Configuration config =
          System.Web.Configuration.WebConfigurationManager.OpenWebConfiguration("~/");


        System.Web.Configuration.CacheSection cacheSection =
            (System.Web.Configuration.CacheSection)config.GetSection(
                "system.web/caching/cache");

        // Read the cache section.
        System.Text.StringBuilder buffer = new System.Text.StringBuilder();

        string currentFile = cacheSection.CurrentConfiguration.FilePath;
        bool dExpiration = cacheSection.DisableExpiration;
        bool dMemCollection = cacheSection.DisableMemoryCollection;
        TimeSpan pollTime = cacheSection.PrivateBytesPollTime;
        int phMemUse = cacheSection.PercentagePhysicalMemoryUsedLimit;
        long pvBytesLimit = cacheSection.PrivateBytesLimit;

        string cacheEntry = String.Format("File: {0} <br/>", currentFile);
        buffer.Append(cacheEntry);
        cacheEntry = String.Format("Expiration Disabled: {0} <br/>", dExpiration);
        buffer.Append(cacheEntry);
        cacheEntry = String.Format("Memory Collection Disabled: {0} <br/>", dMemCollection);
        buffer.Append(cacheEntry);
        cacheEntry = String.Format("Poll Time: {0} <br/>", pollTime.ToString());
        buffer.Append(cacheEntry);
        cacheEntry = String.Format("Memory Limit: {0} <br/>", phMemUse.ToString());
        buffer.Append(cacheEntry);
        cacheEntry = String.Format("Bytes Limit: {0} <br/>", pvBytesLimit.ToString());
        buffer.Append(cacheEntry);

        Label1.Text = buffer.ToString();
    }
}


.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.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.
Mostrar: