Udostępnij za pośrednictwem

SqlMembershipProvider.DeleteUser(String, Boolean) Metoda

Definicja

Przestrzeń nazw:
System.Web.Security
Zestaw:
System.Web.dll

Usuwa informacje o członkostwie użytkownika z bazy danych członkostwa programu 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

Parametry

username
String

Nazwa użytkownika do usunięcia.

deleteAllRelatedData
Boolean

true aby usunąć dane związane z użytkownikiem z bazy danych; false aby pozostawić dane powiązane z użytkownikiem w bazie danych.

Zwraca

Boolean

true jeśli użytkownik został usunięty; w przeciwnym razie, false. Wartość false jest również zwracana, jeśli użytkownik nie istnieje w bazie danych.

Wyjątki

ArgumentException

username jest pustym ciągiem (""), zawiera przecinek lub jest dłuższy niż 256 znaków.

ArgumentNullException

Parametr username ma wartość null.

Przykłady

Poniższy przykład kodu usuwa aktualnie zalogowanego użytkownika.

Uwaga / Notatka

W tym przykładzie użyto SqlMembershipProvider metody do wywołania określonego SqlMembershipProvider elementu w defaultProvider pliku Web.config. Jeśli musisz uzyskać dostęp do domyślnego dostawcy jako typu SqlMembershipProvider, możesz rzutować Provider właściwość Membership klasy. Aby uzyskać dostęp do innych skonfigurowanych dostawców jako określonego typu dostawcy, możesz uzyskać do nich dostęp według ich skonfigurowanej nazwy z właściwością ProvidersMembership klasy i rzutować je jako określony typ dostawcy.

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

Uwagi

Ta metoda jest wywoływana Membership przez klasę w celu usunięcia użytkownika z bazy danych programu SQL Server określonej w pliku konfiguracji aplikacji ASP.NET.

Usunięci użytkownicy są usuwani tylko ze skonfigurowanego ApplicationNameelementu .

Jeśli deleteAllRelatedData ustawiono wartość true, wszystkie dane użytkownika przechowywane w bazie danych dla ProfileRolesfunkcji , lub WebPart personalizacji również zostaną usunięte dla skonfigurowanego ApplicationNameelementu .

Jeśli użytkownik członkostwa nie istnieje w bazie danych i deleteAllRelatedData ma truewartość , powiązane dane i informacje o użytkowniku przechowywane dla ProfileRolesfunkcji , lub WebPart personalizacji będą nadal usuwane dla aplikacji określonej we ApplicationName właściwości . W związku z tym DeleteUser metoda może służyć do szybkiego usuwania informacji związanych z użytkownikiem, nawet jeśli SqlMembershipProvider obiekt nie jest używany do przechowywania uwierzytelnionych informacji o użytkowniku.

Spacje wiodące i końcowe są przycinane z wartości parametru username .

Dotyczy

Zobacz też