共用方式為


RootProfilePropertySettingsCollection 類別

定義

用做 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
繼承
屬性

範例

下列程式代碼範例示範如何使用 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 配置檔屬性

屬性PropertySettingsRootProfilePropertySettingsCollection 物件,其中包含組態檔區段子區段profileproperties定義的所有屬性。

建構函式

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

取得 ConfigurationElement 物件的 ContextInformation 物件。

(繼承來源 ConfigurationElement)
GroupSettings

取得 ProfileGroupSettingsCollection,包含 ProfileGroupSettings 物件的集合。

HasContext

取得值,指出 CurrentConfiguration 屬性是否為 null

(繼承來源 ConfigurationElement)
IsSynchronized

取得值,指出是否同步存取集合。

(繼承來源 ConfigurationElementCollection)
Item[ConfigurationProperty]

取得或設定此組態項目的屬性 (Property) 或屬性 (Attribute)。

(繼承來源 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 物件與另一個 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)

取得值,指出在還原序列化程序中是否遇到未知的屬性 (Attribute)。

(繼承來源 ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)

處理對組態檔中無法辨認組態項目的讀取動作,如果無法處理這些項目會導致組態系統擲回例外狀況。

(繼承來源 ProfilePropertySettingsCollection)
OnRequiredPropertyNotFound(String)

在找不到必要的屬性時擲回例外狀況 (Exception)。

(繼承來源 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

適用於

另請參閱