SqlMembershipProvider.DeleteUser(String, Boolean) Methode

Referenz

Definition

Namespace:: System.Web.Security

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Entfernt die Mitgliedschaftsinformationen eines Benutzers aus der Mitgliedschaftsdatenbank von 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

Parameter

username: String

Der Name des zu löschenden Benutzers.

deleteAllRelatedData: Boolean

true, um mit dem Benutzer zusammenhängende Daten aus der Datenbank zu löschen; false, um die mit dem Benutzer zusammenhängenden Daten in der Datenbank zu belassen.

Gibt zurück

Boolean

true, wenn der Benutzer gelöscht wurde, andernfalls false. Der Wert false wird auch zurückgegeben, wenn der Benutzer in der Datenbank nicht vorhanden ist.

Ausnahmen

ArgumentException

username ist eine leere Zeichenfolge (""), enthält ein Komma oder ist länger als 256 Zeichen.

ArgumentNullException

username ist null.

Beispiele

Im folgenden Codebeispiel wird der aktuell angemeldete Benutzer gelöscht.

Hinweis

In diesem Beispiel wird SqlMembershipProvider die SqlMembershipProvider angegebene Als defaultProvider die in der Web.config-Datei angegebene Aufgerufen. Wenn Sie als Typ auf den Standardanbieter SqlMembershipProviderzugreifen müssen, können Sie die Provider Eigenschaft der Membership Klasse casten. Um auf andere konfigurierte Anbieter als bestimmten Anbietertyp zuzugreifen, können Sie sie durch den konfigurierten Namen mit der Providers Eigenschaft der Membership Klasse zugreifen und sie als bestimmten Anbietertyp umwandeln.

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

Hinweise

Diese Methode wird von der Membership Klasse aufgerufen, um einen Benutzer aus der in der Konfigurationsdatei ASP.NET Anwendung angegebenen SQL Server Datenbank zu entfernen.

Gelöschte Benutzer werden nur aus der konfigurierten Datei ApplicationNamegelöscht.

Wenn deleteAllRelatedData festgelegt ist, werden alle Benutzerdaten, die in der Datenbank für die Funktionen für die WebPart Roles ProfilePersonalisierung gespeichert sind, auch für die konfigurierte ApplicationNamePersonalisierung gelöscht.true

Wenn der Mitgliedschaftsbenutzer nicht in der Datenbank vorhanden ist und deleteAllRelatedData truedie zugehörigen Daten und die für die Eigenschaft angegebenen Benutzerinformationen und die für die Profile RolesEigenschaft gespeicherten ApplicationName Benutzerinformationen oder WebPart Personalisierungsfeatures weiterhin gelöscht werden. Daher kann die Methode zum schnellen Löschen von Informationen im Zusammenhang mit einem Benutzer verwendet werden, auch wenn das DeleteUser SqlMembershipProvider Objekt nicht zum Speichern authentifizierter Benutzerinformationen verwendet wird.

Beim username-Parameterwert werden führende und nachstehende Leerzeichen abgeschnitten.

Gilt für

Siehe auch

Einführung in ASP.NET Mitgliedschaft