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	Возвращает значение, указывающее, является ли <чистый> элемент допустимым 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, Boolean)	Добавляет элемент конфигурации в коллекцию элементов конфигурации. (Унаследовано от ConfigurationElementCollection)
BaseAdd(ConfigurationElement)	Добавляет элемент конфигурации в ConfigurationElementCollectionэлемент . (Унаследовано от 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)

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

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

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

См. также раздел

Обратная связь

Были ли сведения на этой странице полезными?

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