ActiveDirectoryMembershipProvider.Initialize 方法

定義

命名空間:

System.Web.Security

組件:

System.Web.dll

使用應用程式組態檔中的屬性值，初始化 ActiveDirectoryMembershipProvider 執行個體。 這個方法並不適合從您的程式碼呼叫。

public:
 override void Initialize(System::String ^ name, System::Collections::Specialized::NameValueCollection ^ config);

public override void Initialize (string name, System.Collections.Specialized.NameValueCollection config);

override this.Initialize : string * System.Collections.Specialized.NameValueCollection -> unit

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

參數

name

String

要初始化的 ActiveDirectoryMembershipProvider 執行個體之名稱。

config

NameValueCollection

NameValueCollection，包含成員資格提供者之組態選項的名稱和值。

例外狀況

ArgumentNullException

config 為 null。

ProviderException

應用程式組態中指定的 applicationName 屬性超過 256 個字元。

-或-

connectionStringName 屬性是空的，或不在應用程式組態中。

-或-

應用程式組態檔中 connectionStringName 屬性所指定的連接字串是空的或不存在。

-或-

在應用程式組態檔中將 connectionProtection 屬性設為 SignAndSeal 或 None 以外的值。

-或-

在應用程式組態檔中指定了 connectionUsername 屬性，但其值是空的。

-或-

在應用程式組態檔中指定了 connectionPassword 屬性，但其值是空的。

-或-

在應用程式組態檔中指定了 connectionUsername 屬性或 connectionPassword 屬性，但未同時指定兩者。

-或-

指定了 clientSearchTimeout 屬性，但是並非正整數。

-或-

指定了 serverSearchTimeout 屬性，但是並非正整數。

-或-

指定了 enableSearchMethods 屬性，但是並非布林值。

-或-

指定了 requiresUniqueEmail 屬性，但是並非布林值。

-或-

指定了 enablePasswordReset 屬性，但是並非布林值。

-或-

指定了 requiresQuestionAndAnswer 屬性，但是並非布林值。

-或-

指定了 minRequiredPasswordLength 屬性，但它是負數或大於 128。

-或-

指定了 minRequiredNonalphanumericCharacters 屬性，但它是負數或大於 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 屬性指定的容器不允許包含使用者執行個體。

指定了屬性對應，但其值是空的。

-或-

兩次指定了屬性對應。

-或-

指定了屬性對應，但該屬性在使用者執行個體上不存在。

-或-

指定了屬性對應，但目錄屬性的資料型別不正確。

-或-

指定了屬性對應，但目錄屬性有多個值。

-或-

已 attributeMapUserName 指定 屬性， sAMAccountName 但在連接到 Active Directory 時，未對應至 或 userPrincipalName 目錄屬性。

-或-

指定屬性 attributeMapUserName ， userPrincipalName 但在連接到 ADAM 伺服器時未對應至目錄屬性。

-或-

應用程式組態檔中的 enablePasswordReset 屬性為 true，而 requiresQuestionAndAnswer 屬性為 false。

-或-

指定了 maxInvalidPasswordAttempts 屬性，但不是非零的正整數。

-或-

指定了 passwordAttemptWindow 屬性，但不是非零的正整數。

-或-

指定了 passwordAnswerAttemptLockoutDuration 屬性，但不是非零的正整數。

-或-

enablePasswordReset 屬性為 true，且 attributeMapFailedPasswordAnswerCount、attributeMapFailedPasswordAnswerTime 和 attributeMapFailedPasswordAnswerLockoutTime 中的任何一個屬性是空的。

-或-

requiresQuestionAndAnswer 屬性為 true，但 attributeMapPasswordQuestion 或 attributeMapPasswordAnswer 屬性是空的。

-或-

在應用程式組態檔中指定的屬性無效。

HttpException

應用程式正在裝載環境中執行，且 AspNetHostingPermissionLevel 設為 Minimal。

COMException

查詢目錄時發生錯誤。

備註

這個方法會 ActiveDirectoryMembershipProvider 使用 ASP.NET 應用程式組態檔中指定的屬性值來初始化 物件 (Web.config) ，而且不適合直接從程式代碼使用。

另請參閱

• ASP.NET 成員資格簡介