ProfilePropertySettings Klasse

Definition

Mit der ProfilePropertySettings-Klasse kann programmgesteuert auf den profiles-Abschnitt einer Konfigurationsdatei zugegriffen und dieser programmgesteuert geändert werden. 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
ProfilePropertySettings

Beispiele

Im folgenden Codebeispiel wird der Zugriff auf den Eigenschaftswert veranschaulicht, der PropertySettings 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 wurde.

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 namens ProfileCommonzu generieren, die von ProfileBaseabgeleitet wird. Die ProfileCommon Klassendefinition basiert auf den Eigenschaften, die properties im Unterabschnitt des Abschnitts der profile Konfigurationsdatei definiert sind. Für jedes Benutzerprofil wird eine Instanz dieser Klasse erstellt, und Sie können über die -Eigenschaft auf die HttpContext.Profile einzelnen Profilwerte im Code zugreifen. Weitere Informationen zu Profileigenschaften finden Sie unter Übersicht über ASP.NET Profileigenschaften. Weitere Informationen zu den Profilfeatures, die ASP.NET 2.0 hinzugefügt wurden, finden Sie unter Übersicht über ASP.NET Profileigenschaften.

Konstruktoren

ProfilePropertySettings(String)

Initialisiert eine neue Instanz der ProfilePropertySettings-Klasse mit dem angegebenen Namen.

ProfilePropertySettings(String, Boolean, SerializationMode, String, String, String, Boolean, String)

Initialisiert eine neue Instanz der ProfilePropertySettings-Klasse mit dem angegebenen Namen und den angegebenen Einstellungen.

Eigenschaften

AllowAnonymous

Ruft einen Wert ab, der angibt, ob die zugeordnete Eigenschaft in der dynamisch generierten ProfileCommon-Klasse durch anonyme Benutzer festgelegt werden kann.

CurrentConfiguration

Ruft einen Verweis auf die Configuration-Instanz der obersten Ebene ab, die die Konfigurationshierarchie darstellt, zu der die aktuelle ConfigurationElement-Instanz gehört.

(Geerbt von ConfigurationElement)
CustomProviderData

Ruft eine Zeichenfolge benutzerdefinierter Daten für den Profileigenschaftenanbieter ab oder legt diese fest.

DefaultValue

Ruft den Standardwert für die zugeordnete Eigenschaft in der dynamisch generierten ProfileCommon-Klasse ab oder legt diesen fest.

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 null ist.

(Geerbt von ConfigurationElement)
Item[ConfigurationProperty]

Ruft eine Eigenschaft oder ein Attribut dieses Konfigurationselements ab oder legt diese bzw. dieses fest.

(Geerbt von ConfigurationElement)
Item[String]

Ruft eine Eigenschaft, ein Attribut oder ein untergeordnetes Element dieses Konfigurationselements ab oder legt diese(s) fest.

(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

Ruft einen Wert ab, der angibt, ob das Element gesperrt ist, oder legt diesen fest.

(Geerbt von ConfigurationElement)
Name

Ruft den Namen des ProfilePropertySettings-Objekts und der zugeordneten Eigenschaft in der dynamisch generierten ProfileCommon-Klasse ab oder legt diesen fest.

Properties

Ruft die Auflistung von Eigenschaften ab.

(Geerbt von ConfigurationElement)
Provider

Ruft den Namen eines Anbieters ab, der beim Serialisieren der benannten Eigenschaft verwendet werden soll, oder legt diesen fest.

ReadOnly

Ruft einen Wert ab, der bestimmt, ob die zugeordnete Eigenschaft in der dynamisch generierten ProfileCommon-Klasse schreibgeschützt ist, oder legt diesen fest.

SerializeAs

Ruft die in der dynamisch generierten ProfileCommon-Klasse verwendete Serialisierungsmethode für die zugeordnete Eigenschaft ab oder legt diese fest.

Type

Ruft den Namen des Typs der zugeordneten Eigenschaft in der dynamisch generierten ProfileCommon-Klasse ab oder legt diesen fest.

Methoden

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 den Type der aktuellen Instanz ab.

(Geerbt von Object)
Init()

Legt für das ConfigurationElement-Objekt den Ausgangszustand 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 geändert wurde, seit es zuletzt gespeichert oder geladen wurde, wenn es in einer abgeleiteten Klasse implementiert wurde.

(Geerbt von ConfigurationElement)
IsReadOnly()

Ruft einen Wert ab, der angibt, ob das ConfigurationElement schreibgeschützt ist.

(Geerbt von ConfigurationElement)
ListErrors(IList)

Fügt die Fehler über ungültige Eigenschaften in diesem ConfigurationElement-Objekt und in allen Unterelementen der übergebenen Liste hinzu.

(Geerbt von ConfigurationElement)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
OnDeserializeUnrecognizedAttribute(String, String)

Ruft einen Wert ab, der angibt, ob während der Deserialisierung ein unbekanntes Attribut aufgetreten ist.

(Geerbt von ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)

Ruft einen Wert ab, der angibt, ob während der Deserialisierung ein unbekanntes Element aufgetreten ist.

(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 Status dieses ConfigurationElement-Objekts zurück, einschließlich der Sperren und der Eigenschaftenauflistungen.

(Geerbt von ConfigurationElement)
ResetModified()

Setzt bei Implementierung in einer abgeleiteten Klasse den Wert der IsModified()-Methode auf false zurück.

(Geerbt von ConfigurationElement)
SerializeElement(XmlWriter, Boolean)

Schreibt bei Implementierung in einer abgeleiteten Klasse den Inhalt dieses Konfigurationselements in die Konfigurationsdatei.

(Geerbt von ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)

Schreibt bei Implementierung in einer abgeleiteten Klasse die äußeren Tags dieses Konfigurationselements in die Konfigurationsdatei.

(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)

Gilt für:

Weitere Informationen