SqlMembershipProvider.DeleteUser(String, Boolean) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Quita la información de pertenencia de un usuario de la base de datos de pertenencia de 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
Parámetros
- username
- String
Nombre del usuario que se eliminará.
- deleteAllRelatedData
- Boolean
true
para eliminar los datos relacionados con el usuario de la base de datos; false
para mantener los datos relacionados con el usuario en la base de datos.
Devoluciones
Es true
si se ha eliminado al usuario; en caso contrario, es false
. También se devuelve un valor de false
si el usuario no existe en la base de datos.
Excepciones
username
es una cadena vacía (""), contiene una coma o tiene más de 256 caracteres.
username
es null
.
Ejemplos
En el ejemplo de código siguiente se elimina el usuario que ha iniciado sesión actualmente.
Nota
En este ejemplo se usa SqlMembershipProvider para llamar SqlMembershipProvider al especificado como defaultProvider
en el archivo Web.config. Si necesita tener acceso al proveedor predeterminado como tipo SqlMembershipProvider, puede convertir la Provider propiedad de la Membership clase . Para acceder a otros proveedores configurados como un tipo de proveedor específico, puede acceder a ellos por su nombre configurado con la Providers propiedad de la Membership clase y convertirlos como el tipo de proveedor específico.
<%@ 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>
Comentarios
La clase llama Membership a este método para quitar un usuario de la base de datos de SQL Server especificada en el archivo de configuración de la aplicación ASP.NET.
Los usuarios eliminados solo se eliminan del configurado ApplicationName.
Si deleteAllRelatedData
se establece true
en , también se eliminan todos los datos de usuario almacenados en la base de datos para las Rolescaracterísticas de personalización , Profileo WebPart para el configurado ApplicationName.
Si el usuario de pertenencia no existe en la base de datos y deleteAllRelatedData
es true
, los datos relacionados y la información de usuario almacenada para las Rolescaracterísticas de personalización , Profileo WebPart se seguirán eliminando para la aplicación especificada en la ApplicationName propiedad . Como resultado, el DeleteUser método se puede usar para eliminar rápidamente información relacionada con un usuario, incluso cuando el SqlMembershipProvider objeto no se usa para almacenar información de usuario autenticada.
Los espacios al inicio y al final se recortan del valor de parámetro username
.