MembershipProvider.GetPassword メソッド

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

MembershipProvider.GetPassword メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定したメンバシップ ユーザーのパスワードをデータ ソースから取得します。

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

Visual Basic (宣言)

Public MustOverride Function
 GetPassword ( _
    username As String, _
    answer As String _
) As String

Visual Basic (使用法)

Dim instance As MembershipProvider
Dim username As String
Dim answer As String
Dim returnValue As String

returnValue = instance.GetPassword(username, answer)

C#

public abstract string GetPassword (
    string username,
    string answer
)

C++

public:
virtual String^ GetPassword (
    String^ username, 
    String^ answer
) abstract

J#

public abstract String GetPassword (
    String username, 
    String answer
)

JScript

public abstract function GetPassword (
    username : String, 
    answer : String
) : String

パラメータ

username

パスワードを取得するユーザー。

answer

ユーザーのパスワードの解答。

戻り値
指定したユーザー名のパスワード。

解説

ユーザー名とパスワードの解答を入力値として受け取り、データ ソースからそのユーザーのパスワードを取得し、そのパスワードを文字列として返します。

GetPassword メソッドは、まず EnablePasswordRetrieval フラグが true であることを確認します。EnablePasswordRetrieval が false の場合、NotSupportedException 例外がスローされます。

GetPassword は、RequiresQuestionAndAnswer プロパティの値もチェックします。RequiresQuestionAndAnswer が true の場合、GetPassword は、データ ソースに格納されているパスワードの解答と、入力された解答パラメータ値を比較します。これらが一致しない場合、MembershipPasswordException 例外がスローされます。

カスタム メンバシップ プロバイダがハッシュされたパスワードをサポートしていて、EnablePasswordRetrieval プロパティが true に設定され、パスワードの形式が Hashed に設定されている場合、GetPassword メソッドは例外を返します。ハッシュされたパスワードは取得できません。

使用例

MembershipProvider 実装の例については、「プロファイル プロバイダの実装」を参照してください。

プラットフォーム

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

参照

関連項目
MembershipProvider クラス
MembershipProvider メンバ
System.Web.Security 名前空間
その他の技術情報
メンバシップ プロバイダの実装
メンバシップの概要