ProfilePropertySettings Klasse

Definition

Mit der ProfilePropertySettings-Klasse kann programmgesteuert auf den profiles-Abschnitt einer Konfigurationsdatei zugegriffen und dieser programmgesteuert geändert werden.The ProfilePropertySettings class provides a way to programmatically access and modify the profiles section of a configuration file. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

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 gezeigt, wie auf PropertySettings den-Eigenschafts Wert zugegriffen wird, ProfilePropertySettings der eine Auflistung von-Objekten enthält.The following code example shows how to access the PropertySettings property value, which contains a collection of ProfilePropertySettings objects. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ProfileSection -Klasse bereitgestellt wird.This code example is part of a larger example provided for the ProfileSection class.

// 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, die Definition einer einzelnen Eigenschaft, die dem properties unter Abschnitt profile des-Abschnitts einer Konfigurationsdatei hinzugefügt wird, Programm gesteuert zu erstellen, auf Sie zuzugreifen und diese zu ändern.The ProfilePropertySettings class provides a way to programmatically create, access, and modify the definition of an individual property added to the properties subsection of the profile section of a configuration file.

Der profile -Abschnitt der Konfigurationsdatei gibt ein Schema für Benutzerprofile an.The profile section of the configuration file specifies a schema for user profiles. Zur Laufzeit verwendet das ASP.net-Kompilierungs System die im profile Abschnitt angegebenen Informationen, um eine Klasse mit dem Namen ProfileCommonzu generieren, die ProfileBasevon abgeleitet ist.At run time, the ASP.NET compilation system uses the information specified in the profile section to generate a class called ProfileCommon, which is derived from ProfileBase. Die ProfileCommon Klassendefinition basiert auf den Eigenschaften, die properties im-unter Abschnitt des profile -Abschnitts der Konfigurationsdatei definiert sind.The ProfileCommon class definition is based on the properties defined in the properties subsection of the profile section of the configuration file. Eine Instanz dieser Klasse wird für jedes Benutzerprofil erstellt, und Sie können über die HttpContext.Profile -Eigenschaft auf die einzelnen Profil Werte in Ihrem Code zugreifen.An instance of this class is created for each user profile, and you can access the individual profile values in your code through the HttpContext.Profile property. Weitere Informationen zu Profil Eigenschaften finden Sie unter ASP.NET Profile Properties Overview.For more information about profile properties, see ASP.NET Profile Properties Overview. Weitere Informationen zu den hinzugefügten Profil Funktionen ASP.NET 2.0ASP.NET 2.0finden Sie unter ASP.NET Profile Properties Overview.For more information about the profile features added to ASP.NET 2.0ASP.NET 2.0, see ASP.NET Profile Properties Overview.

Konstruktoren

ProfilePropertySettings(String)

Initialisiert eine neue Instanz der ProfilePropertySettings-Klasse mit dem angegebenen Namen.Initializes a new instance of the ProfilePropertySettings class with the specified name.

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

Initialisiert eine neue Instanz der ProfilePropertySettings-Klasse mit dem angegebenen Namen und den angegebenen Einstellungen.Initializes a new instance of the ProfilePropertySettings class with the specified name and settings.

Eigenschaften

AllowAnonymous

Ruft einen Wert ab, der angibt, ob die zugeordnete Eigenschaft in der dynamisch generierten ProfileCommon-Klasse durch anonyme Benutzer festgelegt werden kann.Gets or sets a value indicating whether the associated property in the dynamically generated ProfileCommon class can be set by anonymous users.

CurrentConfiguration

Ruft einen Verweis auf die Configuration-Instanz der obersten Ebene ab, die die Konfigurationshierarchie darstellt, zu der die aktuelle ConfigurationElement-Instanz gehört.Gets a reference to the top-level Configuration instance that represents the configuration hierarchy that the current ConfigurationElement instance belongs to.

(Geerbt von ConfigurationElement)
CustomProviderData

Ruft eine Zeichenfolge benutzerdefinierter Daten für den Profileigenschaftenanbieter ab oder legt diese fest.Gets or sets a string of custom data for the profile property provider.

DefaultValue

Ruft den Standardwert für die zugeordnete Eigenschaft in der dynamisch generierten ProfileCommon-Klasse ab oder legt diesen fest.Gets or sets the default value used for the associated property in the dynamically generated ProfileCommon class.

ElementInformation

Ruft ein ElementInformation-Objekt ab, das die nicht anpassbaren Informationen und Funktionen des ConfigurationElement-Objekts enthält.Gets an ElementInformation object that contains the non-customizable information and functionality of the ConfigurationElement object.

(Geerbt von ConfigurationElement)
ElementProperty

Ruft das ConfigurationElementProperty-Objekt ab, das das ConfigurationElement-Objekt selbst darstellt.Gets the ConfigurationElementProperty object that represents the ConfigurationElement object itself.

(Geerbt von ConfigurationElement)
EvaluationContext

Ruft das ContextInformation-Objekt für das ConfigurationElement-Objekt ab.Gets the ContextInformation object for the ConfigurationElement object.

(Geerbt von ConfigurationElement)
HasContext

Ruft einen Wert ab, der angibt, ob die CurrentConfiguration-Eigenschaft null ist.Gets a value that indicates whether the CurrentConfiguration property is null.

(Geerbt von ConfigurationElement)
Item[ConfigurationProperty]

Ruft eine Eigenschaft oder ein Attribut dieses Konfigurationselements ab oder legt diese bzw. dieses fest.Gets or sets a property or attribute of this configuration element.

(Geerbt von ConfigurationElement)
Item[String]

Ruft eine Eigenschaft, ein Attribut oder ein untergeordnetes Element dieses Konfigurationselements ab oder legt diese(s) fest.Gets or sets a property, attribute, or child element of this configuration element.

(Geerbt von ConfigurationElement)
LockAllAttributesExcept

Ruft die Auflistung gesperrter Attribute ab.Gets the collection of locked attributes.

(Geerbt von ConfigurationElement)
LockAllElementsExcept

Ruft die Auflistung gesperrter Elemente ab.Gets the collection of locked elements.

(Geerbt von ConfigurationElement)
LockAttributes

Ruft die Auflistung gesperrter Attribute ab.Gets the collection of locked attributes.

(Geerbt von ConfigurationElement)
LockElements

Ruft die Auflistung gesperrter Elemente ab.Gets the collection of locked elements.

(Geerbt von ConfigurationElement)
LockItem

Ruft einen Wert ab, der angibt, ob das Element gesperrt ist, oder legt diesen fest.Gets or sets a value indicating whether the element is locked.

(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.Gets or sets the name of the ProfilePropertySettings object and the associated property in the dynamically generated ProfileCommon class.

Properties

Ruft die Auflistung von Eigenschaften ab.Gets the collection of properties.

(Geerbt von ConfigurationElement)
Provider

Ruft den Namen eines Anbieters ab, der beim Serialisieren der benannten Eigenschaft verwendet werden soll, oder legt diesen fest.Gets or sets the name of a provider to use when serializing the named property.

ReadOnly

Ruft einen Wert ab, der bestimmt, ob die zugeordnete Eigenschaft in der dynamisch generierten ProfileCommon-Klasse schreibgeschützt ist, oder legt diesen fest.Gets or sets a value that determines whether the associated property in the dynamically generated ProfileCommon class is read-only.

SerializeAs

Ruft die in der dynamisch generierten ProfileCommon-Klasse verwendete Serialisierungsmethode für die zugeordnete Eigenschaft ab oder legt diese fest.Gets or sets the serialization method used for the associated property in the dynamically generated ProfileCommon class.

Type

Ruft den Namen des Typs der zugeordneten Eigenschaft in der dynamisch generierten ProfileCommon-Klasse ab oder legt diesen fest.Gets or sets the name of the type of the associated property in the dynamically generated ProfileCommon class.

Methoden

DeserializeElement(XmlReader, Boolean)

Liest XML aus der Konfigurationsdatei.Reads XML from the configuration file.

(Geerbt von ConfigurationElement)
Equals(Object)

Vergleicht die aktuelle ConfigurationElement-Instanz mit dem angegebenen Objekt.Compares the current ConfigurationElement instance to the specified object.

(Geerbt von ConfigurationElement)
GetHashCode()

Ruft einen eindeutigen Wert ab, der die aktuelle ConfigurationElement-Instanz darstellt.Gets a unique value representing the current ConfigurationElement instance.

(Geerbt von ConfigurationElement)
GetTransformedAssemblyString(String)

Gibt die transformierte Version des angegebenen Assemblynamens zurück.Returns the transformed version of the specified assembly name.

(Geerbt von ConfigurationElement)
GetTransformedTypeString(String)

Gibt die transformierte Version des angegebenen Typnamens zurück.Returns the transformed version of the specified type name.

(Geerbt von ConfigurationElement)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
Init()

Legt für das ConfigurationElement-Objekt den Ausgangszustand fest.Sets the ConfigurationElement object to its initial state.

(Geerbt von ConfigurationElement)
InitializeDefault()

Wird verwendet, um einen Standardsatz von Werten für das ConfigurationElement-Objekt zu initialisieren.Used to initialize a default set of values for the ConfigurationElement object.

(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.Indicates whether this configuration element has been modified since it was last saved or loaded, when implemented in a derived class.

(Geerbt von ConfigurationElement)
IsReadOnly()

Ruft einen Wert ab, der angibt, ob das ConfigurationElement schreibgeschützt ist.Gets a value indicating whether the ConfigurationElement object is read-only.

(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.Adds the invalid-property errors in this ConfigurationElement object, and in all subelements, to the passed list.

(Geerbt von ConfigurationElement)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
OnDeserializeUnrecognizedAttribute(String, String)

Ruft einen Wert ab, der angibt, ob während der Deserialisierung ein unbekanntes Attribut aufgetreten ist.Gets a value indicating whether an unknown attribute is encountered during deserialization.

(Geerbt von ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)

Ruft einen Wert ab, der angibt, ob während der Deserialisierung ein unbekanntes Element aufgetreten ist.Gets a value indicating whether an unknown element is encountered during deserialization.

(Geerbt von ConfigurationElement)
OnRequiredPropertyNotFound(String)

Löst eine Ausnahme aus, wenn eine erforderliche Eigenschaft nicht gefunden wird.Throws an exception when a required property is not found.

(Geerbt von ConfigurationElement)
PostDeserialize()

Wird nach der Deserialisierung aufgerufen.Called after deserialization.

(Geerbt von ConfigurationElement)
PreSerialize(XmlWriter)

Wird vor der Serialisierung aufgerufen.Called before serialization.

(Geerbt von ConfigurationElement)
Reset(ConfigurationElement)

Setzt den internen Status dieses ConfigurationElement-Objekts zurück, einschließlich der Sperren und der Eigenschaftenauflistungen.Resets the internal state of the ConfigurationElement object, including the locks and the properties collections.

(Geerbt von ConfigurationElement)
ResetModified()

Setzt bei Implementierung in einer abgeleiteten Klasse den Wert der IsModified()-Methode auf false zurück.Resets the value of the IsModified() method to false when implemented in a derived class.

(Geerbt von ConfigurationElement)
SerializeElement(XmlWriter, Boolean)

Schreibt bei Implementierung in einer abgeleiteten Klasse den Inhalt dieses Konfigurationselements in die Konfigurationsdatei.Writes the contents of this configuration element to the configuration file when implemented in a derived class.

(Geerbt von ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)

Schreibt bei Implementierung in einer abgeleiteten Klasse die äußeren Tags dieses Konfigurationselements in die Konfigurationsdatei.Writes the outer tags of this configuration element to the configuration file when implemented in a derived class.

(Geerbt von ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)

Legt eine Eigenschaft auf den angegebenen Wert fest.Sets a property to the specified value.

(Geerbt von ConfigurationElement)
SetReadOnly()

Legt die IsReadOnly()-Eigenschaft für das ConfigurationElement-Objekt und alle Unterelemente fest.Sets the IsReadOnly() property for the ConfigurationElement object and all subelements.

(Geerbt von ConfigurationElement)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)

Ändert das ConfigurationElement-Objekt, um alle Werte zu entfernen, die nicht gespeichert werden sollen.Modifies the ConfigurationElement object to remove all values that should not be saved.

(Geerbt von ConfigurationElement)

Gilt für:

Siehe auch