WindowsAuthenticationModule

.NET Framework クラス ライブラリ リファレンス

WindowsAuthenticationModule イベント

パブリック イベント

	名前	説明
	Authenticate	アプリケーションが現在の要求を認証するときに発生します。

参照

関連項目

WindowsAuthenticationModule クラス
System.Web.Security 名前空間

その他の技術情報

Windows 認証プロバイダ
Global.asax 構文

WindowsAuthenticationModule クラス

Windows 認証が有効な場合、ASP.NET アプリケーションに対してユーザーの ID を設定します。このクラスは継承できません。

名前空間: System.Web.Security
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 WindowsAuthenticationModule
    Implements IHttpModule

Visual Basic (使用法)

Dim instance As WindowsAuthenticationModule

C#

public sealed class WindowsAuthenticationModule
 : IHttpModule

C++

public ref class WindowsAuthenticationModule
 sealed : IHttpModule

J#

public final class WindowsAuthenticationModule
 implements IHttpModule

JScript

public final class WindowsAuthenticationModule
 implements IHttpModule

解説

認証 Mode が Windows に設定されている場合、WindowsAuthenticationModule は、現在の HttpContext の User プロパティを、現在の要求に対して IIS が提供した Windows ID を表す IPrincipal オブジェクトに設定します。IIS が匿名認証を使用する場合、WindowsAuthenticationModule は、GetAnonymous メソッドによって返される ID を使用します。

WindowsAuthenticationModule は Authenticate イベントを公開します。このイベントにより、現在の HttpContext の User プロパティにカスタム IPrincipal オブジェクトを設定できます。Authenticate イベントには、ASP.NET アプリケーションの Global.asax ファイルに、WindowsAuthentication_OnAuthenticate というサブルーチンを指定することによってアクセスします。

使用例

WindowsAuthentication_OnAuthenticate イベントを使用して、現在の HttpContext の User プロパティにカスタム IPrincipal オブジェクトを設定するコード例を次に示します。

Visual Basic

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

C#

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

.NET Framework のセキュリティ

• AspNetHostingPermission  (ホスト環境で WindowsAuthenticationModule クラスを使用するために必要なアクセス許可)要求値 : LinkDemand。アクセス許可値 : Minimal。

継承階層

System.Object
  System.Web.Security.WindowsAuthenticationModule

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
WindowsAuthenticationModule メンバ
System.Web.Security 名前空間
その他の技術情報
Windows 認証プロバイダ
Global.asax 構文

WindowsAuthenticationModule コンストラクタ

WindowsAuthenticationModule クラスのインスタンスを作成します。

名前空間: System.Web.Security
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New WindowsAuthenticationModule

C#

public WindowsAuthenticationModule ()

C++

public:
WindowsAuthenticationModule ()

J#

public WindowsAuthenticationModule ()

JScript

public function WindowsAuthenticationModule
 ()

解説

このコンストラクタは、アプリケーション コードから呼び出すためのものではありません。

ASP.NET は、このコンストラクタを呼び出して、WindowsAuthenticationModule クラスのインスタンスを作成します。コンストラクタを呼び出すと、コンストラクタは Init メソッドを呼び出して新しい WindowsAuthenticationModule オブジェクトを初期化します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
WindowsAuthenticationModule クラス
WindowsAuthenticationModule メンバ
System.Web.Security 名前空間
その他の技術情報
Windows 認証プロバイダ

WindowsAuthenticationModule メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Dispose	WindowsAuthenticationModule で使用されていたすべてのリソース (メモリを除く) を解放します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	Init	WindowsAuthenticationModule オブジェクトを初期化します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

WindowsAuthenticationModule クラス
System.Web.Security 名前空間

その他の技術情報

Windows 認証プロバイダ
Global.asax 構文

WindowsAuthenticationModule メンバ

Windows 認証が有効な場合、ASP.NET アプリケーションに対してユーザーの ID を設定します。このクラスは継承できません。

WindowsAuthenticationModule データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	WindowsAuthenticationModule	WindowsAuthenticationModule クラスのインスタンスを作成します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Dispose	WindowsAuthenticationModule で使用されていたすべてのリソース (メモリを除く) を解放します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	Init	WindowsAuthenticationModule オブジェクトを初期化します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

パブリック イベント

	名前	説明
	Authenticate	アプリケーションが現在の要求を認証するときに発生します。

参照

関連項目

WindowsAuthenticationModule クラス
System.Web.Security 名前空間

その他の技術情報

Windows 認証プロバイダ
Global.asax 構文