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 verwendet SqlMembershipProvider , um die SqlMembershipProvider angegebene als in defaultProvider der Web.config-Datei aufzurufen. Wenn Sie auf den Standardanbieter als Typ SqlMembershipProviderzugreifen müssen, können Sie die Provider -Eigenschaft der Membership -Klasse umwandeln. Um auf andere konfigurierte Anbieter als bestimmten Anbietertyp zuzugreifen, können Sie über ihren konfigurierten Namen mit der Providers -Eigenschaft der Membership -Klasse auf sie zugreifen und sie in den spezifischen 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 SQL Server-Datenbank zu entfernen, die in der Konfigurationsdatei der ASP.NET Anwendung angegeben ist.

Gelöschte Benutzer werden nur aus dem konfigurierten ApplicationNamegelöscht.

Wenn deleteAllRelatedData auf truefestgelegt ist, werden alle Benutzerdaten, die in der Datenbank für die Personalisierungsfeatures Roles, Profileoder WebPart gespeichert sind, auch für die konfigurierte ApplicationNamegelöscht.

Wenn der Mitgliedschaftsbenutzer nicht in der Datenbank vorhanden ist trueund deleteAllRelatedData ist, werden die zugehörigen Daten und die Benutzerinformationen, die für die Personalisierungsfeatures Roles, Profileoder WebPart gespeichert sind, weiterhin für die in der ApplicationName -Eigenschaft angegebene Anwendung gelöscht. Daher kann die DeleteUser -Methode zum schnellen Löschen von Informationen im Zusammenhang mit einem Benutzer verwendet werden, auch wenn das SqlMembershipProvider Objekt nicht zum Speichern authentifizierter Benutzerinformationen verwendet wird.

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

Gilt für:

Weitere Informationen

Einführung in ASP.NET Mitgliedschaft

Freigeben über