ActiveDirectoryMembershipProvider.DeleteUser(String, Boolean) 方法

定義

命名空間:

System.Web.Security

組件:

System.Web.dll

從 Active Directory 資料存放區移除使用者的成員資格資訊。

public:
 override bool DeleteUser(System::String ^ username, bool deleteAllRelatedData);

public override bool DeleteUser (string username, bool deleteAllRelatedData);

override this.DeleteUser : string * bool -> bool

Public Overrides Function DeleteUser (username As String, deleteAllRelatedData As Boolean) As Boolean

參數

username

String

要刪除的使用者名稱。

deleteAllRelatedData

Boolean

DeleteUser(String, Boolean) 方法會忽略這個參數。

傳回

Boolean

如果已刪除使用者則為 true，如果在資料存放區中找不到使用者則為 false。

例外狀況

ArgumentException

username 為空白，或超過使用者名稱的最大長度 (通常是 256 個字元)。

-或-

username 包含逗號。

-或-

使用者名稱會對應到 userPrincipalName 屬性，且 userName 參數會包含反斜線。

ArgumentNullException

username 為 null。

COMException

嘗試刪除使用者時發生錯誤。

InvalidOperationException

DeleteUser(String, Boolean) 方法的呼叫，會在初始化 ActiveDirectoryMembershipProvider 執行個體之前進行。

備註

方法 DeleteUser 會立即移除 參數所 username 識別的使用者。 由於 Active Directory 資料存放區不會將使用者資訊儲存在目錄的個別區域中， deleteAllRelatedData 因此會忽略 參數，不過它必須設定為 true 或 false 呼叫 方法時 DeleteUser 。

類別 ActiveDirectoryMembershipProvider 會藉由對連接字串所決定之使用者容器中的使用者名稱執行單一層級搜尋，以尋找要刪除的用戶實例。 ActiveDirectoryMembershipProvider如需連接字串的詳細資訊，請參閱 類別主題。

username 必須是64個字元或更少。

重要

除非用來連線到 Active Directory 伺服器的認證具有[網域系統管理員] 權限，否則您無法刪除使用者 (不建議) 或「刪除子實例」訪問許可權。

另請參閱

• ASP.NET 成員資格簡介