ProfilePropertySettings 类

定义

ProfilePropertySettings 类提供一种以编程方式访问和修改配置文件的 profiles 节的方法。The ProfilePropertySettings class provides a way to programmatically access and modify the profiles section of a configuration file. 此类不能被继承。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
继承
ProfilePropertySettings

示例

下面的代码示例演示如何访问PropertySettings包含对象集合的ProfilePropertySettings属性值。The following code example shows how to access the PropertySettings property value, which contains a collection of ProfilePropertySettings objects. 此代码示例是为ProfileSection类提供的更大示例的一部分。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

注解

类提供一种以编程方式创建、访问和修改添加propertiesprofile配置文件的节的子节的单个属性的定义的方法。 ProfilePropertySettingsThe 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.

配置profile文件的部分指定用户配置文件的架构。The profile section of the configuration file specifies a schema for user profiles. 在运行时, ASP.NET 编译系统使用profile部分中指定的信息来生成一个名ProfileCommon为的类, 该类派生自ProfileBaseAt 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. 类定义基于配置文件的profile节的子节properties中定义的属性。 ProfileCommonThe ProfileCommon class definition is based on the properties defined in the properties subsection of the profile section of the configuration file. 此类的实例是为每个用户配置文件创建的, 你可以通过HttpContext.Profile属性访问代码中的各个配置文件值。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. 有关配置文件属性的详细信息, 请参阅ASP.NET Profile Properties 概述For more information about profile properties, see ASP.NET Profile Properties Overview. 有关添加到ASP.NET 2.0ASP.NET 2.0的配置文件功能的详细信息, 请参阅ASP.NET profile Properties 概述For more information about the profile features added to ASP.NET 2.0ASP.NET 2.0, see ASP.NET Profile Properties Overview.

构造函数

ProfilePropertySettings(String)

用指定的名称初始化 ProfilePropertySettings 类的新实例。Initializes a new instance of the ProfilePropertySettings class with the specified name.

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

使用指定的名称和设置初始化 ProfilePropertySettings 类的新实例。Initializes a new instance of the ProfilePropertySettings class with the specified name and settings.

属性

AllowAnonymous

获取或设置一个值,该值指示动态生成的 ProfileCommon 类中关联的属性是否可由匿名用户设置。Gets or sets a value indicating whether the associated property in the dynamically generated ProfileCommon class can be set by anonymous users.

CurrentConfiguration

获取对顶级 Configuration 实例的引用,该实例表示当前 ConfigurationElement 实例所属的配置层次结构。Gets a reference to the top-level Configuration instance that represents the configuration hierarchy that the current ConfigurationElement instance belongs to.

(继承自 ConfigurationElement)
CustomProviderData

获取或设置配置文件属性提供程序的自定义数据的字符串。Gets or sets a string of custom data for the profile property provider.

DefaultValue

获取或设置动态生成的 ProfileCommon 类中关联的属性使用的默认值。Gets or sets the default value used for the associated property in the dynamically generated ProfileCommon class.

ElementInformation

获取包含 ElementInformation 对象的不可自定义的信息和功能的 ConfigurationElement 对象。Gets an ElementInformation object that contains the non-customizable information and functionality of the ConfigurationElement object.

(继承自 ConfigurationElement)
ElementProperty

获取表示 ConfigurationElementProperty 对象本身的 ConfigurationElement 对象。Gets the ConfigurationElementProperty object that represents the ConfigurationElement object itself.

(继承自 ConfigurationElement)
EvaluationContext

获取 ContextInformation 对象的 ConfigurationElement 对象。Gets the ContextInformation object for the ConfigurationElement object.

(继承自 ConfigurationElement)
HasContext

获取一个值,该值指示 CurrentConfiguration 属性是否为 nullGets a value that indicates whether the CurrentConfiguration property is null.

(继承自 ConfigurationElement)
Item[ConfigurationProperty]

获取或设置此配置元素的属性或特性。Gets or sets a property or attribute of this configuration element.

(继承自 ConfigurationElement)
Item[String]

获取或设置此配置元素的属性、特性或子元素。Gets or sets a property, attribute, or child element of this configuration element.

(继承自 ConfigurationElement)
LockAllAttributesExcept

获取被锁定的特性的集合。Gets the collection of locked attributes.

(继承自 ConfigurationElement)
LockAllElementsExcept

获取被锁定的元素的集合。Gets the collection of locked elements.

(继承自 ConfigurationElement)
LockAttributes

获取被锁定的特性的集合。Gets the collection of locked attributes.

(继承自 ConfigurationElement)
LockElements

获取被锁定的元素的集合。Gets the collection of locked elements.

(继承自 ConfigurationElement)
LockItem

获取或设置一个值,该值指示是否已锁定该元素。Gets or sets a value indicating whether the element is locked.

(继承自 ConfigurationElement)
Name

获取或设置 ProfilePropertySettings 对象的名称和动态生成的 ProfileCommon 类中的关联属性。Gets or sets the name of the ProfilePropertySettings object and the associated property in the dynamically generated ProfileCommon class.

Properties

获取属性的集合。Gets the collection of properties.

(继承自 ConfigurationElement)
Provider

获取或设置序列化命名属性时要使用的提供程序的名称。Gets or sets the name of a provider to use when serializing the named property.

ReadOnly

获取或设置一个值,该值确定动态生成的 ProfileCommon 类中关联的属性是否为只读。Gets or sets a value that determines whether the associated property in the dynamically generated ProfileCommon class is read-only.

SerializeAs

获取或设置动态生成的 ProfileCommon 类中关联的属性使用的序列化方法。Gets or sets the serialization method used for the associated property in the dynamically generated ProfileCommon class.

Type

获取或设置动态生成的 ProfileCommon 类中关联的属性的类型名称。Gets or sets the name of the type of the associated property in the dynamically generated ProfileCommon class.

方法

DeserializeElement(XmlReader, Boolean)

从配置文件读取 XML。Reads XML from the configuration file.

(继承自 ConfigurationElement)
Equals(Object)

将当前的 ConfigurationElement 实例与指定的对象进行比较。Compares the current ConfigurationElement instance to the specified object.

(继承自 ConfigurationElement)
GetHashCode()

获取表示当前 ConfigurationElement 实例的唯一值。Gets a unique value representing the current ConfigurationElement instance.

(继承自 ConfigurationElement)
GetTransformedAssemblyString(String)

返回指定程序集名称的转换版本。Returns the transformed version of the specified assembly name.

(继承自 ConfigurationElement)
GetTransformedTypeString(String)

返回指定类型名称的转换版本。Returns the transformed version of the specified type name.

(继承自 ConfigurationElement)
GetType()

获取当前实例的 TypeGets the Type of the current instance.

(继承自 Object)
Init()

ConfigurationElement 对象设置为其初始状态。Sets the ConfigurationElement object to its initial state.

(继承自 ConfigurationElement)
InitializeDefault()

用于初始化 ConfigurationElement 对象的默认值集。Used to initialize a default set of values for the ConfigurationElement object.

(继承自 ConfigurationElement)
IsModified()

指示自上次保存或加载该配置元素后并在派生类中实现该元素时,该元素是否已被修改。Indicates whether this configuration element has been modified since it was last saved or loaded, when implemented in a derived class.

(继承自 ConfigurationElement)
IsReadOnly()

获取一个值,该值指示 ConfigurationElement 对象是否为只读。Gets a value indicating whether the ConfigurationElement object is read-only.

(继承自 ConfigurationElement)
ListErrors(IList)

将此 ConfigurationElement 对象以及所有子元素中无效属性的错误添加到传递的列表中。Adds the invalid-property errors in this ConfigurationElement object, and in all subelements, to the passed list.

(继承自 ConfigurationElement)
MemberwiseClone()

创建当前 Object 的浅表副本。Creates a shallow copy of the current Object.

(继承自 Object)
OnDeserializeUnrecognizedAttribute(String, String)

获取一个值,该值指示反序列化过程中是否遇到未知特性。Gets a value indicating whether an unknown attribute is encountered during deserialization.

(继承自 ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)

获取一个值,该值指示反序列化过程中是否遇到未知元素。Gets a value indicating whether an unknown element is encountered during deserialization.

(继承自 ConfigurationElement)
OnRequiredPropertyNotFound(String)

找不到所需属性时引发异常。Throws an exception when a required property is not found.

(继承自 ConfigurationElement)
PostDeserialize()

反序列化后调用。Called after deserialization.

(继承自 ConfigurationElement)
PreSerialize(XmlWriter)

在序列化之前调用。Called before serialization.

(继承自 ConfigurationElement)
Reset(ConfigurationElement)

重置 ConfigurationElement 对象的内部状态,包括锁和属性集合。Resets the internal state of the ConfigurationElement object, including the locks and the properties collections.

(继承自 ConfigurationElement)
ResetModified()

在派生类中实现时,将 IsModified() 方法的值重置为 falseResets the value of the IsModified() method to false when implemented in a derived class.

(继承自 ConfigurationElement)
SerializeElement(XmlWriter, Boolean)

当在派生类中实现后,将此配置元素的内容写入配置文件。Writes the contents of this configuration element to the configuration file when implemented in a derived class.

(继承自 ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)

当在派生类中实现后,将此配置元素的外部标记写入配置文件。Writes the outer tags of this configuration element to the configuration file when implemented in a derived class.

(继承自 ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)

将属性设置为指定值。Sets a property to the specified value.

(继承自 ConfigurationElement)
SetReadOnly()

设置 IsReadOnly() 对象及所有子元素的 ConfigurationElement 属性。Sets the IsReadOnly() property for the ConfigurationElement object and all subelements.

(继承自 ConfigurationElement)
ToString()

返回一个表示当前对象的 string。Returns a string that represents the current object.

(继承自 Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)

修改 ConfigurationElement 对象以移除所有不应该保存的值。Modifies the ConfigurationElement object to remove all values that should not be saved.

(继承自 ConfigurationElement)

适用于

另请参阅