AuthorizationRule 類別

參考

定義

命名空間:: System.Web.Configuration

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

AuthorizationRule 類別允許您以程式方式存取並修改組態檔中的 authorization 項目。此類別無法獲得繼承。

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

繼承: Object

ConfigurationElement
AuthorizationRule

範例

下列程式碼範例示範如何使用 AuthorizationRule 。

注意

如果您使用本節 credentials ，請務必遵循 ASP.NET 驗證中所述的指導方針。如需延展性和更佳的安全性功能，建議您使用外部資料庫來儲存使用者的認證。如需建置安全 ASP.NET 應用程式的詳細資訊，請參閱保護您的 ASP.NET 應用程式和建置安全 ASP.NET 應用程式：驗證、授權和安全通訊。

// 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 類別 (Class) 提供以程式的方法，存取和修改組態檔的 authorization 區段。

此類型是包含 AuthorizationSection 、 AuthorizationRuleCollection 和型別之 AuthorizationRuleAction 群組的一部分。

注意

AuthorizationSection可以在組態階層中的任何層級更新組態資訊。

建構函式

AuthorizationRule(AuthorizationRuleAction)

使用傳遞的物件來建立 AuthorizationRule 類別的新執行個體。

屬性

Action	取得或設定 AuthorizationRule 動作。
CurrentConfiguration	取得最上層 Configuration 執行個體的參考，這個執行個體表示目前 ConfigurationElement 執行個體所屬的組態階層架構。 (繼承來源 ConfigurationElement)
ElementInformation	取得 ElementInformation 物件，其中包含 ConfigurationElement 物件之不可自訂的資訊和功能。 (繼承來源 ConfigurationElement)
ElementProperty	取得表示 ConfigurationElementProperty 物件本身的 ConfigurationElement 物件。 (繼承來源 ConfigurationElement)
EvaluationContext	取得 ConfigurationElement 物件的 ContextInformation 物件。 (繼承來源 ConfigurationElement)
HasContext	取得值，指出 CurrentConfiguration 屬性是否為 `null`。 (繼承來源 ConfigurationElement)
Item[ConfigurationProperty]	取得或設定此組態項目的屬性 (Property) 或屬性 (Attribute)。 (繼承來源 ConfigurationElement)
Item[String]	取得或設定此一組態項目的屬性或子項目。 (繼承來源 ConfigurationElement)
LockAllAttributesExcept	取得已鎖定屬性的集合。 (繼承來源 ConfigurationElement)
LockAllElementsExcept	取得已鎖定項目的集合。 (繼承來源 ConfigurationElement)
LockAttributes	取得已鎖定屬性的集合。 (繼承來源 ConfigurationElement)
LockElements	取得已鎖定項目的集合。 (繼承來源 ConfigurationElement)
LockItem	取得或設定值，指出此項目是否已被鎖定。 (繼承來源 ConfigurationElement)
Properties	取得屬性的集合。 (繼承來源 ConfigurationElement)
Roles	取得與資源關聯的角色。
Users	取得與資源關聯的使用者。
Verbs	取得與資源關聯的動詞命令。

方法

DeserializeElement(XmlReader, Boolean)	從組態檔讀取 XML。 (繼承來源 ConfigurationElement)
Equals(Object)	判斷指定的物件是否等於目前的物件。
GetHashCode()	做為此物件的雜湊函式。
GetTransformedAssemblyString(String)	傳回指定之組件名稱的轉換版本。 (繼承來源 ConfigurationElement)
GetTransformedTypeString(String)	傳回指定之型別名稱的轉換版本。 (繼承來源 ConfigurationElement)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
Init()	將 ConfigurationElement 物件設定為它的初始狀態。 (繼承來源 ConfigurationElement)
InitializeDefault()	用來初始化 ConfigurationElement 物件的預設值集。 (繼承來源 ConfigurationElement)
IsModified()	在衍生類別中進行實作時，指出這個組態項目自上次儲存或載入後是否已修改。 (繼承來源 ConfigurationElement)
IsReadOnly()	取得值，這個值表示 ConfigurationElement 物件是否唯讀。 (繼承來源 ConfigurationElement)
ListErrors(IList)	將這個 ConfigurationElement 物件中和所有子項目中的無效屬性錯誤加入傳遞的清單。 (繼承來源 ConfigurationElement)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
OnDeserializeUnrecognizedAttribute(String, String)	取得值，指出在還原序列化程序中是否遇到未知的屬性 (Attribute)。 (繼承來源 ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	取得值，指出在還原序列化程序中是否遇到未知的項目。 (繼承來源 ConfigurationElement)
OnRequiredPropertyNotFound(String)	在找不到必要的屬性時擲回例外狀況 (Exception)。 (繼承來源 ConfigurationElement)
PostDeserialize()	還原序列化之後呼叫。 (繼承來源 ConfigurationElement)
PreSerialize(XmlWriter)	序列化之前呼叫。 (繼承來源 ConfigurationElement)
Reset(ConfigurationElement)	重設 ConfigurationElement 物件的內部狀態，包括鎖定和屬性的集合。 (繼承來源 ConfigurationElement)
ResetModified()	在衍生類別中實作時，將 IsModified() 方法的值重設為 `false`。 (繼承來源 ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	在衍生類別中實作時，將此組態項目的內容寫入組態檔中。 (繼承來源 ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	在衍生類別中實作時，將此組態項目的外部標記寫入組態檔中。 (繼承來源 ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	將屬性設定為指定的值。 (繼承來源 ConfigurationElement)
SetReadOnly()	設定 IsReadOnly() 物件和所有子項目的 ConfigurationElement 屬性。 (繼承來源 ConfigurationElement)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	修改 ConfigurationElement 物件，以移除不應該儲存的所有值。 (繼承來源 ConfigurationElement)

適用於

AuthorizationRule 類別

定義

範例

備註

建構函式

屬性

方法

適用於

另請參閱

意見反應

其他資源