ProfileGroupSettings 类

定义

命名空间:: System.Web.Configuration

程序集:: System.Web.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

提供对 group 配置文件节的子节的 profiles 编程访问。

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

public sealed class ProfileGroupSettings : System.Configuration.ConfigurationElement

type ProfileGroupSettings = class
    inherit ConfigurationElement

Public NotInheritable Class ProfileGroupSettings
Inherits ConfigurationElement

继承: Object

ConfigurationElement
ProfileGroupSettings

示例

下面的代码示例演示如何使用该 ProfileGroupSettings 类型。该代码示例是 ProfileSection 类中的一个较大示例的一部分。

// Add a new group.
ProfileGroupSettings newPropGroup = new ProfileGroupSettings("Forum");
profileSection.PropertySettings.GroupSettings.Add(newPropGroup);

// Add a new PropertySettings to the group.
ProfilePropertySettings newProp = new ProfilePropertySettings("AvatarImage");
newProp.Type = "System.String, System.dll";
newPropGroup.PropertySettings.Add(newProp);

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

// Clear all PropertySettings from the group.
newPropGroup.PropertySettings.Clear();

' Add a new group.
Dim newPropGroup As ProfileGroupSettings = new ProfileGroupSettings("Forum")
profileSection.PropertySettings.GroupSettings.Add(newPropGroup)

' Add a new PropertySettings to the group.
Dim newProp As ProfilePropertySettings = new ProfilePropertySettings("AvatarImage")
newProp.Type = "System.String, System.dll"
newPropGroup.PropertySettings.Add(newProp)

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

' Clear all PropertySettings from the group.
newPropGroup.PropertySettings.Clear()

注解

该 ProfileGroupSettings 类提供了一种以编程方式创建、访问和修改添加到 group 配置文件节子节 profile 的属性组的方法。

配置文件 profile 的节指定用户配置文件的架构。在运行时，ASP.NET 编译系统使用节中指定的 profile 信息来生成一 ProfileCommon个名为（派生自 ProfileBase）的类。类ProfileCommon定义基于配置文件节的子节profile中properties定义的属性。为每个用户配置文件创建此类的实例，可以通过属性访问代码 HttpContext.Profile 中的单个配置文件值。有关添加到 ASP.NET 2.0 的配置文件功能的详细信息，请参阅 ASP.NET 配置文件属性概述。

构造函数

名称	说明
ProfileGroupSettings(String)	使用默认设置初始化类的新实例 ProfileGroupSettings 。

属性

名称	说明
CurrentConfiguration	获取对顶级 Configuration 实例的引用，该实例表示当前 ConfigurationElement 实例所属的配置层次结构。 (继承自 ConfigurationElement)
ElementInformation	获取一个 ElementInformation 对象，该对象包含不可自定义的信息和功能 ConfigurationElement 。 (继承自 ConfigurationElement)
ElementProperty	ConfigurationElementProperty获取表示ConfigurationElement对象本身的对象。 (继承自 ConfigurationElement)
EvaluationContext	获取 ContextInformation 对象的 ConfigurationElement 对象。 (继承自 ConfigurationElement)
HasContext	获取一个值，该值指示属性是否 CurrentConfiguration 为 `null`. (继承自 ConfigurationElement)
Item[ConfigurationProperty]	获取或设置此配置元素的属性或属性。 (继承自 ConfigurationElement)
Item[String]	获取或设置此配置元素的属性、属性或子元素。 (继承自 ConfigurationElement)
LockAllAttributesExcept	获取锁定属性的集合。 (继承自 ConfigurationElement)
LockAllElementsExcept	获取锁定元素的集合。 (继承自 ConfigurationElement)
LockAttributes	获取锁定属性的集合。 (继承自 ConfigurationElement)
LockElements	获取锁定元素的集合。 (继承自 ConfigurationElement)
LockItem	获取或设置一个值，该值指示元素是否已锁定。 (继承自 ConfigurationElement)
Name	获取或设置此对象包含的对象组 ProfilePropertySettings 的名称。
Properties	获取属性的集合。 (继承自 ConfigurationElement)
PropertySettings	获取此对象包含的配置文件属性设置的集合。

方法

名称	说明
DeserializeElement(XmlReader, Boolean)	从配置文件中读取 XML。 (继承自 ConfigurationElement)
Equals(Object)	确定指定的 `Object` 值是否等于当前 `Object`。
GetHashCode()	获取表示当前 ConfigurationElement 实例的唯一值。
GetTransformedAssemblyString(String)	返回指定程序集名称的转换版本。 (继承自 ConfigurationElement)
GetTransformedTypeString(String)	返回指定类型名称的转换版本。 (继承自 ConfigurationElement)
GetType()	获取当前实例的 Type。 (继承自 Object)
Init()	将 ConfigurationElement 对象设置为其初始状态。 (继承自 ConfigurationElement)
InitializeDefault()	用于初始化对象的默认值 ConfigurationElement 集。 (继承自 ConfigurationElement)
IsModified()	指示在派生类中实现此配置元素自上次保存或加载以来是否已修改此配置元素。 (继承自 ConfigurationElement)
IsReadOnly()	获取一个值，该值指示对象 ConfigurationElement 是否为只读。 (继承自 ConfigurationElement)
ListErrors(IList)	将此 ConfigurationElement 对象和所有子元素中的无效属性错误添加到传递的列表。 (继承自 ConfigurationElement)
MemberwiseClone()	创建当前 Object的浅表副本。 (继承自 Object)
OnDeserializeUnrecognizedAttribute(String, String)	获取一个值，该值指示在反序列化期间是否遇到未知属性。 (继承自 ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	获取一个值，该值指示在反序列化期间是否遇到未知元素。 (继承自 ConfigurationElement)
OnRequiredPropertyNotFound(String)	在找不到所需属性时引发异常。 (继承自 ConfigurationElement)
PostDeserialize()	反序列化后调用。 (继承自 ConfigurationElement)
PreSerialize(XmlWriter)	在序列化之前调用。 (继承自 ConfigurationElement)
Reset(ConfigurationElement)	重置对象的内部状态 ConfigurationElement ，包括锁和属性集合。 (继承自 ConfigurationElement)
ResetModified()	将方法的值 IsModified() 重置为 `false` 在派生类中实现时的值。 (继承自 ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	在派生类中实现时，将此配置元素的内容写入配置文件。 (继承自 ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	在派生类中实现时，将此配置元素的外部标记写入配置文件。 (继承自 ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	将属性设置为指定的值。 (继承自 ConfigurationElement)
SetReadOnly()	IsReadOnly()设置对象和所有子元素的属性ConfigurationElement。 (继承自 ConfigurationElement)
ToString()	返回一个表示当前对象的字符串。 (继承自 Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	ConfigurationElement修改对象以删除不应保存的所有值。 (继承自 ConfigurationElement)

适用于

另请参阅

反馈

此页面是否有帮助？