ActiveDirectoryMembershipProvider.Initialize メソッド

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

ActiveDirectoryMembershipProvider.Initialize メソッド

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

アプリケーションの構成ファイルのプロパティ値を使用して、ActiveDirectoryMembershipProvider インスタンスを初期化します。このメソッドは、コードから呼び出すためのものではありません。

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

Visual Basic (宣言)

Public Overrides Sub Initialize
 ( _
    name As String, _
    config As NameValueCollection _
)

Visual Basic (使用法)

Dim instance As ActiveDirectoryMembershipProvider
Dim name As String
Dim config As NameValueCollection

instance.Initialize(name, config)

C#

public override void Initialize (
    string name,
    NameValueCollection config
)

C++

public:
virtual void Initialize (
    String^ name, 
    NameValueCollection^ config
) override

J#

public void Initialize (
    String name, 
    NameValueCollection config
)

JScript

public override function Initialize (
    name : String, 
    config : NameValueCollection
)

パラメータ

name

初期化する ActiveDirectoryMembershipProvider インスタンスの名前。

config

メンバシップ プロバイダの構成オプションの名前と値を含む NameValueCollection。

例外

例外の種類	条件
ArgumentNullException	config が null 参照 (Visual Basic では Nothing) です。
ProviderException	アプリケーションの構成で指定された applicationName 属性が 256 文字を超えています。 または アプリケーション構成ファイルで、connectionStringName 属性が空か、存在していません。 または アプリケーションの構成ファイルで connectionStringName 属性に指定した接続文字列が空か、または存在しません。 または アプリケーションの構成ファイルで connectionProtection 属性が SignAndSeal でも None でもない値に設定されています。 または アプリケーションの構成ファイルで connectionUsername 属性が指定されてますが、値が空です。 または アプリケーションの構成ファイルで connectionPassword 属性が指定されてますが、値が空です。 または アプリケーションの構成ファイルで connectionUsername 属性と connectionPassword 属性のどちらか一方のみが指定されています。 または clientSearchTimeout 属性が指定されていますが、正の整数ではありません。 または serverSearchTimeout 属性が指定されていますが、正の整数ではありません。 または enableSearchMethods 属性が指定されていますが、ブール値ではありません。 または requiresUniqueEmail 属性が指定されていますが、ブール値ではありません。 または enablePasswordReset 属性が指定されていますが、ブール値ではありません。 または requiresQuestionAndAnswer 属性が指定されていますが、ブール値ではありません。 または minRequiredPasswordLength 属性が指定されてますが、負の値であるか、128 を超えています。 または minRequiredNoalphanumericCharacters 属性が指定されてますが、負の値であるか、128 を超えています。 または アプリケーションの構成ファイルで passwordStrengthRegularExpression 属性に指定された正規表現が有効な正規表現ではありません。 または attributeMapUsername 属性が指定されていますが、空の文字列です。 または connectionString 属性が "LDAP" で始まっていません。 または connectionString 属性で指定された接続文字列が無効です。 または connectionString 属性の接続文字列でサーバーを使用しないバインドが指定されています。 または ActiveDirectoryMembershipProvider はドメインまたはディレクトリ サーバーとの接続を確立できませんでした。 または connectionProtection 属性が SignAndSeal に設定されていますが、サーバーとの SSL 接続も署名とシールを使用する接続も確立できません。 または connectionProtection 属性は None に設定されていますが、connectionUsername 属性と connectionPassword 属性が設定されていません。 または connectionProtection 属性は SignAndSeal に設定されていますが、ActiveDirectoryMembershipProvider は ADAM サーバーとの SSL 接続を確立できませんでした。 または connectionString 属性にグローバル カタログ (GC) ポートまたは SSL グローバル カタログ ポートが指定されています。 または connectionString 属性に Active Directory サーバーまたはドメインが指定されていますが、ActiveDirectoryMembershipProvider はドメインの既定の名前付けコンテキストを取得できませんでした。 または connectionString 属性に Active Directory サーバーまたはドメインが指定されていますが、ActiveDirectoryMembershipProvider は既定のユーザー コンテナを取得できませんでした。 または connectionString 属性に ADAM サーバーが指定されていますが、アプリケーション パーティション (コンテナ) が指定されていません。 または connectionString 属性にアプリケーション パーティション (コンテナ) が指定されていますが、指定されたコンテナが存在しません。 または connectionString 属性に、ユーザー インスタンスの格納を許可されていないコンテナが指定されています。 属性のマップが指定されていますが、値が空でした。 または 属性のマップが 2 回指定されています。 または 属性のマップが指定されていますが、この属性はユーザー インスタンスに存在しません。 または 属性のマップは指定されていますが、ディレクトリ属性のデータ型が正しくありません。 または 属性のマップが指定されていますが、このディレクトリ属性は複数の値を持つ属性です。 または attributeMapUserName 属性が指定されていますが、Active Directory への接続時に sAMAccountName ディレクトリ属性にも userPrincipalName ディレクトリ属性にもマップされていませんでした。 または attributeMapUserName 属性が指定されていますが、ADAM サーバーへの接続時に userPrincipalName ディレクトリ属性にマップされていませんでした。 または アプリケーションの構成ファイルで enablePasswordReset 属性が true に設定され、requiresQuestionAndAnswer 属性が false に設定されています。 または maxInvalidPasswordAttempts 属性が指定されていましたが、ゼロ以外の正の整数ではありません。 または passwordAttemptWindow 属性が指定されていましたが、ゼロ以外の正の整数ではありません。 または passwordAnswerAttemptLockoutDuration 属性が指定されていましたが、ゼロ以外の正の整数ではありません。 または enablePasswordReset 属性は true ですが、attributeMapFailedPasswordAnswerCount、attributeMapFailedPasswordAnswerTime、および attributeMapFailedPasswordAnswerLockoutTime の各属性のいずれかが空です。 または requiresQuestionAndAnswer 属性は true ですが、attributeMapPasswordQuestion 属性または attributeMapPasswordAnswer 属性が空です。 または アプリケーションの構成ファイルに無効な属性が指定されています。
HttpException	アプリケーションはホスト環境で実行中ですが、AspNetHostingPermissionLevel が Minimal に設定されています。
COMException	ディレクトリのクエリ中にエラーが発生しました。

解説

このメソッドは、ASP.NET アプリケーションの構成ファイル (Web.config) に指定されているプロパティ値を使用して ActiveDirectoryMembershipProvider オブジェクトを初期化します。このメソッドは、コードで直接使用するためのものではありません。

プラットフォーム

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

参照

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