FormsAuthenticationUserCollection.Remove(String) Methode

Definition

Namespace:

System.Web.Configuration

Assembly:

System.Web.dll

Entfernt ein FormsAuthenticationUser-Objekt aus der Auflistung.

public:
 void Remove(System::String ^ name);

public void Remove (string name);

member this.Remove : string -> unit

Public Sub Remove (name As String)

Parameter

name

String

Der Name des aus der Auflistung zu entfernenden FormsAuthenticationUser-Objekts.

Ausnahmen

ConfigurationException

Die Auflistung enthält kein FormsAuthenticationUser-Objekt mit dem angegebenen Schlüssel, das Element wurde bereits entfernt, oder die Auflistung ist schreibgeschützt.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der Remove-Methode veranschaulicht.

// Using method Remove.
// Execute the Remove method.
formsAuthenticationCredentials.Users.Remove("userName");

// Update if not locked
if (!authenticationSection.SectionInformation.IsLocked)
{
    configuration.Save();
}

' Using method Remove.
' Execute the Remove method.
formsAuthenticationCredentials.Users.Remove("userName")

' Update if not locked
If Not authenticationSection.SectionInformation.IsLocked Then
   configuration.Save()
End If

Hinweise

Diese Methode fügt ein remove Element in den entsprechenden Abschnitt der Konfigurationsdatei für jedes Element ein, das in einer Konfigurationsdatei auf höherer Ebene definiert ist. Wenn das Element im entsprechenden Abschnitt der aktuellen Konfigurationsdatei definiert ist, wird sein Eintrag aus der Konfigurationsdatei entfernt. Das zu entfernende Objekt muss in der Auflistung vorhanden sein.