SqlMembershipProvider.DeleteUser(String, Boolean) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Удаляет информацию членства пользователя из базы данных членства SQL Server.
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
Значение true для удаления данных, связанных с пользователем, из базы данных; значение false для сохранения данных, связанных с пользователем, в базе данных.
Возвращаемое значение
Значение true, если пользователь был удален; в противном случае — false. Значение false также возвращается, если пользователь не существует в базе данных.
Исключения
Параметр username равен пустой строке (""), содержит запятую или длиннее 256 символов.
username имеет значение null.
Примеры
В следующем примере кода удаляется текущий пользователь, выполнивший вход.
Примечание
В этом примере используется SqlMembershipProvider для вызова указанного SqlMembershipProvider объекта в defaultProvider качестве в файле Web.config. Если необходимо получить доступ к поставщику по умолчанию в качестве типа SqlMembershipProvider, можно привести Provider свойство Membership класса . Чтобы получить доступ к другим настроенным поставщикам в качестве определенного типа поставщика, можно получить к ним доступ по их настроенной имени со Providers свойством Membership класса и привести их к определенному типу поставщика.
<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Security" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
public void YesButton_OnClick(object sender, EventArgs args)
{
Membership.DeleteUser(User.Identity.Name, DeleteRelatedData.Checked);
FormsAuthentication.SignOut();
FormsAuthentication.RedirectToLoginPage();
}
public void CancelButton_OnClick(object sender, EventArgs args)
{
Response.Redirect("default.aspx");
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Sample: Delete User</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Delete User</h3>
<asp:Label id="Msg" ForeColor="maroon" runat="server" /><br />
<span style="color:red">Are you sure you want to delete the userid <b><%=User.Identity.Name%></b>?</span><br />
Delete related profile and roles data: <asp:CheckBox id="DeleteRelatedData"
checked="True" runat="Server" /><br />
<asp:Button id="YesButton" Text="Yes" OnClick="YesButton_OnClick" runat="server" />
<asp:Button id="CancelButton" Text="Cancel" OnClick="CancelButton_OnClick" runat="server" />
</form>
</body>
</html>
<%@ Page Language="VB" %>
<%@ Import Namespace="System.Web.Security" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Public Sub YesButton_OnClick(ByVal sender As Object, ByVal args As EventArgs)
Membership.DeleteUser(User.Identity.Name, DeleteRelatedData.Checked)
FormsAuthentication.SignOut()
FormsAuthentication.RedirectToLoginPage()
End Sub
Public Sub CancelButton_OnClick(ByVal sender As Object, ByVal args As EventArgs)
Response.Redirect("default.aspx")
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Sample: Delete User</title>
</head>
<body>
<form id="form1" runat="server">
<h3>
Delete User</h3>
<asp:Label ID="Msg" ForeColor="maroon" runat="server" /><br />
<p style="color:red">Are you sure you want to delete the userid <b><%=User.Identity.Name%></b>?</p>
<br />
Delete related profile and roles data:
<asp:CheckBox ID="DeleteRelatedData" Checked="True" runat="Server" /><br />
<asp:Button ID="YesButton" Text="Yes" OnClick="YesButton_OnClick" runat="server" />
<asp:Button ID="CancelButton" Text="Cancel" OnClick="CancelButton_OnClick" runat="server" />
</form>
</body>
</html>
Комментарии
Этот метод вызывается классом Membership для удаления пользователя из базы данных SQL Server, указанной в файле конфигурации приложения ASP.NET.
Удаленные пользователи удаляются только из настроенного ApplicationName.
Если deleteAllRelatedData задано значение true, то все пользовательские данные, хранящиеся в базе данных для Rolesфункций персонализации , или WebPart , Profileтакже удаляются для настроенного ApplicationName.
Если пользователь членства не существует в базе данных и deleteAllRelatedData имеет значение true, связанные данные и сведения о пользователе, хранящиеся для Rolesфункций персонализации , или WebPart , Profileбудут по-прежнему удалены для приложения, указанного в свойстве ApplicationName . В результате DeleteUser метод можно использовать для быстрого удаления сведений, связанных с пользователем, даже если SqlMembershipProvider объект не используется для хранения сведений о пользователе, прошедших проверку подлинности.
Начальные и конечные пробелы удаляются из значения параметра username.