This documentation is archived and is not being maintained.

AuthorizationRule Class

The AuthorizationRule class allows you to programmatically access and modify the authorization section of a configuration file. This class cannot be inherited.

Namespace:  System.Web.Configuration
Assembly:  System.Web (in System.Web.dll)

public sealed class AuthorizationRule : ConfigurationElement

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

This type is part of a group that includes the AuthorizationSection, the AuthorizationRuleCollection, and the AuthorizationRuleAction types.


The AuthorizationSection can update the configuration information at any level in the configuration hierarchy.

The following code example demonstrates how to use the AuthorizationRule.


If you use the credentials section, be sure to follow the guidelines explained at ASP.NET Authentication. For scalability and better security capability, it is recommended that you use an external database to store users' credentials. For more information about building secure ASP.NET applications, search the Microsoft MSDN Web site ( for "Securing Your ASP.NET Application" and "Building Secure ASP.NET Applications: Authentication, Authorization, and Secure Communication."

// Create an authorization rule object.
AuthorizationRuleAction action =
AuthorizationRule authorizationRule = 
    new System.Web.Configuration.AuthorizationRule(action);
// Using the AuthorizationRuleCollection Add method. 

// Set the action property.
authorizationRule.Action = 
// Define the new rule to add to the collection.

// Add the new rule to the collection.


Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0