FormsAuthenticationEventArgsとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

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

索引トップ用語の索引ランキング

FormsAuthenticationEventArgs クラス

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

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

Visual Basic (宣言)

Public NotInheritable Class
 FormsAuthenticationEventArgs
    Inherits EventArgs

Visual Basic (使用法)

Dim instance As FormsAuthenticationEventArgs

public sealed class FormsAuthenticationEventArgs
 : EventArgs

C++

public ref class FormsAuthenticationEventArgs
 sealed : public EventArgs

public final class FormsAuthenticationEventArgs
 extends EventArgs

JScript

public final class FormsAuthenticationEventArgs
 extends EventArgs

解説

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

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

User プロパティを使用して、現在の HttpContext の User プロパティを、カスタムの IPrincipal オブジェクトに設定できます。

FormsAuthentication_OnAuthenticate イベント中に User プロパティ値を指定しない場合、フォーム認証チケットによって提供される Cookie または URL 内の ID が使用されます。

FormsAuthentication_OnAuthenticate イベントは、認証の Mode が Forms に設定され、FormsAuthenticationModule がアプリケーションのアクティブ HTTP モジュールである場合にのみ生成されます。

使用例

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

Visual Basic

Public Sub FormsAuthentication_OnAuthenticate(sender
 As Object, _
                                              args As FormsAuthenticationEventArgs)
  If FormsAuthentication.CookiesSupported Then
    If Not Request.Cookies(FormsAuthentication.FormsCookieName)
 Is Nothing Then
      Try
        Dim ticket As FormsAuthenticationTicket
 = FormsAuthentication.Decrypt( _
          Request.Cookies(FormsAuthentication.FormsCookieName).Value)
        
        args.User = New System.Security.Principal.GenericPrincipal(
 _
          New Samples.AspNet.Security.MyFormsIdentity(ticket),
 _
          New String(0) {})
      Catch e As HttpException
        ' Decrypt method failed.
      End Try
    End If
  Else
      Throw New Exception("Cookieless
 Forms Authentication is not " & _
                            "supported for this application.")
  End If
End Sub

public void FormsAuthentication_OnAuthenticate(object
 sender, FormsAuthenticationEventArgs args)
{
  if (FormsAuthentication.CookiesSupported)
  {
    if (Request.Cookies[FormsAuthentication.FormsCookieName] !=
 null)
    {
      try
      {
        FormsAuthenticationTicket ticket = FormsAuthentication.Decrypt(
          Request.Cookies[FormsAuthentication.FormsCookieName].Value);
        
        args.User = new System.Security.Principal.GenericPrincipal(
          new Samples.AspNet.Security.MyFormsIdentity(ticket)
,
          new string[0]);
      }
      catch (Exception e)
      {
        // Decrypt method failed.
      }
    }
  }
  else
  {
    throw new HttpException("Cookieless Forms Authentication
 is not " +
                            "supported for this
 application.");
  }
}

.NET Framework のセキュリティ

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

継承階層

System.Object
System.EventArgs
System.Web.Security.FormsAuthenticationEventArgs

スレッドセーフ

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

参照

関連項目
FormsAuthenticationEventArgs メンバ
System.Web.Security 名前空間
その他の技術情報
フォーム認証プロバイダ

FormsAuthenticationEventArgs コンストラクタ

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

名前空間: 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 FormsAuthenticationEventArgs(context)

public FormsAuthenticationEventArgs (
    HttpContext context
)

C++

public:
FormsAuthenticationEventArgs (
    HttpContext^ context
)

public FormsAuthenticationEventArgs (
    HttpContext context
)

JScript

public function FormsAuthenticationEventArgs
 (
    context : HttpContext
)

パラメータ

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

解説

FormsAuthenticationModule は、Context プロパティ値として提供される context を使用して FormsAuthenticationEventArgs オブジェクトを構築します。そして、FormsAuthenticationEventArgs オブジェクトを FormsAuthentication_OnAuthenticate イベントに渡します。

プラットフォーム

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
サポート対象 : 2.0、1.1、1.0

参照

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

FormsAuthenticationEventArgs プロパティ

パブリックプロパティパブリックプロパティ

	名前	説明
	Context	現在の HTTP 要求に対する HttpContext オブジェクトを取得します。
	User	現在の要求に関連付ける IPrincipal オブジェクトを取得または設定します。

参照

その他の技術情報

フォーム認証プロバイダ

FormsAuthenticationEventArgs メソッド

パブリックメソッドパブリックメソッド

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

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

プロテクトメソッド

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

参照

その他の技術情報

フォーム認証プロバイダ

FormsAuthenticationEventArgs メンバ

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

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

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

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

パブリックプロパティ

	名前	説明
	Context	現在の HTTP 要求に対する HttpContext オブジェクトを取得します。
	User	現在の要求に関連付ける IPrincipal オブジェクトを取得または設定します。

パブリックメソッド

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

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

プロテクトメソッド

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

参照

その他の技術情報

フォーム認証プロバイダ

このページでは「.NET Framework クラスライブラリリファレンス」からFormsAuthenticationEventArgsを検索した結果を表示しています。
Weblioに収録されているすべての辞書からFormsAuthenticationEventArgsを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からFormsAuthenticationEventArgs を検索

>> 「FormsAuthenticationEventArgs」を含む用語の索引
FormsAuthenticationEventArgsのページへのリンク

FormsAuthenticationEventArgsとは？わかりやすく解説

FormsAuthenticationEventArgs クラス

FormsAuthenticationEventArgs コンストラクタ

FormsAuthenticationEventArgs プロパティ

関連項目

その他の技術情報

FormsAuthenticationEventArgs メソッド

関連項目

その他の技術情報

FormsAuthenticationEventArgs メンバ

関連項目

その他の技術情報

「FormsAuthenticationEventArgs」の関連用語


	© 2025 Microsoft.All rights reserved.

FormsAuthenticationEventArgsとは？ わかりやすく解説

FormsAuthenticationEventArgs クラス

FormsAuthenticationEventArgs コンストラクタ

FormsAuthenticationEventArgs プロパティ

関連項目

その他の技術情報

FormsAuthenticationEventArgs メソッド

関連項目

その他の技術情報

FormsAuthenticationEventArgs メンバ

関連項目

その他の技術情報

急上昇のことば

「FormsAuthenticationEventArgs」の関連用語

FormsAuthenticationEventArgsとは？わかりやすく解説