AuthorizationRule 类

定义

AuthorizationRule 类使用户能以编程方式访问和修改配置文件的 authorization 节。The AuthorizationRule class allows you to programmatically access and modify the authorization section of a configuration file. 此类不能被继承。This class cannot be inherited.

public ref class AuthorizationRule sealed : System::Configuration::ConfigurationElement
public sealed class AuthorizationRule : System.Configuration.ConfigurationElement
type AuthorizationRule = class
    inherit ConfigurationElement
Public NotInheritable Class AuthorizationRule
Inherits ConfigurationElement
继承
AuthorizationRule

示例

下面的代码示例演示如何使用AuthorizationRuleThe following code example demonstrates how to use the AuthorizationRule.

备注

如果你使用credentials部分, 请确保遵循ASP.NET Authentication中所述的准则。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. 有关生成安全 ASP.NET 应用程序的详细信息, 请在 Microsoft MSDN 网站 (msdn.microsoft.com) 中搜索 "保护您的 ASP.NET 应用程序" 和 "构建安全 ASP.NET 应用程序:身份验证、授权和安全通信。 "For more information about building secure ASP.NET applications, search the Microsoft MSDN Web site (msdn.microsoft.com) for "Securing Your ASP.NET Application" and "Building Secure ASP.NET Applications: Authentication, Authorization, and Secure Communication."

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

 // Set the action property.
 authorizationRule.Action = 
    AuthorizationRuleAction.Allow;
 // Define the new rule to add to the collection.
 authorizationRule.Users.Add("userName");
 authorizationRule.Roles.Add("admin");
 authorizationRule.Verbs.Add("POST");

 // Add the new rule to the collection.
 authorizationSection.Rules.Add(authorizationRule);
' Using the AuthorizationRuleCollection Add method.
' Set the action property.
  authorizationRule.Action = _
  AuthorizationRuleAction.Allow
' Define the new rule to add to the collection.
authorizationRule.Users.Add("userName")
authorizationRule.Roles.Add("admin")
authorizationRule.Verbs.Add("POST")

' Add the new rule to the collection.
authorizationSection.Rules.Add(authorizationRule)

注解

AuthorizationRule 类提供一种以编程方式访问和修改配置文件的 authorization 节的方法。The AuthorizationRule class provides a way to programmatically access and modify the authorization section of a configuration file.

此类型是包含AuthorizationSection AuthorizationRuleCollection、和AuthorizationRuleAction类型的组的一部分。This type is part of a group that includes the AuthorizationSection, the AuthorizationRuleCollection, and the AuthorizationRuleAction types.

备注

AuthorizationSection可以更新配置层次结构中任意级别的配置信息。The AuthorizationSection can update the configuration information at any level in the configuration hierarchy.

构造函数

AuthorizationRule(AuthorizationRuleAction)

使用传递的对象创建 AuthorizationRule 类的新实例。Creates a new instance of the AuthorizationRule class using the passed object.

属性

Action

获取或设置 AuthorizationRule 操作。Gets or sets the AuthorizationRule action.

CurrentConfiguration

获取对顶级 Configuration 实例的引用,该实例表示当前 ConfigurationElement 实例所属的配置层次结构。Gets a reference to the top-level Configuration instance that represents the configuration hierarchy that the current ConfigurationElement instance belongs to.

(继承自 ConfigurationElement)
ElementInformation

获取包含 ConfigurationElement 对象的不可自定义的信息和功能的 ElementInformation 对象。Gets an ElementInformation object that contains the non-customizable information and functionality of the ConfigurationElement object.

(继承自 ConfigurationElement)
ElementProperty

获取表示 ConfigurationElement 对象本身的 ConfigurationElementProperty 对象。Gets the ConfigurationElementProperty object that represents the ConfigurationElement object itself.

(继承自 ConfigurationElement)
EvaluationContext

获取 ConfigurationElement 对象的 ContextInformation 对象。Gets the ContextInformation object for the ConfigurationElement object.

(继承自 ConfigurationElement)
HasContext

获取一个值,该值指示 CurrentConfiguration 属性是否为 nullGets a value that indicates whether the CurrentConfiguration property is null.

(继承自 ConfigurationElement)
Item[ConfigurationProperty]

获取或设置此配置元素的属性或特性。Gets or sets a property or attribute of this configuration element.

(继承自 ConfigurationElement)
Item[String]

获取或设置此配置元素的属性、特性或子元素。Gets or sets a property, attribute, or child element of this configuration element.

(继承自 ConfigurationElement)
LockAllAttributesExcept

获取被锁定的特性的集合。Gets the collection of locked attributes.

(继承自 ConfigurationElement)
LockAllElementsExcept

获取被锁定的元素的集合。Gets the collection of locked elements.

(继承自 ConfigurationElement)
LockAttributes

获取被锁定的特性的集合。Gets the collection of locked attributes.

(继承自 ConfigurationElement)
LockElements

获取被锁定的元素的集合。Gets the collection of locked elements.

(继承自 ConfigurationElement)
LockItem

获取或设置一个值,该值指示是否已锁定该元素。Gets or sets a value indicating whether the element is locked.

(继承自 ConfigurationElement)
Properties

获取属性的集合。Gets the collection of properties.

(继承自 ConfigurationElement)
Roles

获取与资源关联的角色。Gets the roles associated with the resource.

Users

获取与指定资源关联的用户。Gets the users associated with the resource.

Verbs

获取与资源关联的谓词。Gets the verbs associated with the resource.

方法

DeserializeElement(XmlReader, Boolean)

从配置文件读取 XML。Reads XML from the configuration file.

(继承自 ConfigurationElement)
Equals(Object)

确定指定的对象是否等于当前对象。Determines whether the specified object is equal to the current object.

GetHashCode()

作为此对象的哈希函数。Serves as a hash function for this object.

GetTransformedAssemblyString(String)

返回指定程序集名称的转换版本。Returns the transformed version of the specified assembly name.

(继承自 ConfigurationElement)
GetTransformedTypeString(String)

返回指定类型名称的转换版本。Returns the transformed version of the specified type name.

(继承自 ConfigurationElement)
GetType()

获取当前实例的 TypeGets the Type of the current instance.

(继承自 Object)
Init()

ConfigurationElement 对象设置为其初始状态。Sets the ConfigurationElement object to its initial state.

(继承自 ConfigurationElement)
InitializeDefault()

用于初始化 ConfigurationElement 对象的默认值集。Used to initialize a default set of values for the ConfigurationElement object.

(继承自 ConfigurationElement)
IsModified()

指示自上次保存或加载该配置元素后并在派生类中实现该元素时,该元素是否已被修改。Indicates whether this configuration element has been modified since it was last saved or loaded, when implemented in a derived class.

(继承自 ConfigurationElement)
IsReadOnly()

获取一个值,该值指示 ConfigurationElement 对象是否为只读。Gets a value indicating whether the ConfigurationElement object is read-only.

(继承自 ConfigurationElement)
ListErrors(IList)

将此 ConfigurationElement 对象以及所有子元素中无效属性的错误添加到传递的列表中。Adds the invalid-property errors in this ConfigurationElement object, and in all subelements, to the passed list.

(继承自 ConfigurationElement)
MemberwiseClone()

创建当前 Object 的浅表副本。Creates a shallow copy of the current Object.

(继承自 Object)
OnDeserializeUnrecognizedAttribute(String, String)

获取一个值,该值指示反序列化过程中是否遇到未知特性。Gets a value indicating whether an unknown attribute is encountered during deserialization.

(继承自 ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)

获取一个值,该值指示反序列化过程中是否遇到未知元素。Gets a value indicating whether an unknown element is encountered during deserialization.

(继承自 ConfigurationElement)
OnRequiredPropertyNotFound(String)

找不到所需属性时引发异常。Throws an exception when a required property is not found.

(继承自 ConfigurationElement)
PostDeserialize()

反序列化后调用。Called after deserialization.

(继承自 ConfigurationElement)
PreSerialize(XmlWriter)

在序列化之前调用。Called before serialization.

(继承自 ConfigurationElement)
Reset(ConfigurationElement)

重置 ConfigurationElement 对象的内部状态,包括锁和属性集合。Resets the internal state of the ConfigurationElement object, including the locks and the properties collections.

(继承自 ConfigurationElement)
ResetModified()

在派生类中实现时,将 IsModified() 方法的值重置为 falseResets the value of the IsModified() method to false when implemented in a derived class.

(继承自 ConfigurationElement)
SerializeElement(XmlWriter, Boolean)

当在派生类中实现后,将此配置元素的内容写入配置文件。Writes the contents of this configuration element to the configuration file when implemented in a derived class.

(继承自 ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)

当在派生类中实现后,将此配置元素的外部标记写入配置文件。Writes the outer tags of this configuration element to the configuration file when implemented in a derived class.

(继承自 ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)

将属性设置为指定值。Sets a property to the specified value.

(继承自 ConfigurationElement)
SetReadOnly()

设置 ConfigurationElement 对象及所有子元素的 IsReadOnly() 属性。Sets the IsReadOnly() property for the ConfigurationElement object and all subelements.

(继承自 ConfigurationElement)
ToString()

返回一个表示当前对象的 string。Returns a string that represents the current object.

(继承自 Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)

修改 ConfigurationElement 对象以移除所有不应该保存的值。Modifies the ConfigurationElement object to remove all values that should not be saved.

(继承自 ConfigurationElement)

适用于

另请参阅