SqlMembershipProvider.DeleteUser(String, Boolean) Método

Definição

Espaço de Nomes:
System.Web.Security
Assemblagem:
System.Web.dll

Remove a informação de adesão do utilizador da base de dados de membros 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 utilizador a eliminar.

deleteAllRelatedData
Boolean

true para eliminar dados relacionados com o utilizador da base de dados; false para deixar dados relacionados com o utilizador na base de dados.

Devoluções

Boolean

true se o utilizador foi eliminado; caso contrário, false. Um valor de false também é devolvido se o utilizador não existir na base de dados.

Exceções

ArgumentException

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

ArgumentNullException

username é null.

Exemplos

O exemplo de código seguinte elimina o utilizador atualmente logado.

Note

Este exemplo serve SqlMembershipProvider para chamar o SqlMembershipProvider especificado como o defaultProvider no ficheiro Web.config. Se precisares de aceder ao fornecedor padrão como tipo SqlMembershipProvider, podes castar a Provider propriedade da Membership classe. Para aceder a outros fornecedores configurados como um tipo específico de fornecedor, pode aceder a eles pelo nome configurado com a Providers propriedade da Membership classe e atribuí-los ao tipo específico de fornecedor.

<%@ 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>

Observações

Este método é chamado pela classe Membership para remover um utilizador da base de dados SQL Server especificada no ficheiro de configuração da aplicação ASP.NET.

Os utilizadores eliminados são apenas eliminados do arquivo configurado ApplicationName.

Se deleteAllRelatedData for definido como true, então todos os dados do utilizador armazenados na base de dados para as Rolesfuncionalidades de , Profile, ou WebPart personalização também são eliminados para os .ApplicationName

Se o utilizador de membros não existir na base de dados, e deleteAllRelatedData for true, então os dados relacionados e a informação de utilizador armazenada para as Rolesfuncionalidades de , Profile, ou WebPart personalização continuarão a ser eliminados para a aplicação especificada na ApplicationName propriedade. Como resultado, o DeleteUser método pode ser usado para eliminar rapidamente informação relacionada com um utilizador, mesmo quando o SqlMembershipProvider objeto não é usado para armazenar informações autenticadas do utilizador.

Os espaços à frente e à saída são cortados a partir do username valor do parâmetro.

Aplica-se a

Ver também