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
.