PropertyInformation 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
包含配置中個別屬性的元資訊。 這種類型無法遺傳。
public ref class PropertyInformation sealed
public sealed class PropertyInformation
type PropertyInformation = class
Public NotInheritable Class PropertyInformation
- 繼承
-
PropertyInformation
範例
以下程式碼範例示範如何使用該 PropertyInformation 型別。
#region Using directives
using System;
using System.Collections.Generic;
using System.Text;
using System.Configuration;
using System.Web;
using System.Web.Configuration;
#endregion
namespace Samples.ConfigurationExamples
{
class UsingPropertyInformation
{
static void Main(string[] args)
{
try
{
// Set the path of the config file.
string configPath = "";
// Get the Web application configuration object.
Configuration config =
WebConfigurationManager.OpenWebConfiguration(configPath);
// Get the section related object.
AnonymousIdentificationSection configSection =
(AnonymousIdentificationSection)config.GetSection
("system.web/anonymousIdentification");
// Display title.
Console.WriteLine("Configuration PropertyInformation");
Console.WriteLine("Section: anonymousIdentification");
// Instantiate a new PropertyInformationCollection object.
PropertyInformationCollection propCollection =
configSection.ElementInformation.Properties;
// Display Collection Count.
Console.WriteLine("Collection Count: {0}",
propCollection.Count);
// Display properties of elements
// of the PropertyInformationCollection.
foreach (PropertyInformation propertyItem in propCollection)
{
Console.WriteLine();
Console.WriteLine("Property Details:");
// Display the Name property.
Console.WriteLine("Name: {0}", propertyItem.Name);
// Display the Value property.
Console.WriteLine("Value: {0}", propertyItem.Value);
// Display the DefaultValue property.
Console.WriteLine("DefaultValue: {0}",
propertyItem.DefaultValue);
// Display the Type property.
Console.WriteLine("Type: {0}", propertyItem.Type);
// Display the IsKey property.
Console.WriteLine("IsKey: {0}", propertyItem.IsKey);
// Display the IsLocked property.
Console.WriteLine("IsLocked: {0}", propertyItem.IsLocked);
// Display the IsModified property.
Console.WriteLine("IsModified: {0}", propertyItem.IsModified);
// Display the IsRequired property.
Console.WriteLine("IsRequired: {0}", propertyItem.IsRequired);
// Display the LineNumber property.
Console.WriteLine("LineNumber: {0}", propertyItem.LineNumber);
// Display the Source property.
Console.WriteLine("Source: {0}", propertyItem.Source);
// Display the Validator property.
Console.WriteLine("Validator: {0}", propertyItem.Validator);
// Display the ValueOrigin property.
Console.WriteLine("ValueOrigin: {0}", propertyItem.ValueOrigin);
}
Console.WriteLine("");
Console.WriteLine("Configuration - Accessing an Attribute");
// Create EllementInformation object.
ElementInformation elementInfo =
configSection.ElementInformation;
// Create a PropertyInformationCollection object.
PropertyInformationCollection propertyInfoCollection =
elementInfo.Properties;
// Create a PropertyInformation object.
PropertyInformation myPropertyInfo =
propertyInfoCollection["enabled"];
// Display the property value.
Console.WriteLine
("anonymousIdentification Section - Enabled: {0}",
myPropertyInfo.Value);
}
catch (Exception e)
{
// Error.
Console.WriteLine(e.ToString());
}
// Display and wait.
Console.ReadLine();
}
}
}
Imports System.Collections.Generic
Imports System.Text
Imports System.Configuration
Imports System.Web
Imports System.Web.Configuration
Namespace Samples.ConfigurationExamples
Class UsingPropertyInformation
Public Shared Sub Main()
Try
' Set the path of the config file.
Dim configPath As String = ""
' Get the Web application configuration object.
Dim config As Configuration = _
WebConfigurationManager.OpenWebConfiguration(configPath)
' Get the section related object.
Dim configSection As AnonymousIdentificationSection = _
CType(config.GetSection("system.web/anonymousIdentification"), _
AnonymousIdentificationSection)
' Display title.
Console.WriteLine("Configuration PropertyInformation")
Console.WriteLine("Section: anonymousIdentification")
' Instantiate a new PropertyInformationCollection object.
Dim propCollection As PropertyInformationCollection = _
configSection.ElementInformation.Properties()
' Display Collection Count.
Console.WriteLine("Collection Count: {0}", _
propCollection.Count)
' Display properties of elements
' of the PropertyInformationCollection.
For Each propertyItem As PropertyInformation In propCollection
Console.WriteLine()
Console.WriteLine("Property Details:")
' Display the Name property.
Console.WriteLine("Name: {0}", propertyItem.Name)
' Display the Value property.
Console.WriteLine("Value: {0}", propertyItem.Value)
' Display the DefaultValue property.
Console.WriteLine("DefaultValue: {0}", _
propertyItem.DefaultValue) _
' Display the Type property.
Console.WriteLine("Type: {0}", propertyItem.Type)
' Display the IsKey property.
Console.WriteLine("IsKey: {0}", propertyItem.IsKey)
' Display the IsLocked property.
Console.WriteLine("IsLocked: {0}", propertyItem.IsLocked)
' Display the IsModified property.
Console.WriteLine("IsModified: {0}", propertyItem.IsModified)
' Display the IsRequired property.
Console.WriteLine("IsRequired: {0}", propertyItem.IsRequired)
' Display the LineNumber property.
Console.WriteLine("LineNumber: {0}", propertyItem.LineNumber)
' Display the Source property.
Console.WriteLine("Source: {0}", propertyItem.Source)
' Display the Validator property.
Console.WriteLine("Validator: {0}", propertyItem.Validator)
' Display the ValueOrigin property.
Console.WriteLine("ValueOrigin: {0}", propertyItem.ValueOrigin)
Next
Console.WriteLine("")
Console.WriteLine("Configuration - Accessing an Attribute")
' Create EllementInformation object.
Dim elementInfo As ElementInformation = _
configSection.ElementInformation()
' Create a PropertyInformationCollection object.
Dim propertyInfoCollection As PropertyInformationCollection = _
elementInfo.Properties()
' Create a PropertyInformation object.
Dim myPropertyInfo As PropertyInformation = _
propertyInfoCollection("enabled")
' Display the property value.
Console.WriteLine _
("anonymousIdentification Section - Enabled: {0}", _
myPropertyInfo.Value)
Catch e As Exception
' Error.
Console.WriteLine("Error: {0}", _
e.Message.ToString())
End Try
' Display and wait.
Console.ReadLine()
End Sub
End Class
End Namespace
備註
物件 PropertyInformation 包含配置中單一屬性的元資訊。 此物件可用於驗證及變更單一屬性的屬性。
物件 PropertyInformation 是從所對應 PropertyInformationCollection 的物件衍生而來的。 物件 PropertyInformationCollection 是從所對應 ElementInformation 的物件衍生而來的。
屬性
| 名稱 | Description |
|---|---|
| Converter |
取得 TypeConverter 與設定屬性相關的物件。 |
| DefaultValue |
會取得一個包含與設定屬性相關預設值的物件。 |
| Description |
取得對應於設定屬性的物件描述。 |
| IsKey |
會取得一個值來指定該組態屬性是否為鍵。 |
| IsLocked |
會取得一個值,指定該組態屬性是否被鎖定。 |
| IsModified |
會取得一個值,指定設定屬性是否被修改。 |
| IsRequired |
會取得一個值,指定是否需要該設定屬性。 |
| LineNumber |
取得與設定屬性相關的組建檔行號。 |
| Name |
取得對應組態屬性的物件名稱。 |
| Source |
取得對應於設定屬性的原始檔案。 |
| Type |
取得對應於配置屬性的物件的 。Type |
| Validator |
取得 ConfigurationValidatorBase 與設定屬性相關的物件。 |
| Value |
取得或設定包含與組態屬性相關值的物件。 |
| ValueOrigin |
取得 PropertyValueOrigin 與設定屬性相關的物件。 |
方法
| 名稱 | Description |
|---|---|
| Equals(Object) |
判斷指定的物件是否等於目前的物件。 (繼承來源 Object) |
| GetHashCode() |
做為預設哈希函式。 (繼承來源 Object) |
| GetType() |
取得目前實例的 Type。 (繼承來源 Object) |
| MemberwiseClone() |
建立目前 Object的淺層複本。 (繼承來源 Object) |
| ToString() |
傳回表示目前 物件的字串。 (繼承來源 Object) |