DefaultAuthenticationEventArgs

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

DefaultAuthenticationEventArgs クラス

DefaultAuthentication_OnAuthenticate イベントのデータを提供します。このクラスは継承できません。

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

Visual Basic (宣言)

Public NotInheritable Class
 DefaultAuthenticationEventArgs
    Inherits EventArgs

Visual Basic (使用法)

Dim instance As DefaultAuthenticationEventArgs

C#

public sealed class DefaultAuthenticationEventArgs
 : EventArgs

C++

public ref class DefaultAuthenticationEventArgs
 sealed : public EventArgs

J#

public final class DefaultAuthenticationEventArgs
 extends EventArgs

JScript

public final class DefaultAuthenticationEventArgs
 extends EventArgs

解説

DefaultAuthenticationEventArgs クラスは DefaultAuthentication_OnAuthenticate イベントにイベント値を指定し、現在の要求に対するカスタムの Windows ID を指定できるようにするために使用されます。

DefaultAuthenticationModule は、現在の HttpContext を使用して DefaultAuthenticationEventArgs オブジェクトを生成し、それを DefaultAuthentication_OnAuthenticate イベントに渡します。

継承階層

System.Object
   System.EventArgs
    System.Web.Security.DefaultAuthenticationEventArgs

スレッド セーフ

この型の 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

参照

関連項目
DefaultAuthenticationEventArgs メンバ
System.Web.Security 名前空間
その他の技術情報
ASP.NET の認証

DefaultAuthenticationEventArgs コンストラクタ

DefaultAuthenticationEventArgs クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    context As HttpContext _
)

Visual Basic (使用法)

Dim context As HttpContext

Dim instance As New DefaultAuthenticationEventArgs(context)

C#

public DefaultAuthenticationEventArgs (
    HttpContext context
)

C++

public:
DefaultAuthenticationEventArgs (
    HttpContext^ context
)

J#

public DefaultAuthenticationEventArgs (
    HttpContext context
)

JScript

public function DefaultAuthenticationEventArgs
 (
    context : HttpContext
)

パラメータ

context

イベントのコンテキスト。

解説

DefaultAuthenticationModule オブジェクトは、現在の HttpContext を使用して DefaultAuthenticationEventArgs オブジェクトを生成し、それを DefaultAuthentication_OnAuthenticate イベントに渡します。

DefaultAuthentication_OnAuthenticate イベントに渡した DefaultAuthenticationEventArgs オブジェクトの Context プロパティを使用して、現在の HttpContext の User プロパティを、カスタムの IPrincipal オブジェクトに設定できます。Context プロパティによって参照される HttpContext の User プロパティに値を指定しない場合、DefaultAuthenticationModule は、HttpContext の User プロパティに、ユーザー情報が含まれない GenericPrincipal オブジェクトを設定します。

DefaultAuthentication_OnAuthenticate イベントは、AuthenticateRequest イベントドが呼び出されてから AuthorizeRequest イベントが呼び出されるまでの間に呼び出されます。authorization セクションにより、アプリケーションへのアクセスの許可または拒否をユーザー名に依存している場合、現在の HttpContext の User プロパティを変更することによりアプリケーションの動作に影響を与えることがあります。構成ファイルの authorization セクションを指定するときには、必ず、DefaultAuthentication_OnAuthenticate イベントで設定されるユーザー名を考慮するようにしてください。

使用例

DefaultAuthentication_OnAuthenticate イベントを使用して、現在の HttpContext の User プロパティが null 参照 (Visual Basic では Nothing) かどうかをテストするコード例を次に示します。このプロパティが null 参照 (Visual Basic では Nothing) の場合、コード例では、現在の HttpContext の User プロパティに GenericPrincipal オブジェクトが設定され、このとき、GenericPrincipal オブジェクトの Identity は Name プロパティ値が "default" の GenericIdentity オブジェクトになります。

メモ
DefaultAuthentication_OnAuthenticate イベントは、AuthorizeRequest イベントの前に発生します。結果、現在の HttpContext の User プロパティにカスタム ID を設定すると、アプリケーションの動作に影響を与える場合があります。たとえば、FormsAuthentication クラスを使用して、認証されたユーザーしかサイトにアクセスできないように authorization セクションに <deny users="?" /> と指定している場合、ユーザーは "default" という名前を持つため、このコード例では deny 要素が無視されます。この場合、<deny users="default" /> と指定すると、認証されたユーザーのみがサイトにアクセスできるようになります。

Visual Basic

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

C#

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]);
}

プラットフォーム

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

参照

関連項目
DefaultAuthenticationEventArgs クラス
DefaultAuthenticationEventArgs メンバ
System.Web.Security 名前空間
その他の技術情報
ASP.NET の認証

DefaultAuthenticationEventArgs プロパティ

パブリック プロパティ

	名前	説明
	Context	現在の HTTP 要求に対する HttpContext オブジェクトを取得します。

参照

関連項目

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

その他の技術情報

ASP.NET の認証

DefaultAuthenticationEventArgs メソッド

パブリック メソッド

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

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

プロテクト メソッド

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

参照

関連項目

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

その他の技術情報

ASP.NET の認証

DefaultAuthenticationEventArgs メンバ

DefaultAuthentication_OnAuthenticate イベントのデータを提供します。このクラスは継承できません。

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

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

	名前	説明
	DefaultAuthenticationEventArgs	DefaultAuthenticationEventArgs クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	Context	現在の HTTP 要求に対する HttpContext オブジェクトを取得します。

パブリック メソッド

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

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

プロテクト メソッド

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

参照

関連項目

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

その他の技術情報

ASP.NET の認証