AuthenticatingEventArgs AuthenticatingEventArgs AuthenticatingEventArgs AuthenticatingEventArgs Class

定義

Authenticating イベントのデータを提供します。Provides data for the Authenticating event.

public ref class AuthenticatingEventArgs : EventArgs
public class AuthenticatingEventArgs : EventArgs
type AuthenticatingEventArgs = class
    inherit EventArgs
Public Class AuthenticatingEventArgs
Inherits EventArgs
継承
AuthenticatingEventArgsAuthenticatingEventArgsAuthenticatingEventArgsAuthenticatingEventArgs

次の例では、渡されるイベント ハンドラー、UserNamePasswordユーザーの資格情報を検証するカスタム メンバーシップ プロバイダーの値。The following example shows an event handler that passes the UserName and Password values to a custom membership provider to validate the user credentials. イベント ハンドラーに設定Authenticatedの戻り値をValidateUserメソッドとセットAuthenticationIsCompletetrueように、AuthenticationServiceクラスは、資格情報は検証されません。The event handler sets Authenticated to the return value of the ValidateUser method and sets AuthenticationIsComplete to true so that the AuthenticationService class does not validate the credentials.

void AuthenticationService_Authenticating(object sender, System.Web.ApplicationServices.AuthenticatingEventArgs e)
{
    if (e.UserName.IndexOf("@contoso.com") >= 0)
    {
        e.Authenticated = Membership.Providers["ContosoSqlProvider"].ValidateUser(e.UserName, e.Password);
    }
    else if (e.UserName.IndexOf("@fabrikam.com") >= 0)
    {
        e.Authenticated = Membership.Providers["FabrikamSqlProvider"].ValidateUser(e.UserName, e.Password);
    }
    else
    {
        e.Authenticated = Membership.Provider.ValidateUser(e.UserName, e.Password);
    }
    e.AuthenticationIsComplete = true;
}
Sub AuthenticationService_Authenticating _
   (ByVal sender As Object, _
    ByVal e As System.Web.ApplicationServices.AuthenticatingEventArgs)
    
    If (e.Username.IndexOf("@contoso.com") >= 0) Then
        e.Authenticated = Membership.Providers("ContosoSqlProvider").ValidateUser(e.Username, e.Password)
    ElseIf (e.Username.IndexOf("@fabrikam.com") >= 0) Then
        e.Authenticated = Membership.Providers("FabrikamSqlProvider").ValidateUser(e.Username, e.Password)
    Else
        e.Authenticated = Membership.Provider.ValidateUser(e.Username, e.Password)
    End If
    e.AuthenticationIsComplete = True
End Sub

注釈

ハンドラーを作成する、Authenticating実行時にユーザーの資格情報を認証する方法をカスタマイズするときにイベント。You create a handler for the Authenticating event when you want to customize how the user's credentials are authenticated at run time. AuthenticatingEventArgsクラスは、いずれかに値を提供Authenticatingイベント ハンドラー。The AuthenticatingEventArgs class supplies values to any Authenticating event handler. このクラスで使用できるプロパティを使用すると、承認をカスタマイズするユーザーの資格情報を取得できます。By using the properties available in this class, you can retrieve the user credentials to customize authentication.

AuthenticationServiceクラスが生成、Authenticatingユーザーの資格情報を検証する前にイベント。The AuthenticationService class raises the Authenticating event before validating the user credentials. AuthenticationServiceクラスのインスタンスを構築、AuthenticatingEventArgsオブジェクトをいずれかに渡しますAuthenticatingイベント ハンドラー。The AuthenticationService class constructs an instance of the AuthenticatingEventArgs object and passes it to any Authenticating event handler.

使用することができます、 UserNamePasswordCustomCredentialユーザーの資格情報を取得するプロパティ。You can use the UserName, Password and CustomCredential properties to retrieve the user credentials. CustomCredentialプロパティは、id 番号などの認証を必要とされる追加の値を含めることができます。The CustomCredential property can contain additional values that are required for authentication, such as an identification number.

Authenticatedプロパティでは、ユーザーの資格情報が有効かどうかを示します。The Authenticated property indicates whether the user credentials are valid. 設定する、Authenticatedプロパティをカスタマイズされた認証の結果。You set the Authenticated property to the result of your customized authentication. さらに、設定、AuthenticationIsCompleteプロパティをtrueがユーザーの資格情報をチェックし、たくないかどうか、AuthenticationServiceクラスを既定のメンバーシップ プロバイダーからユーザー資格情報を確認します。In addition, you set the AuthenticationIsComplete property to true if you have checked the user credentials and do not want the AuthenticationService class to check user credentials through the default membership provider.

プロパティ

Authenticated Authenticated Authenticated Authenticated

ユーザーの資格情報が有効かどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the user credentials are valid.

AuthenticationIsComplete AuthenticationIsComplete AuthenticationIsComplete AuthenticationIsComplete

ユーザーの資格情報が認証されているかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the user credentials have been authenticated.

CustomCredential CustomCredential CustomCredential CustomCredential

ユーザーの認証に使用される追加の値を取得します。Gets additional user values for authentication.

Password Password Password Password

ユーザーのパスワードを取得します。Gets the password for the user.

UserName UserName UserName UserName

ユーザーの認証名を取得します。Gets the authentication name for the user.

メソッド

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

適用対象

こちらもご覧ください