Partilhar via


SqlMembershipProvider.DeleteUser(String, Boolean) Método

Definição

Remove as informações de associação de um usuário do banco de dados de associação do 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

O nome do usuário a ser excluído.

deleteAllRelatedData
Boolean

true para excluir dados relacionados ao usuário do banco de dados, false para deixar os dados relacionados ao usuário no banco de dados.

Retornos

true se o usuário tiver sido excluído; caso contrário, false. Um valor de false também será retornado se o usuário não existir no banco de dados.

Exceções

username é uma cadeia de caracteres vazia (""), contém uma vírgula ou tem mais de 256 caracteres.

username é null.

Exemplos

O exemplo de código a seguir exclui o usuário conectado no momento.

Observação

Este exemplo usa SqlMembershipProvider para chamar o SqlMembershipProvider especificado como o defaultProvider no arquivo Web.config. Se você precisar acessar o provedor padrão como o tipo SqlMembershipProvider, poderá converter a Provider propriedade da Membership classe . Para acessar outros provedores configurados como um tipo de provedor específico, você pode acessá-los pelo nome configurado com a Providers propriedade da Membership classe e convertê-los como o tipo de provedor 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>

Comentários

Esse método é chamado pela Membership classe para remover um usuário do banco de dados do SQL Server especificado no arquivo de configuração do aplicativo ASP.NET.

Os usuários excluídos são excluídos apenas do configurado ApplicationName.

Se deleteAllRelatedData for definido truecomo , todos os dados de usuário armazenados no banco de dados para os Rolesrecursos de personalização , Profileou WebPart também serão excluídos para o configurado ApplicationName.

Se o usuário associado não existir no banco de dados e deleteAllRelatedData for true, os dados relacionados e as informações do usuário armazenadas para os Rolesrecursos de personalização , Profileou WebPart ainda serão excluídos para o aplicativo especificado na ApplicationName propriedade . Como resultado, o DeleteUser método pode ser usado para excluir rapidamente informações relacionadas a um usuário, mesmo quando o SqlMembershipProvider objeto não é usado para armazenar informações de usuário autenticadas.

Os espaços à esquerda e à direita são cortados do valor de parâmetro username.

Aplica-se a

Confira também