RootProfilePropertySettingsCollection Класс

Ссылка

Определение

Пространство имен:: System.Web.Configuration

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Функционирует в качестве верхнего уровня двухуровневой именованной иерархии коллекций ProfilePropertySettingsCollection.

public ref class RootProfilePropertySettingsCollection sealed : System::Web::Configuration::ProfilePropertySettingsCollection

[System.Configuration.ConfigurationCollection(typeof(System.Web.Configuration.ProfilePropertySettings))]
public sealed class RootProfilePropertySettingsCollection : System.Web.Configuration.ProfilePropertySettingsCollection

[<System.Configuration.ConfigurationCollection(typeof(System.Web.Configuration.ProfilePropertySettings))>]
type RootProfilePropertySettingsCollection = class
    inherit ProfilePropertySettingsCollection

Public NotInheritable Class RootProfilePropertySettingsCollection
Inherits ProfilePropertySettingsCollection

Наследование: Object

ConfigurationElement

ConfigurationElementCollection

ProfilePropertySettingsCollection
RootProfilePropertySettingsCollection

Атрибуты: ConfigurationCollectionAttribute

Примеры

В следующем примере кода показано, как использовать RootProfilePropertySettingsCollection тип в PropertySettings качестве свойства ProfileSection класса . Этот пример входит в состав более крупного примера использования класса ProfileSection.


// 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);
}

// Get and modify a root ProfilePropertySettings object.
Console.WriteLine(
    "Display and modify 'LastReadDate' ProfilePropertySettings:");
ProfilePropertySettings profilePropertySettings =
    profileSection.PropertySettings["LastReadDate"];

// Get the current ReadOnly property value.
Console.WriteLine(
    "Current ReadOnly value: '{0}'", profilePropertySettings.ReadOnly);

// Set the ReadOnly property to true.
profilePropertySettings.ReadOnly = true;

// Get the current AllowAnonymous property value.
Console.WriteLine(
    "Current AllowAnonymous value: '{0}'", profilePropertySettings.AllowAnonymous);

// Set the AllowAnonymous property to true.
profilePropertySettings.AllowAnonymous = true;

// Get the current SerializeAs property value.
Console.WriteLine(
    "Current SerializeAs value: '{0}'", profilePropertySettings.SerializeAs);

// Set the SerializeAs property to SerializationMode.Binary.
profilePropertySettings.SerializeAs = SerializationMode.Binary;

// Get the current Type property value.
Console.WriteLine(
    "Current Type value: '{0}'", profilePropertySettings.Type);

// Set the Type property to "System.DateTime".
profilePropertySettings.Type = "System.DateTime";

// Get the current DefaultValue property value.
Console.WriteLine(
    "Current DefaultValue value: '{0}'", profilePropertySettings.DefaultValue);

// Set the DefaultValue property to "March 16, 2004".
profilePropertySettings.DefaultValue = "March 16, 2004";

// Get the current ProviderName property value.
Console.WriteLine(
    "Current ProviderName value: '{0}'", profilePropertySettings.Provider);

// Set the ProviderName property to "AspNetSqlRoleProvider".
profilePropertySettings.Provider = "AspNetSqlRoleProvider";

// Get the current Name property value.
Console.WriteLine(
    "Current Name value: '{0}'", profilePropertySettings.Name);

// Set the Name property to "LastAccessDate".
profilePropertySettings.Name = "LastAccessDate";

// Display all current ProfileGroupSettings.
Console.WriteLine("Current ProfileGroupSettings:");
int PGSCtr = 0;
foreach (ProfileGroupSettings propGroups in profileSection.PropertySettings.GroupSettings)
{
    Console.WriteLine("  {0}: ProfileGroupSetting '{1}'", ++PGSCtr,
        propGroups.Name);
    int PPSCtr = 0;
    foreach (ProfilePropertySettings props in propGroups.PropertySettings)
    {
        Console.WriteLine("    {0}: ProfilePropertySetting '{1}'", ++PPSCtr,
            props.Name);
    }
}

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



' 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

' Get and modify a root ProfilePropertySettings object.
Console.WriteLine( _
    "Display and modify 'LastReadDate' ProfilePropertySettings:")
Dim profilePropertySettings As ProfilePropertySettings = _
    profileSection.PropertySettings("LastReadDate")

' Get the current ReadOnly property value.
Console.WriteLine( _
    "Current ReadOnly value: '{0}'", profilePropertySettings.ReadOnly)

' Set the ReadOnly property to true.
profilePropertySettings.ReadOnly = true

' Get the current AllowAnonymous property value.
Console.WriteLine( _
    "Current AllowAnonymous value: '{0}'", profilePropertySettings.AllowAnonymous)

' Set the AllowAnonymous property to true.
profilePropertySettings.AllowAnonymous = true

' Get the current SerializeAs property value.
Console.WriteLine( _
    "Current SerializeAs value: '{0}'", profilePropertySettings.SerializeAs)

' Set the SerializeAs property to SerializationMode.Binary.
profilePropertySettings.SerializeAs = SerializationMode.Binary

' Get the current Type property value.
Console.WriteLine( _
    "Current Type value: '{0}'", profilePropertySettings.Type)

' Set the Type property to "System.DateTime".
profilePropertySettings.Type = "System.DateTime"

' Get the current DefaultValue property value.
Console.WriteLine( _
    "Current DefaultValue value: '{0}'", profilePropertySettings.DefaultValue)

' Set the DefaultValue property to "March 16, 2004".
profilePropertySettings.DefaultValue = "March 16, 2004"

' Get the current ProviderName property value.
            Console.WriteLine( _
                "Current ProviderName value: '{0}'", profilePropertySettings.Provider)

' Set the ProviderName property to "AspNetSqlRoleProvider".
            profilePropertySettings.Provider = "AspNetSqlRoleProvider"

' Get the current Name property value.
Console.WriteLine( _
    "Current Name value: '{0}'", profilePropertySettings.Name)

' Set the Name property to "LastAccessDate".
profilePropertySettings.Name = "LastAccessDate"

' Display all current ProfileGroupSettings.
Console.WriteLine("Current ProfileGroupSettings:")
Dim PGSCtr As Integer = 0
For Each propGroups As ProfileGroupSettings In profileSection.PropertySettings.GroupSettings
                    Console.WriteLine("  {0}: ProfileGroupSettings '{1}'", ++PGSCtr, _
        propGroups.Name)
    Dim PPSCtr As Integer = 0
    For Each props As ProfilePropertySettings In propGroups.PropertySettings
        Console.WriteLine("    {0}: ProfilePropertySetting '{1}'", ++PPSCtr, _
            props.Name)
    Next
Next

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

Класс RootProfilePropertySettingsCollection является коллекцией корневого уровня ProfilePropertySettingsCollection и контейнером ProfileGroupSettingsCollection для коллекции. Эти коллекции позволяют создавать именованные группы дополнительных ProfilePropertySettingsCollection коллекций, каждая из которых содержит отдельные именованные ProfilePropertySettings объекты. Дополнительные сведения о функциях профиля, добавленных в ASP.NET 2.0, см. в разделе Свойства профиля ASP.NET.

Свойство PropertySettings — это RootProfilePropertySettingsCollection объект, содержащий все свойства, определенные в properties подразделе profile раздела файла конфигурации.

Конструкторы

RootProfilePropertySettingsCollection()

Инициализирует новый экземпляр класса RootProfilePropertySettingsCollection значениями по умолчанию.

Свойства

AddElementName	Возвращает или устанавливает имя ConfigurationElement, связанное с операцией добавления в ConfigurationElementCollection после переопределения в производном классе. (Унаследовано от ConfigurationElementCollection)
AllKeys	Возврат массива, содержащего имена всех объектов ProfileSection, включенных в коллекцию. (Унаследовано от ProfilePropertySettingsCollection)
AllowClear	Возвращает значение, указывающее, допустим ли элемент <clear> как объект ProfilePropertySettings. (Унаследовано от ProfilePropertySettingsCollection)
ClearElementName	Возвращает или задает имя ConfigurationElement, связанное с операцией очистки в ConfigurationElementCollection после переопределения в производном классе. (Унаследовано от ConfigurationElementCollection)
CollectionType	Возвращает тип службы ConfigurationElementCollection. (Унаследовано от ConfigurationElementCollection)
Count	Получает количество элементов коллекции. (Унаследовано от ConfigurationElementCollection)
CurrentConfiguration	Возвращает ссылку на экземпляр Configuration верхнего уровня, представляющий иерархию конфигурации, к которой относится текущий экземпляр ConfigurationElement. (Унаследовано от ConfigurationElement)
ElementInformation	Возвращает объект ElementInformation, содержащий неизменяемую информацию и функциональность объекта ConfigurationElement. (Унаследовано от ConfigurationElement)
ElementName	Получает имя, используемое для данной коллекции элементов в файле конфигурации после переопределения в производном классе. (Унаследовано от ConfigurationElementCollection)
ElementProperty	Возвращает объект ConfigurationElementProperty, представляющий сам объект ConfigurationElement. (Унаследовано от ConfigurationElement)
EmitClear	Получает или задает значение, указывающее, была ли коллекция очищена. (Унаследовано от ConfigurationElementCollection)
EvaluationContext	Возвращает объект ContextInformation для объекта ConfigurationElement. (Унаследовано от ConfigurationElement)
GroupSettings	Получает ProfileGroupSettingsCollection, содержащий коллекцию объектов ProfileGroupSettings.
HasContext	Возвращает значение, указывающее, имеет ли свойство CurrentConfiguration значение `null`. (Унаследовано от ConfigurationElement)
IsSynchronized	Возвращает значение, показывающее, синхронизирован ли доступ к коллекции. (Унаследовано от ConfigurationElementCollection)
Item[ConfigurationProperty]	Возвращает или задает свойство или атрибут данного элемента конфигурации. (Унаследовано от ConfigurationElement)
Item[Int32]	Получает или задает объект ProfilePropertySettings по указанному индексу. (Унаследовано от ProfilePropertySettingsCollection)
Item[String]	Получает или задает объект ProfilePropertySettings с заданным именем. (Унаследовано от ProfilePropertySettingsCollection)
LockAllAttributesExcept	Возвращает коллекцию заблокированных атрибутов. (Унаследовано от ConfigurationElement)
LockAllElementsExcept	Возвращает коллекцию заблокированных элементов. (Унаследовано от ConfigurationElement)
LockAttributes	Возвращает коллекцию заблокированных атрибутов. (Унаследовано от ConfigurationElement)
LockElements	Возвращает коллекцию заблокированных элементов. (Унаследовано от ConfigurationElement)
LockItem	Возвращает или задает значение, указывающее, заблокирован ли элемент. (Унаследовано от ConfigurationElement)
Properties	Возвращает коллекцию свойств конфигурации. (Унаследовано от ProfilePropertySettingsCollection)
RemoveElementName	Получает или задает имя ConfigurationElement, связанное с операцией удаления в ConfigurationElementCollection после переопределения в производном классе. (Унаследовано от ConfigurationElementCollection)
SyncRoot	Получает объект, используемый для синхронизации доступа к ConfigurationElementCollection. (Унаследовано от ConfigurationElementCollection)
ThrowOnDuplicate	Возврат значения, определяющего необходимость создания ошибки при попытке создания дублирующего объекта. (Унаследовано от ProfilePropertySettingsCollection)

Методы

Add(ProfilePropertySettings)	Добавляет объект ProfilePropertySettings в коллекцию. (Унаследовано от ProfilePropertySettingsCollection)
BaseAdd(ConfigurationElement)	Добавляет новый элемент конфигурации в ConfigurationElementCollection. (Унаследовано от ConfigurationElementCollection)
BaseAdd(ConfigurationElement, Boolean)	Добавляет элемент конфигурации в коллекцию элементов конфигурации. (Унаследовано от ConfigurationElementCollection)
BaseAdd(Int32, ConfigurationElement)	Добавляет элемент конфигурации в коллекцию элементов конфигурации. (Унаследовано от ConfigurationElementCollection)
BaseClear()	Удаляет все объекты элементов конфигурации из коллекции. (Унаследовано от ConfigurationElementCollection)
BaseGet(Int32)	Возвращает элемент конфигурации с указанным расположением индекса. (Унаследовано от ConfigurationElementCollection)
BaseGet(Object)	Возвращает элемент конфигурации с указанным ключом. (Унаследовано от ConfigurationElementCollection)
BaseGetAllKeys()	Возвращает массив ключей для всех элементов конфигурации, содержащихся в ConfigurationElementCollection. (Унаследовано от ConfigurationElementCollection)
BaseGetKey(Int32)	Получает ключ объекта ConfigurationElement по указанному расположению индекса. (Унаследовано от ConfigurationElementCollection)
BaseIndexOf(ConfigurationElement)	Указывает индекс заданного объекта ConfigurationElement. (Унаследовано от ConfigurationElementCollection)
BaseIsRemoved(Object)	Указывает, удален ли ConfigurationElement с указанным ключом из ConfigurationElementCollection. (Унаследовано от ConfigurationElementCollection)
BaseRemove(Object)	Удаляет объект ConfigurationElement из коллекции. (Унаследовано от ConfigurationElementCollection)
BaseRemoveAt(Int32)	Удаляет объект ConfigurationElement по указанному расположению индекса. (Унаследовано от ConfigurationElementCollection)
Clear()	Удаляет все объекты ProfilePropertySettings из коллекции. (Унаследовано от ProfilePropertySettingsCollection)
CopyTo(ConfigurationElement[], Int32)	Копирует содержимое объекта ConfigurationElementCollection в массив. (Унаследовано от ConfigurationElementCollection)
CreateNewElement()	При переопределении в производном классе создает новый объект ConfigurationElement. (Унаследовано от ProfilePropertySettingsCollection)
CreateNewElement(String)	При переопределении в производном классе создает новый элемент ConfigurationElement. (Унаследовано от ConfigurationElementCollection)
DeserializeElement(XmlReader, Boolean)	Считывает XML из файла конфигурации. (Унаследовано от ConfigurationElement)
Equals(Object)	Сравнивает текущий объект RootProfilePropertySettingsCollection с другим объектом A RootProfilePropertySettingsCollection.
Get(Int32)	Возвращает объект ProfileSection, расположенный по заданному индексу. (Унаследовано от ProfilePropertySettingsCollection)
Get(String)	Возвращает объект ProfileSection с указанным именем. (Унаследовано от ProfilePropertySettingsCollection)
GetElementKey(ConfigurationElement)	Возврат ключа для заданного элемента конфигурации. (Унаследовано от ProfilePropertySettingsCollection)
GetEnumerator()	Получает метод IEnumerator, используемый для итерации по ConfigurationElementCollection. (Унаследовано от ConfigurationElementCollection)
GetHashCode()	Создает хэш-код для коллекции.
GetKey(Int32)	Возврат имени объекта ProfilePropertySettings, расположенного в позиции с заданным индексом. (Унаследовано от ProfilePropertySettingsCollection)
GetTransformedAssemblyString(String)	Возвращает преобразованную версию указанного имени сборки. (Унаследовано от ConfigurationElement)
GetTransformedTypeString(String)	Возвращает преобразованную версию указанного имени типа. (Унаследовано от ConfigurationElement)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
IndexOf(ProfilePropertySettings)	Возвращает индекс указанного объекта ProfilePropertySettings. (Унаследовано от ProfilePropertySettingsCollection)
Init()	Задает объект ConfigurationElement в исходное состояние. (Унаследовано от ConfigurationElement)
InitializeDefault()	Используется для инициализации набора значений по умолчанию для объекта ConfigurationElement. (Унаследовано от ConfigurationElement)
IsElementName(String)	Указывает, существует ли указанный ConfigurationElement в ConfigurationElementCollection. (Унаследовано от ConfigurationElementCollection)
IsElementRemovable(ConfigurationElement)	Указывает, может ли указанный объект ConfigurationElement быть удален из ConfigurationElementCollection. (Унаследовано от ConfigurationElementCollection)
IsModified()	Указывает, был ли изменен ConfigurationElementCollection с момента последнего сохранения или загрузки после переопределения в производном классе. (Унаследовано от ConfigurationElementCollection)
IsReadOnly()	Указывает, доступен ли объект ConfigurationElementCollection только для чтения. (Унаследовано от ConfigurationElementCollection)
ListErrors(IList)	Добавляет ошибку "недействительное свойство" в данном объекте ConfigurationElement и всех его дочерних элементах к переданному списку. (Унаследовано от ConfigurationElement)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
OnDeserializeUnrecognizedAttribute(String, String)	Возвращает значение, указывающее, встретился ли неизвестный атрибут при десериализации. (Унаследовано от ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Чтение нераспознанных элементов конфигурации из файла конфигурации и создание исключения системы конфигурации, если обработка элемента невозможна. (Унаследовано от ProfilePropertySettingsCollection)
OnRequiredPropertyNotFound(String)	Выдает исключение, если требуемое свойство не найдено. (Унаследовано от ConfigurationElement)
PostDeserialize()	Вызывается после десериализации. (Унаследовано от ConfigurationElement)
PreSerialize(XmlWriter)	Вызывается до сериализации. (Унаследовано от ConfigurationElement)
Remove(String)	Удаляет объект ProfilePropertySettings из коллекции. (Унаследовано от ProfilePropertySettingsCollection)
RemoveAt(Int32)	Удаление объекта ProfilePropertySettings из коллекции в заданном месте индекса. (Унаследовано от ProfilePropertySettingsCollection)
Reset(ConfigurationElement)	Сбрасывает ConfigurationElementCollection в неизмененное состояние после переопределения в производном классе. (Унаследовано от ConfigurationElementCollection)
ResetModified()	Переустанавливает значение свойства IsModified() в `false` при переопределении в производном классе. (Унаследовано от ConfigurationElementCollection)
SerializeElement(XmlWriter, Boolean)	Записывает данные конфигурации в XML-элемент в файле конфигурации после переопределения в производном классе. (Унаследовано от ConfigurationElementCollection)
SerializeToXmlElement(XmlWriter, String)	Записывает внешние теги данного элемента конфигурации в файл конфигурации при реализации в производном классе. (Унаследовано от ConfigurationElement)
Set(ProfilePropertySettings)	Добавляет указанный объект ProfilePropertySettings в коллекцию. (Унаследовано от ProfilePropertySettingsCollection)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Задает для свойства указанное значение. (Унаследовано от ConfigurationElement)
SetReadOnly()	Устанавливает свойство IsReadOnly() для объекта ConfigurationElementCollection и всех подчиненных элементов. (Унаследовано от ConfigurationElementCollection)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Отменяет эффект слияния данных конфигурации на разных уровнях иерархии конфигурации. (Унаследовано от ConfigurationElementCollection)

Явные реализации интерфейса

ICollection.CopyTo(Array, Int32)

Копирует ConfigurationElementCollection в массив.

(Унаследовано от ConfigurationElementCollection)

Методы расширения

Cast<TResult>(IEnumerable)	Приводит элементы объекта IEnumerable к заданному типу.
OfType<TResult>(IEnumerable)	Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.
AsParallel(IEnumerable)	Позволяет осуществлять параллельный запрос.
AsQueryable(IEnumerable)	Преобразовывает коллекцию IEnumerable в объект IQueryable.

Применяется к

Поделиться через