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 для вызова указанного defaultProvider
SqlMembershipProvider в файле 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
, то все пользовательские данные, хранящиеся в базе данных для RolesProfileкомпонентов персонализации, WebPart также удаляются для настроенныхApplicationName.
Если пользователь членства не существует в базе данных и deleteAllRelatedData
содержит данные, связанные данные и сведения о пользователе, хранящиеся RolesProfileдля функций персонализации, WebPart по-прежнему будут удалены для приложения, указанного в свойстве ApplicationName true
. В результате DeleteUser метод можно использовать для быстрого удаления сведений, связанных с пользователем, даже если SqlMembershipProvider объект не используется для хранения данных пользователя, прошедших проверку подлинности.
Начальные и конечные пробелы удаляются из значения параметра username
.