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因此参数将被忽略，尽管在调用 DeleteUser 方法时必须将其设置为 true 或 false 。

类 ActiveDirectoryMembershipProvider 通过在连接字符串确定的用户容器中执行单级搜索来查找要删除的用户实例。 有关连接字符串的详细信息， ActiveDirectoryMembershipProvider 请参阅类主题。

username 必须为 64 个字符或更少。

重要

除非用于连接到 Active Directory 服务器的凭据具有域管理员权限 (不建议) 或“删除子实例”访问权限，否则无法删除用户。

另请参阅

• ASP.NET 成员资格简介