DefaultAuthenticationModule 類別

定義

命名空間:

System.Web.Security

組件:

System.Web.dll

確定內容中有驗證 (Authentication) 物件。 此類別無法獲得繼承。

public ref class DefaultAuthenticationModule sealed : System::Web::IHttpModule

public sealed class DefaultAuthenticationModule : System.Web.IHttpModule

type DefaultAuthenticationModule = class
    interface IHttpModule

Public NotInheritable Class DefaultAuthenticationModule
Implements IHttpModule

繼承

Object

DefaultAuthenticationModule

實作

IHttpModule

範例

下列範例會使用 DefaultAuthentication_OnAuthenticate 事件來測試目前HttpContext實體的 屬性是否User為 null。 User如果 屬性為 null，則範例會將目前HttpContext實例GenericPrincipal的 屬性設定User為 物件，其中 IdentityGenericPrincipal 物件的 值為 GenericIdentityName “default”。

注意

事件之前AuthorizeRequest會引發DefaultAuthentication_OnAuthenticate事件。 因此，如果您將 User 目前 HttpContext 實例的屬性設定為自定義身分識別，它可能會影響應用程式的行為。 例如，如果您使用 FormsAuthentication 類別，而且您在授權組態區段中指定<deny users="?" />，以確保只有已驗證的使用者可以存取您的網站，則此範例會導致忽略 deny 元素，因為使用者的名稱會是 “default”。相反地，您會指定<deny users="default" />以確保只有已驗證的使用者可以存取您的網站。

public void DefaultAuthentication_OnAuthenticate(object sender,
                                                 DefaultAuthenticationEventArgs args)
{
  if (args.Context.User == null)
    args.Context.User = 
      new System.Security.Principal.GenericPrincipal(
        new System.Security.Principal.GenericIdentity("default"),
        new String[0]);
}

Public Sub DefaultAuthentication_OnAuthenticate(sender As Object, _
                                                args As DefaultAuthenticationEventArgs)
  If args.Context.User Is Nothing Then
    args.Context.User = _
      new System.Security.Principal.GenericPrincipal( _
        new System.Security.Principal.GenericIdentity("default"), _
        new String(0) {})
  End If
End Sub

備註

DefaultAuthenticationModule可確保User目前HttpContext實例的 屬性會設定為IPrincipal每個要求的物件。 會在 DefaultAuthenticationModule 事件之後AuthenticateRequest和 事件之前AuthorizeRequest檢查 User 屬性。 User如果屬性為 null，則會DefaultAuthenticationModule將 User 屬性設定為GenericPrincipal不包含使用者信息的物件。

如果驗證模組將 屬性設定 StatusCode 為 401，則會 DefaultAuthenticationModule 轉譯拒絕存取的錯誤頁面。 如果 屬性的值 StatusCode 設定為大於 200 的值，物件 DefaultAuthenticationModule 將會結束要求。 在此情況下，只有在完成目前要求之前，才會呼叫訂閱 EndRequest 事件的 HTTP 模組。

會 DefaultAuthenticationModule 公開 Authenticate 事件。 您可以使用這個事件，為User目前HttpContext實例的 屬性提供自定義IPrincipal物件。 在應用程式的 Global.asax 檔案中指定名為 DefaultAuthentication_OnAuthenticate 的事件，即可Authenticate存取此事件。

建構函式

DefaultAuthenticationModule()

初始化 DefaultAuthenticationModule 類別的新執行個體。

方法

Dispose()	除了記憶體之外，釋放 DefaultAuthenticationModule 使用的所有資源。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
Init(HttpApplication)	初始化 DefaultAuthenticationModule 物件。
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

事件

Authenticate

在要求已經驗證之後發生。

另請參閱

• ASP.NET 驗證