SystemWebCachingSectionGroup Class

Definition

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

See also