ClientFormsAuthenticationMembershipProvider クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
クライアント アプリケーション サービスでフォーム認証を有効にします。
public ref class ClientFormsAuthenticationMembershipProvider : System::Web::Security::MembershipProvider
public class ClientFormsAuthenticationMembershipProvider : System.Web.Security.MembershipProvider
type ClientFormsAuthenticationMembershipProvider = class
inherit MembershipProvider
Public Class ClientFormsAuthenticationMembershipProvider
Inherits MembershipProvider
- 継承
例
次のコード例は、このメソッドを使用して、 実装を使用してユーザーを検証する方法を IClientFormsAuthenticationCredentialsProvider 示しています。
private bool ValidateUsingCredentialsProvider()
{
bool isAuthorized = false;
try
{
ClientFormsAuthenticationMembershipProvider authProvider =
System.Web.Security.Membership.Provider as
ClientFormsAuthenticationMembershipProvider;
// Call ValidateUser with empty strings in order to display the
// login dialog box configured as a credentials provider.
isAuthorized = authProvider.ValidateUser(String.Empty, String.Empty);
}
catch (System.Net.WebException)
{
MessageBox.Show("Unable to access the authentication service.",
"Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning);
}
if (!isAuthorized)
{
MessageBox.Show("Unable to authenticate.", "Not logged in",
MessageBoxButtons.OK, MessageBoxIcon.Error);
Application.Exit();
}
return isAuthorized;
}
Private Function ValidateUsingCredentialsProvider() As Boolean
Dim isAuthorized As Boolean = False
Try
Dim authProvider As ClientFormsAuthenticationMembershipProvider = _
CType(System.Web.Security.Membership.Provider, _
ClientFormsAuthenticationMembershipProvider)
' Call ValidateUser with empty strings in order to display the
' login dialog box configured as a credentials provider.
isAuthorized = authProvider.ValidateUser(String.Empty, String.Empty)
Catch ex As System.Net.WebException
MessageBox.Show("Unable to access the authentication service.", _
"Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning)
End Try
If Not isAuthorized Then
MessageBox.Show("Unable to authenticate.", "Not logged in", _
MessageBoxButtons.OK, MessageBoxIcon.Error)
Application.Exit()
End If
Return isAuthorized
End Function
注釈
クライアント アプリケーション サービスを使用して、フォーム認証を使用してユーザーを検証できます。 フォーム認証を有効にするには、 クラスを使用するようにアプリケーションを ClientFormsAuthenticationMembershipProvider 構成します。
構成後は、 メソッドを呼び出してユーザーを static
Membership.ValidateUser 検証できます。このメソッドは、内部的に メソッドを ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String) 呼び出します。
フォーム認証では、ユーザーがアプリケーションによって提供されるログイン コントロールを使用して資格情報を指定する必要があります。 資格情報を取得し、 メソッドに Membership.ValidateUser 渡すことができます。 空の文字列を渡したり、資格情報プロバイダーを使用したり null
することもできます。 資格情報プロバイダーは、 IClientFormsAuthenticationCredentialsProvider アプリケーション構成ファイルで指定された実装です。 通常、 メソッドを IClientFormsAuthenticationCredentialsProvider.GetCredentials 実装してログイン ダイアログ ボックスを表示し、設定された ClientFormsAuthenticationCredentials オブジェクトを返します。 資格情報プロバイダーを使用することにより、複数のアプリケーション間で同じログイン ダイアログ ボックスを共有できます。
メソッドは ClientFormsAuthenticationMembershipProvider.ValidateUser 、 プロパティで示されるログイン サービスを介してユーザーを ServiceUri 認証します。 プロパティの ServiceUri 値は、通常、他の構成値と共にアプリケーション構成ファイルから取得されます。
ユーザーが正常に認証された場合、サービス プロバイダーは、ユーザー情報を static
Thread.CurrentPrincipal 含む新しいオブジェクトを含む新 ClientRolePrincipal しい ClientFormsIdentity オブジェクトに プロパティを設定します。 ClientRoleProviderがアプリケーション用に構成されている場合は、 オブジェクトをClientRolePrincipal使用して、ロール サービスからユーザー ロール情報を取得できます。
プロパティを使用して、現在 ClientFormsAuthenticationMembershipProvider のインスタンスへの参照を static
Membership.Provider 取得できます。 メンバーシップ プロバイダー参照を使用して、 メソッドを ClientFormsAuthenticationMembershipProvider.ValidateUser 直接呼び出すことができます。 さらに、基本クラスでは使用できない メソッドを Logout 呼び出すには、メンバーシップ プロバイダー参照が MembershipProvider 必要です。
クラスを ClientFormsAuthenticationMembershipProvider 使用してメンバーシップ情報を作成、削除、または変更することはできません。 ユーザーを作成、削除、または変更するには、サーバー上のログイン サービスの構成を変更する必要があります。
コンストラクター
ClientFormsAuthenticationMembershipProvider() |
ClientFormsAuthenticationMembershipProvider クラスの新しいインスタンスを初期化します。 |
プロパティ
ApplicationName |
このプロパティは、このクラスでは使用されません。 |
Description |
管理ツールまたは他のユーザー インターフェイス (UI) での表示に適した、簡単でわかりやすい説明を取得します。 (継承元 ProviderBase) |
EnablePasswordReset |
このプロパティは、このクラスでは使用されません。 |
EnablePasswordRetrieval |
このプロパティは、このクラスでは使用されません。 |
MaxInvalidPasswordAttempts |
このプロパティは、このクラスでは使用されません。 |
MinRequiredNonAlphanumericCharacters |
このプロパティは、このクラスでは使用されません。 |
MinRequiredPasswordLength |
このプロパティは、このクラスでは使用されません。 |
Name |
構成時にプロバイダーを参照するために使用される表示名を取得します。 (継承元 ProviderBase) |
PasswordAttemptWindow |
このプロパティは、このクラスでは使用されません。 |
PasswordFormat |
このプロパティは、このクラスでは使用されません。 |
PasswordStrengthRegularExpression |
このプロパティは、このクラスでは使用されません。 |
RequiresQuestionAndAnswer |
このプロパティは、このクラスでは使用されません。 |
RequiresUniqueEmail |
このプロパティは、このクラスでは使用されません。 |
ServiceUri |
認証サービスの URI を取得または設定します。 |
メソッド
イベント
UserValidated |
ユーザーの検証時に発生します。 |
ValidatingPassword |
ユーザーが作成されるとき、パスワードが変更されるとき、またはリセットされるときに発生します。 (継承元 MembershipProvider) |
適用対象
こちらもご覧ください
.NET
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示