ApplicationPoolRecycling Class
IIS 7.0
Configures recycling settings for an application pool.
System..::..Object
Microsoft.Web.Administration..::..ConfigurationElement
Microsoft.Web.Administration..::..ApplicationPoolRecycling
Microsoft.Web.Administration..::..ConfigurationElement
Microsoft.Web.Administration..::..ApplicationPoolRecycling
Assembly: Microsoft.Web.Administration (in Microsoft.Web.Administration.dll)
The ApplicationPoolRecycling type exposes the following members.
| Name | Description | |
|---|---|---|
|
Attributes | Gets a configuration attribute collection that contains the list of attributes for this element. (Inherited from ConfigurationElement.) |
|
ChildElements | Gets all the child elements of the current element. (Inherited from ConfigurationElement.) |
|
DisallowOverlappingRotation | Gets or sets the startup behavior of overlapping worker processes. |
|
DisallowRotationOnConfigChange | Gets or sets the startup behavior of overlapping worker processes in an application pool when a configuration change is detected. |
|
ElementTagName | Gets the XML tag name of the current element. (Inherited from ConfigurationElement.) |
|
IsLocallyStored | Gets a value indicating whether the configuration element is stored in a particular configuration file. (Inherited from ConfigurationElement.) |
|
Item | Gets or sets an attribute with the specified name. (Inherited from ConfigurationElement.) |
|
LogEventOnRecycle | Gets or sets the logging behavior of a recycling application pool. |
|
Methods | Gets a collection of methods for the configuration element. (Inherited from ConfigurationElement.) |
|
PeriodicRestart | Gets the settings for application pool recycling. |
|
RawAttributes | Gets the raw attribute names and values for the current configuration element. (Inherited from ConfigurationElement.) |
|
Schema | Gets the schema for the current element. (Inherited from ConfigurationElement.) |
| Name | Description | |
|---|---|---|
|
Delete | (Inherited from ConfigurationElement.) |
|
Equals | (Inherited from Object.) |
|
Finalize | (Inherited from Object.) |
|
GetAttribute | Returns a ConfigurationAttribute object that represents the requested attribute. (Inherited from ConfigurationElement.) |
|
GetAttributeValue | Returns the value of the specified attribute. (Inherited from ConfigurationElement.) |
|
GetChildElement(String) | Returns a child element that is under the current configuration element and has the specified name. (Inherited from ConfigurationElement.) |
|
GetChildElement(String, Type) | Returns a child element that is under the current configuration element and has the specified name and type. (Inherited from ConfigurationElement.) |
|
GetCollection()()()() | Returns the default collection for the current configuration element. (Inherited from ConfigurationElement.) |
|
GetCollection(String) | Returns all configuration elements that belong to the current configuration element. (Inherited from ConfigurationElement.) |
|
GetCollection(Type) | Returns the configuration element that has the specified type and is under the current configuration element. (Inherited from ConfigurationElement.) |
|
GetCollection(String, Type) | Returns the configuration element that has the specified name and type and is under the current configuration element. (Inherited from ConfigurationElement.) |
|
GetHashCode | (Inherited from Object.) |
|
GetMetadata | Returns metadata values from the element schema. (Inherited from ConfigurationElement.) |
|
GetType | (Inherited from Object.) |
|
MemberwiseClone | (Inherited from Object.) |
|
SetAttributeValue | Sets the value of the specified attribute. (Inherited from ConfigurationElement.) |
|
SetMetadata | Sets metadata values from the element schema. (Inherited from ConfigurationElement.) |
|
ToString | (Inherited from Object.) |
Unless the default application pool recycling settings are locked, individual application pool settings can override them.
When the properties of an ApplicationPoolRecycling object are modified, you must call the ServerManager..::..CommitChanges method to persist the values to the ApplicationHost.config file and to IIS Manager.
The following example displays a few property values for the ApplicationPoolRecycling object. The LogEventOnRecycle property is changed to Requests and Schedule, the ApplicationPoolPeriodicRestart..::..Time property is changed to 5 minutes.
using System; using System.Collections.Generic; using System.Text; using Microsoft.Web.Administration; using Microsoft.Web.Management; namespace AdministrationSnippets { class ApplicationPoolRecycling { public void GetApplicationPoolRecycling() { ServerManager manager = new ServerManager(); // Get the application recycling property values. Console.WriteLine("DisallowOverlappingRotation:\t{0}", manager.ApplicationPools["DefaultAppPool"].Recycling.DisallowOverlappingRotation.ToString()); Console.WriteLine("DisallowRotationOnConfigChange:\t{0}", manager.ApplicationPools["DefaultAppPool"].Recycling.DisallowRotationOnConfigChange.ToString()); Console.WriteLine("LogEventOnRecycle:\t{0}", manager.ApplicationPools["DefaultAppPool"].Recycling.LogEventOnRecycle.ToString()); Console.WriteLine("PeriodicRestart.Time:\t{0}", manager.ApplicationPools["DefaultAppPool"].Recycling.PeriodicRestart.Time); // Change the LogEventOnRecycle and PeriodicRestart.Time properties. manager.ApplicationPools["DefaultAppPool"].Recycling.LogEventOnRecycle = (RecyclingLogEventOnRecycle)6; manager.ApplicationPools["DefaultAppPool"].Recycling.PeriodicRestart.Time = TimeSpan.FromMinutes(5); // Commit the changes to ApplicationHost.config file. manager.CommitChanges(); } } }