WindowsAuthenticationModule.Authenticate イベント
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
アプリケーションが現在の要求を認証するときに発生します。
public:
event System::Web::Security::WindowsAuthenticationEventHandler ^ Authenticate;public event System.Web.Security.WindowsAuthenticationEventHandler Authenticate;member this.Authenticate : System.Web.Security.WindowsAuthenticationEventHandler Public Custom Event Authenticate As WindowsAuthenticationEventHandler イベントの種類
例
次のコード例では、WindowsAuthentication_OnAuthenticate イベントを使用して、現在HttpContextの の プロパティをカスタム IPrincipal オブジェクトに設定Userします。
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
注釈
イベントは Authenticate 、イベント中に発生します AuthenticateRequest 。
クラスの イベントに Authenticate アクセスするには、ASP.NET アプリケーションの WindowsAuthenticationModule Global.asax ファイルで WindowsAuthentication_OnAuthenticate という名前のサブルーチンを指定します。
WindowsAuthentication_OnAuthenticate イベントにUser指定された オブジェクトの WindowsAuthenticationEventArgs プロパティを使用して、現在HttpContextの のプロパティをカスタム IPrincipal オブジェクトに設定Userできます。 WindowsAuthentication_OnAuthenticate イベント中に プロパティのUser値を指定しない場合、IIS によって提供される Windows ID が現在の要求の ID として使用されます。 IIS が匿名認証を使用する Identity 場合、 プロパティは メソッドによって GetAnonymous 返される ID に設定されます。
WindowsAuthentication_OnAuthenticate イベントは、認証Modeが にWindows設定されていてWindowsAuthenticationModule、 がアプリケーションのアクティブな HTTP モジュールである場合にのみ発生します。
注意
統合モードで実行されている IIS 7.0 では、AuthenticateASP.NET WindowsAuthenticationModule と IIS AnonymousAuthenticationModule モジュールのWindowsAuthenticationModule両方が有効になっている場合、 のイベントは発生しません。 このシナリオでは、認証通知を受信するには、 インスタンスの AuthenticateRequest イベントを HttpApplication サブスクライブします。 統合モードでの互換性の問題の詳細については、「 ASP.NET アプリケーションを IIS 6.0 から IIS 7.0 に移動する」を参照してください。
適用対象
こちらもご覧ください
.NET