SystemWebCachingSectionGroup Class

Reference

Definition

Namespace:: System.Web.Configuration

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Configures the caching group within a configuration file. This class cannot be inherited.

public ref class SystemWebCachingSectionGroup sealed : System::Configuration::ConfigurationSectionGroup

public sealed class SystemWebCachingSectionGroup : System.Configuration.ConfigurationSectionGroup

type SystemWebCachingSectionGroup = class
    inherit ConfigurationSectionGroup

Public NotInheritable Class SystemWebCachingSectionGroup
Inherits ConfigurationSectionGroup

Inheritance: Object

ConfigurationSectionGroup
SystemWebCachingSectionGroup

Examples

The following code example shows how to obtain the SystemWebCachingSectionGroup object from the configuration file associated with an existing Web application. You can use this object to access the sections contained in the caching group.


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

// Get the <caching> section group.
SystemWebCachingSectionGroup cachingSectionGroup =
  (SystemWebCachingSectionGroup)configuration.GetSectionGroup(
  "system.web/caching");

' Get the Web application configuration.
Dim configuration _
As System.Configuration.Configuration = _
WebConfigurationManager.OpenWebConfiguration( _
"/aspnetTest")

' Get the <caching> section group.
Dim cachingSectionGroup _
As SystemWebCachingSectionGroup = _
CType(configuration.GetSectionGroup( _
"system.web/caching"), SystemWebCachingSectionGroup)

Remarks

The SystemWebCachingSectionGroup class provides a way to programmatically access and modify the caching section of a configuration file.

The SystemWebCachingSectionGroup class and the caching section provide centralized control of the caching mechanism for a site or application. This makes it possible for caching to be deployed, modified, and disabled without modifying individual pages in the application.

The ASP.NET caching mechanism is implemented by the Cache class. For more information, see ASP.NET Caching Overview.

The following list describes the two types of caching ASP.NET provides.

The first is called output caching, which allows you to store dynamic page and user control responses. On subsequent requests, the page or user control code is not executed; the cached output is used to satisfy the request. You can access output caching settings using the OutputCache and OutputCacheSettings properties.
The second type of caching is traditional application data caching, which you can use to programmatically store arbitrary objects to server memory so your application can save the time and resources it takes to recreate them. You can access these cache settings using the Cache property.

Constructors

SystemWebCachingSectionGroup()

Creates a new instance of SystemWebCachingSectionGroup.

Properties

Cache	Gets the `cache` section contained within the configuration.
IsDeclarationRequired	Gets a value that indicates whether this ConfigurationSectionGroup object declaration is required. (Inherited from ConfigurationSectionGroup)
IsDeclared	Gets a value that indicates whether this ConfigurationSectionGroup object is declared. (Inherited from ConfigurationSectionGroup)
Name	Gets the name property of this ConfigurationSectionGroup object. (Inherited from ConfigurationSectionGroup)
OutputCache	Gets the `outputCache` section contained within the configuration.
OutputCacheSettings	Gets the `outputCacheSettings` section contained within the configuration.
SectionGroupName	Gets the section group name associated with this ConfigurationSectionGroup. (Inherited from ConfigurationSectionGroup)
SectionGroups	Gets a ConfigurationSectionGroupCollection object that contains all the ConfigurationSectionGroup objects that are children of this ConfigurationSectionGroup object. (Inherited from ConfigurationSectionGroup)
Sections	Gets a ConfigurationSectionCollection object that contains all of ConfigurationSection objects within this ConfigurationSectionGroup object. (Inherited from ConfigurationSectionGroup)
SqlCacheDependency	Gets the `sqlCacheDependency` section contained within the configuration.
Type	Gets or sets the type for this ConfigurationSectionGroup object. (Inherited from ConfigurationSectionGroup)

Methods

Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
ForceDeclaration()	Forces the declaration for this ConfigurationSectionGroup object. (Inherited from ConfigurationSectionGroup)
ForceDeclaration(Boolean)	Forces the declaration for this ConfigurationSectionGroup object. (Inherited from ConfigurationSectionGroup)
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetType()	Gets the Type of the current instance. (Inherited from Object)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
ShouldSerializeSectionGroupInTargetVersion(FrameworkName)	Indicates whether the current ConfigurationSectionGroup instance should be serialized when the configuration object hierarchy is serialized for the specified target version of the .NET Framework. (Inherited from ConfigurationSectionGroup)
ToString()	Returns a string that represents the current object. (Inherited from Object)

Applies to

Share via