ProfilePropertySettingsCollection.Remove(String) Methode

Definition

Namespace:

System.Web.Configuration

Assembly:

System.Web.dll

Entfernt ein ProfilePropertySettings-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 eines aus der Auflistung zu entfernenden ProfilePropertySettings-Objekts.

Ausnahmen

ConfigurationException

In der Auflistung ist kein ProfilePropertySettings-Objekt mit dem angegebenen Schlüssel vorhanden.

- oder - Das Element wurde bereits entfernt.

- oder - Die Auflistung ist schreibgeschützt.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der Remove-Methode veranschaulicht. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ProfileSection Klasse bereitgestellt wird.

// Remove a PropertySettings from the group.
newPropGroup.PropertySettings.Remove("AvatarImage");
newPropGroup.PropertySettings.RemoveAt(0);

' Remove a PropertySettings from the group.
newPropGroup.PropertySettings.Remove("AvatarImage")
newPropGroup.PropertySettings.RemoveAt(0)

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 der Eintrag aus der Konfigurationsdatei entfernt. Das zu entfernende Objekt muss in der Auflistung vorhanden sein.

Siehe auch

• ProfilePropertySettings
• ProfileSection