ProfilePropertySettings 類別

定義

命名空間:

System.Web.Configuration

組件:

System.Web.dll

ProfilePropertySettings 類別 (Class) 提供以程式的方法，存取和修改組態檔的 profiles 區段。 此類別無法獲得繼承。

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

繼承

Object

ConfigurationElement

ProfilePropertySettings

範例

下列程式代碼範例示範如何存取 PropertySettings 屬性值，其中包含 物件的集合 ProfilePropertySettings 。 此程式代碼範例是針對 類別提供的較大範例的 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);
}

' 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

備註

類別 ProfilePropertySettings 提供一種方式，以程序設計方式建立、存取和修改新增至 properties 組態檔區段子 profile 區段的個別屬性定義。

組態檔的 區 profile 段會指定使用者配置檔的架構。 在執行時間，ASP.NET 編譯系統會使用 區段中指定 profile 的資訊來產生名為 ProfileCommon的類別，其衍生自 ProfileBase。 類別ProfileCommon定義是以組態檔區段子區段中profile定義的properties屬性為基礎。 系統會為每個使用者配置檔建立此類別的實例，而且您可以透過 HttpContext.Profile 屬性存取程式代碼中的個別配置檔值。 如需配置檔屬性的詳細資訊，請參閱 配置檔屬性概觀 ASP.NET。 如需新增至 ASP.NET 2.0 之配置檔功能的詳細資訊，請參閱 ASP.NET 配置檔屬性概觀。

建構函式

ProfilePropertySettings(String)	使用指定的名稱，初始化 ProfilePropertySettings 類別的新執行個體。
ProfilePropertySettings(String, Boolean, SerializationMode, String, String, String, Boolean, String)	使用指定的名稱和設定，初始化 ProfilePropertySettings 類別的新執行個體。

屬性

AllowAnonymous	取得或設定值，指出動態產生之 ProfileCommon 類別中的相關聯屬性是否可以由匿名使用者進行設定。
CurrentConfiguration	取得最上層 Configuration 執行個體的參考，這個執行個體表示目前 ConfigurationElement 執行個體所屬的組態階層架構。 (繼承來源 ConfigurationElement)
CustomProviderData	取得或設定設定檔屬性提供者的自訂資料字串。
DefaultValue	取得或設定預設值，用於動態產生之 ProfileCommon 類別中的相關聯屬性。
ElementInformation	取得 ElementInformation 物件，其中包含 ConfigurationElement 物件之不可自訂的資訊和功能。 (繼承來源 ConfigurationElement)
ElementProperty	取得表示 ConfigurationElementProperty 物件本身的 ConfigurationElement 物件。 (繼承來源 ConfigurationElement)
EvaluationContext	取得 ConfigurationElement 物件的 ContextInformation 物件。 (繼承來源 ConfigurationElement)
HasContext	取得值，指出 CurrentConfiguration 屬性是否為 null。 (繼承來源 ConfigurationElement)
Item[ConfigurationProperty]	取得或設定此組態項目的屬性 (Property) 或屬性 (Attribute)。 (繼承來源 ConfigurationElement)
Item[String]	取得或設定此一組態項目的屬性或子項目。 (繼承來源 ConfigurationElement)
LockAllAttributesExcept	取得已鎖定屬性的集合。 (繼承來源 ConfigurationElement)
LockAllElementsExcept	取得已鎖定項目的集合。 (繼承來源 ConfigurationElement)
LockAttributes	取得已鎖定屬性的集合。 (繼承來源 ConfigurationElement)
LockElements	取得已鎖定項目的集合。 (繼承來源 ConfigurationElement)
LockItem	取得或設定值，指出此項目是否已被鎖定。 (繼承來源 ConfigurationElement)
Name	取得或設定動態產生之 ProfileCommon 類別中相關聯屬性和 ProfilePropertySettings 物件的名稱。
Properties	取得屬性的集合。 (繼承來源 ConfigurationElement)
Provider	取得或設定提供者名稱，用於在序列化具名屬性。
ReadOnly	取得或設定值，判斷動態產生之 ProfileCommon 類別中的相關聯屬性是否是唯讀的。
SerializeAs	取得或設定序列化方法，用於動態產生之 ProfileCommon 類別中的相關聯屬性。
Type	取得或設定動態產生之 ProfileCommon 類別中相關聯屬性的型別名稱。

方法

DeserializeElement(XmlReader, Boolean)	從組態檔讀取 XML。 (繼承來源 ConfigurationElement)
Equals(Object)	將目前的 ConfigurationElement 執行個體與指定的物件相比較。 (繼承來源 ConfigurationElement)
GetHashCode()	取得表示目前 ConfigurationElement 執行個體的唯一值。 (繼承來源 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)	取得值，指出在還原序列化程序中是否遇到未知的屬性 (Attribute)。 (繼承來源 ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	取得值，指出在還原序列化程序中是否遇到未知的項目。 (繼承來源 ConfigurationElement)
OnRequiredPropertyNotFound(String)	在找不到必要的屬性時擲回例外狀況 (Exception)。 (繼承來源 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)

另請參閱

• ProfileSection
• PropertySettings
• ProfilePropertySettingsCollection