ProfilePropertySettings Klasse

Definition

Namespace:

System.Web.Configuration

Assembly:

System.Web.dll

Die ProfilePropertySettings Klasse bietet eine Möglichkeit, programmgesteuert auf den profiles Abschnitt einer Konfigurationsdatei zuzugreifen und sie zu ändern. Diese Klasse kann nicht vererbt werden.

public ref class ProfilePropertySettings sealed : System::Configuration::ConfigurationElement

public sealed class ProfilePropertySettings : System.Configuration.ConfigurationElement

type ProfilePropertySettings = class
    inherit ConfigurationElement

Public NotInheritable Class ProfilePropertySettings
Inherits ConfigurationElement

Vererbung

Object

ConfigurationElement

ProfilePropertySettings

Beispiele

Das folgende Codebeispiel zeigt, wie auf den PropertySettings Eigenschaftswert zugegriffen wird, der eine Auflistung von ProfilePropertySettings Objekten enthält. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ProfileSection Klasse bereitgestellt wird.

// Display all current root ProfilePropertySettings.
Console.WriteLine("Current Root ProfilePropertySettings:");
int rootPPSCtr = 0;
foreach (ProfilePropertySettings rootPPS in profileSection.PropertySettings)
{
    Console.WriteLine("  {0}: ProfilePropertySetting '{1}'", ++rootPPSCtr,
        rootPPS.Name);
}

' Display all current root ProfilePropertySettings.
Console.WriteLine("Current Root ProfilePropertySettings:")
Dim rootPPSCtr As Integer = 0
For Each rootPPS As ProfilePropertySettings In profileSection.PropertySettings
    Console.WriteLine("  {0}: ProfilePropertySetting '{1}'", ++rootPPSCtr, _
        rootPPS.Name)
Next

Hinweise

Die ProfilePropertySettings Klasse bietet eine Möglichkeit zum programmgesteuerten Erstellen, Zugreifen und Ändern der Definition einer einzelnen Eigenschaft, die dem properties Unterabschnitt des profile Abschnitts einer Konfigurationsdatei hinzugefügt wird.

Der profile Abschnitt der Konfigurationsdatei gibt ein Schema für Benutzerprofile an. Zur Laufzeit verwendet das ASP.NET Kompilierungssystem die im profile Abschnitt angegebenen Informationen, um eine Klasse zu generieren, die aufgerufen ProfileCommonwird, die von ProfileBase. Die ProfileCommon Klassendefinition basiert auf den Eigenschaften, die properties im Unterabschnitt des profile Abschnitts der Konfigurationsdatei definiert sind. Für jedes Benutzerprofil wird eine Instanz dieser Klasse erstellt, und Sie können über die HttpContext.Profile Eigenschaft auf die einzelnen Profilwerte in Ihrem Code zugreifen. Weitere Informationen zu Profileigenschaften finden Sie unter ASP.NET Profileigenschaften (Übersicht). Weitere Informationen zu den Profilfeatures, die ASP.NET 2.0 hinzugefügt wurden, finden Sie unter ASP.NET Profileigenschaften (Übersicht).

Konstruktoren

Name	Beschreibung
ProfilePropertySettings(String, Boolean, SerializationMode, String, String, String, Boolean, String)	Initialisiert eine neue Instanz der ProfilePropertySettings Klasse mit dem angegebenen Namen und den angegebenen Einstellungen.
ProfilePropertySettings(String)	Initialisiert eine neue Instanz der ProfilePropertySettings Klasse mit dem angegebenen Namen.

Eigenschaften

Name	Beschreibung
AllowAnonymous	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die zugeordnete Eigenschaft in der dynamisch generierten ProfileCommon Klasse von anonymen Benutzern festgelegt werden kann.
CurrentConfiguration	Ruft einen Verweis auf die Instanz der obersten Ebene Configuration ab, die die Konfigurationshierarchie darstellt, zu der die aktuelle ConfigurationElement Instanz gehört. (Geerbt von ConfigurationElement)
CustomProviderData	Dient zum Abrufen oder Festlegen einer Zeichenfolge von benutzerdefinierten Daten für den Profileigenschaftenanbieter.
DefaultValue	Dient zum Abrufen oder Festlegen des Standardwerts, der für die zugeordnete Eigenschaft in der dynamisch generierten Klasse verwendet wird ProfileCommon .
ElementInformation	Ruft ein ElementInformation Objekt ab, das die nicht anpassbaren Informationen und Funktionen des ConfigurationElement Objekts enthält. (Geerbt von ConfigurationElement)
ElementProperty	Ruft das ConfigurationElementProperty Objekt ab, das das ConfigurationElement Objekt selbst darstellt. (Geerbt von ConfigurationElement)
EvaluationContext	Ruft das ContextInformation-Objekt für das ConfigurationElement-Objekt ab. (Geerbt von ConfigurationElement)
HasContext	Ruft einen Wert ab, der angibt, ob die CurrentConfiguration Eigenschaft ist null. (Geerbt von ConfigurationElement)
Item[ConfigurationProperty]	Dient zum Abrufen oder Festlegen einer Eigenschaft oder eines Attributs dieses Konfigurationselements. (Geerbt von ConfigurationElement)
Item[String]	Dient zum Abrufen oder Festlegen einer Eigenschaft, eines Attributs oder eines untergeordneten Elements dieses Konfigurationselements. (Geerbt von ConfigurationElement)
LockAllAttributesExcept	Ruft die Auflistung gesperrter Attribute ab. (Geerbt von ConfigurationElement)
LockAllElementsExcept	Ruft die Auflistung gesperrter Elemente ab. (Geerbt von ConfigurationElement)
LockAttributes	Ruft die Auflistung gesperrter Attribute ab. (Geerbt von ConfigurationElement)
LockElements	Ruft die Auflistung gesperrter Elemente ab. (Geerbt von ConfigurationElement)
LockItem	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Element gesperrt ist. (Geerbt von ConfigurationElement)
Name	Dient zum Abrufen oder Festlegen des Namens des ProfilePropertySettings Objekts und der zugeordneten Eigenschaft in der dynamisch generierten ProfileCommon Klasse.
Properties	Ruft die Auflistung von Eigenschaften ab. (Geerbt von ConfigurationElement)
Provider	Dient zum Abrufen oder Festlegen des Namens eines Anbieters, der beim Serialisieren der benannten Eigenschaft verwendet werden soll.
ReadOnly	Dient zum Abrufen oder Festlegen eines Werts, der bestimmt, ob die zugeordnete Eigenschaft in der dynamisch generierten ProfileCommon Klasse schreibgeschützt ist.
SerializeAs	Dient zum Abrufen oder Festlegen der Serialisierungsmethode, die für die zugeordnete Eigenschaft in der dynamisch generierten Klasse verwendet wird ProfileCommon .
Type	Dient zum Abrufen oder Festlegen des Namens des Typs der zugeordneten Eigenschaft in der dynamisch generierten ProfileCommon Klasse.

Methoden

Name	Beschreibung
DeserializeElement(XmlReader, Boolean)	Liest XML aus der Konfigurationsdatei. (Geerbt von ConfigurationElement)
Equals(Object)	Vergleicht die aktuelle ConfigurationElement Instanz mit dem angegebenen Objekt. (Geerbt von ConfigurationElement)
GetHashCode()	Ruft einen eindeutigen Wert ab, der die aktuelle ConfigurationElement Instanz darstellt. (Geerbt von ConfigurationElement)
GetTransformedAssemblyString(String)	Gibt die transformierte Version des angegebenen Assemblynamens zurück. (Geerbt von ConfigurationElement)
GetTransformedTypeString(String)	Gibt die transformierte Version des angegebenen Typnamens zurück. (Geerbt von ConfigurationElement)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
Init()	Legt das ConfigurationElement Objekt auf seinen Anfangszustand fest. (Geerbt von ConfigurationElement)
InitializeDefault()	Wird verwendet, um einen Standardsatz von Werten für das ConfigurationElement Objekt zu initialisieren. (Geerbt von ConfigurationElement)
IsModified()	Gibt an, ob dieses Konfigurationselement seit dem letzten Speichern oder Laden geändert wurde, wenn es in einer abgeleiteten Klasse implementiert wurde. (Geerbt von ConfigurationElement)
IsReadOnly()	Ruft einen Wert ab, der angibt, ob das ConfigurationElement Objekt schreibgeschützt ist. (Geerbt von ConfigurationElement)
ListErrors(IList)	Fügt der übergebenen Liste die Fehler der ungültigen Eigenschaft in diesem ConfigurationElement Objekt und in allen Unterelementen hinzu. (Geerbt von ConfigurationElement)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
OnDeserializeUnrecognizedAttribute(String, String)	Ruft einen Wert ab, der angibt, ob während der Deserialisierung ein unbekanntes Attribut gefunden wird. (Geerbt von ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Ruft einen Wert ab, der angibt, ob während der Deserialisierung ein unbekanntes Element auftritt. (Geerbt von ConfigurationElement)
OnRequiredPropertyNotFound(String)	Löst eine Ausnahme aus, wenn eine erforderliche Eigenschaft nicht gefunden wird. (Geerbt von ConfigurationElement)
PostDeserialize()	Wird nach der Deserialisierung aufgerufen. (Geerbt von ConfigurationElement)
PreSerialize(XmlWriter)	Wird vor der Serialisierung aufgerufen. (Geerbt von ConfigurationElement)
Reset(ConfigurationElement)	Setzt den internen Zustand des ConfigurationElement Objekts zurück, einschließlich der Sperren und der Eigenschaftenauflistungen. (Geerbt von ConfigurationElement)
ResetModified()	Setzt den Wert der IsModified() Methode zurück, wenn false sie in einer abgeleiteten Klasse implementiert wird. (Geerbt von ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Schreibt den Inhalt dieses Konfigurationselements in die Konfigurationsdatei, wenn es in einer abgeleiteten Klasse implementiert wird. (Geerbt von ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	Schreibt die äußeren Tags dieses Konfigurationselements in die Konfigurationsdatei, wenn sie in einer abgeleiteten Klasse implementiert wird. (Geerbt von ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Legt eine Eigenschaft auf den angegebenen Wert fest. (Geerbt von ConfigurationElement)
SetReadOnly()	Legt die IsReadOnly() Eigenschaft für das ConfigurationElement Objekt und alle Unterelemente fest. (Geerbt von ConfigurationElement)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Ändert das ConfigurationElement Objekt, um alle Werte zu entfernen, die nicht gespeichert werden sollen. (Geerbt von ConfigurationElement)

Weitere Informationen

• ProfileSection
• PropertySettings
• ProfilePropertySettingsCollection