WindowsAuthenticationModule 類別

定義

命名空間:

System.Web.Security

組件:

System.Web.dll

在啟用 Windows 驗證 (Authentication) 時，設定 ASP.NET 應用程式的使用者識別。 此類別無法獲得繼承。

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

public sealed class WindowsAuthenticationModule : System.Web.IHttpModule

type WindowsAuthenticationModule = class
    interface IHttpModule

Public NotInheritable Class WindowsAuthenticationModule
Implements IHttpModule

繼承

Object

WindowsAuthenticationModule

實作

IHttpModule

範例

下列程式代碼範例會使用 WindowsAuthentication_OnAuthenticate 事件，將目前 HttpContext 的屬性設定User為自定義IPrincipal物件。

public void WindowsAuthentication_OnAuthenticate(object sender, WindowsAuthenticationEventArgs args)
{
  if (!args.Identity.IsAnonymous)
  {
    args.User = new Samples.AspNet.Security.MyPrincipal(args.Identity);
  }
}

Public Sub WindowsAuthentication_OnAuthenticate(sender As Object, args As WindowsAuthenticationEventArgs)
  If Not args.Identity.IsAnonymous Then
    args.User = New Samples.AspNet.Security.MyPrincipal(args.Identity)
  End If
End Sub

備註

當驗證Mode設定Windows為 時，會將WindowsAuthenticationModule目前 HttpContext 的屬性設定User為 IPrincipal 物件，代表 IIS 針對目前要求提供的 Windows 身分識別。 如果 IIS 使用匿名驗證，則會 WindowsAuthenticationModule 使用 方法傳回的 GetAnonymous 身分識別。

會WindowsAuthenticationModuleAuthenticate公開事件，讓您為目前 HttpContext的屬性提供自定義IPrincipal物件User。 在 Authenticate ASP.NET 應用程式的 Global.asax 檔案中指定名為 WindowsAuthentication_OnAuthenticate 的子程式，即可存取此事件。

注意

在 IIS 7.0 中，不支援搭配 WindowsAuthenticationModuleFormsAuthenticationModule 類別使用 類別。 如需整合模式中相容性問題的詳細資訊，請參閱 將 ASP.NET 應用程式從 IIS 6.0 移至 IIS 7.0。

建構函式

WindowsAuthenticationModule()

建立 WindowsAuthenticationModule 類別的執行個體。

方法

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

事件

Authenticate

在應用程式驗證目前要求時發生。

另請參閱

• Windows 驗證提供者