System.Configuration Namespace

System.Configuration 命名空間包含型別,提供用來處理組態資料的程式撰寫模型。 The System.Configuration namespace contains the types that provide the programming model for handling configuration data.

類別

ApplicationScopedSettingAttribute

指定應用程式設定屬性對於應用程式的所有使用者具有通用值。Specifies that an application settings property has a common value for all users of an application. 這個類別無法被繼承。This class cannot be inherited.

ApplicationSettingsBase

做為衍生實體包裝函式類別的基底類別,以實作 Windows Form 應用程式中的應用程式設定功能。Acts as a base class for deriving concrete wrapper classes to implement the application settings feature in Window Forms applications.

ApplicationSettingsGroup

表示組態檔中的相關應用程式設定區段群組。Represents a grouping of related application settings sections within a configuration file. 這個類別無法被繼承。This class cannot be inherited.

AppSettingsReader

提供從組態讀取特定型別值的方法。Provides a method for reading values of a particular type from the configuration.

AppSettingsSection

提供 appSettings 組態區段的組態系統支援。Provides configuration system support for the appSettings configuration section. 這個類別無法被繼承。This class cannot be inherited.

CallbackValidator

提供物件的動態驗證。Provides dynamic validation of an object.

CallbackValidatorAttribute

指定要用於程式碼驗證的 CallbackValidator 物件。Specifies a CallbackValidator object to use for code validation. 這個類別無法被繼承。This class cannot be inherited.

ClientSettingsSection

表示組態檔中使用者範圍的應用程式設定群組。Represents a group of user-scoped application settings in a configuration file.

CommaDelimitedStringCollection

表示以逗號分隔字串項目的集合。Represents a collection of string elements separated by commas. 這個類別無法被繼承。This class cannot be inherited.

CommaDelimitedStringCollectionConverter

將逗號分隔的字串值和 CommaDelimitedStringCollection 物件相互轉換。Converts a comma-delimited string value to and from a CommaDelimitedStringCollection object. 這個類別無法被繼承。This class cannot be inherited.

Configuration

表示特定電腦、應用程式或資源所適用的組態檔。Represents a configuration file that is applicable to a particular computer, application, or resource. 這個類別無法被繼承。This class cannot be inherited.

ConfigurationBuilder

表示由自訂設定產生器實作擴充的基底類別。Represents the base class to be extended by custom configuration builder implementations.

ConfigurationBuilderCollection

依名稱維護 ConfigurationBuilder 物件的集合。Maintains a collection of ConfigurationBuilder objects by name.

ConfigurationBuilderSettings

代表一組設定項目,設定 <configBuilders> 設定區段的提供者。Represents a group of configuration elements that configure the providers for the <configBuilders> configuration section.

ConfigurationBuildersSection

可讓您以程式設計方式存取 <configBuilders> 區段。Provides programmatic access to the <configBuilders> section. 無法繼承此類別。This class can't be inherited.

ConfigurationCollectionAttribute

以宣告方式指示 .NET Framework 建立組態項目集合的執行個體 (Instance)。Declaratively instructs the .NET Framework to create an instance of a configuration element collection. 這個類別無法被繼承。This class cannot be inherited.

ConfigurationConverterBase

組態轉換子型別的基底類別。The base class for the configuration converter types.

ConfigurationElement

表示組態檔內的組態項目。Represents a configuration element within a configuration file.

ConfigurationElementCollection

代表包含子項目集合的設定項目。Represents a configuration element containing a collection of child elements.

ConfigurationElementProperty

指定組態項目的屬性。Specifies the property of a configuration element. 這個類別無法被繼承。This class cannot be inherited.

ConfigurationErrorsException

發生組態錯誤時所擲回的例外狀況。The exception that is thrown when a configuration error has occurred.

ConfigurationException

發生組態系統錯誤時所擲回的例外狀況。The exception that is thrown when a configuration system error has occurred.

ConfigurationFileMap

定義電腦組態檔的組態檔對應。Defines the configuration file mapping for the machine configuration file.

ConfigurationLocation

表示組態檔內的 location 項目。Represents a location element within a configuration file.

ConfigurationLocationCollection

包含 ConfigurationLocationCollection 物件的集合。Contains a collection of ConfigurationLocationCollection objects.

ConfigurationLockCollection

包含鎖定的組態物件的集合。Contains a collection of locked configuration objects. 這個類別無法被繼承。This class cannot be inherited.

ConfigurationManager

提供用戶端應用程式的組態檔存取。Provides access to configuration files for client applications. 這個類別無法被繼承。This class cannot be inherited.

ConfigurationPermission

提供允許方法或類別存取組態檔的使用權限結構。Provides a permission structure that allows methods or classes to access configuration files.

ConfigurationPermissionAttribute

建立會授與或拒絕組態檔存取區段之標記目標使用權限的 ConfigurationPermission 物件。Creates a ConfigurationPermission object that either grants or denies the marked target permission to access sections of configuration files.

ConfigurationProperty

代表屬性或組態項目的子系。Represents an attribute or a child of a configuration element. 這個類別無法被繼承。This class cannot be inherited.

ConfigurationPropertyAttribute

以宣告方式指示 .NET Framework 為組態屬性執行個體化。Declaratively instructs the .NET Framework to instantiate a configuration property. 這個類別無法被繼承。This class cannot be inherited.

ConfigurationPropertyCollection

表示組態項目屬性的集合。Represents a collection of configuration-element properties.

ConfigurationSection

代表組態檔中的區段。Represents a section within a configuration file.

ConfigurationSectionCollection

代表組態檔內相關區段的集合。Represents a collection of related sections within a configuration file.

ConfigurationSectionGroup

表示組態檔內相關的區段群組。Represents a group of related sections within a configuration file.

ConfigurationSectionGroupCollection

表示 ConfigurationSectionGroup 物件的集合。Represents a collection of ConfigurationSectionGroup objects.

ConfigurationSettings

提供讀取組態區段和一般組態設定的執行階段 1.0 和 1.1 版支援。Provides runtime versions 1.0 and 1.1 support for reading configuration sections and common configuration settings.

ConfigurationValidatorAttribute

做為 System.Configuration 驗證程式屬性型別的基底類別。Serves as the base class for the System.Configuration validator attribute types.

ConfigurationValidatorBase

當做衍生驗證類別的基底類別,以便可以驗證物件的值。Acts as a base class for deriving a validation class so that a value of an object can be verified.

ConfigXmlDocument

包裝對應的 XmlDocument 類型,並帶有報告檔案名稱和行號的必要資訊。Wraps the corresponding XmlDocument type and also carries the necessary information for reporting file-name and line numbers.

ConnectionStringSettings

表示連接字串的組態檔區段中的單一具名連接字串。Represents a single, named connection string in the connection strings configuration file section.

ConnectionStringSettingsCollection

包含 ConnectionStringSettings 物件的集合。Contains a collection of ConnectionStringSettings objects.

ConnectionStringsSection

提供程式方式來存取連接字串組態檔區段。Provides programmatic access to the connection strings configuration-file section.

ContextInformation

封裝與 ConfigurationElement 物件有關的內容資訊。Encapsulates the context information that is associated with a ConfigurationElement object. 這個類別無法被繼承。This class cannot be inherited.

DefaultSection

表示會公開組態區段 XML 供讀取和寫入存取的基本組態區段處理常式。Represents a basic configuration-section handler that exposes the configuration section's XML for both read and write access.

DefaultSettingValueAttribute

指定應用程式設定屬性的預設值。Specifies the default value for an application settings property.

DefaultValidator

提供物件的驗證。Provides validation of an object. 這個類別無法被繼承。This class cannot be inherited.

DictionarySectionHandler

提供來自組態區段的索引鍵 / 值組之組態資訊。Provides key/value pair configuration information from a configuration section.

DpapiProtectedConfigurationProvider

提供 ProtectedConfigurationProvider 物件,該物件使用 Windows 資料保護 API (DPAPI),加密和解密組態資料。Provides a ProtectedConfigurationProvider object that uses the Windows data protection API (DPAPI) to encrypt and decrypt configuration data.

ElementInformation

包含組態內與個別項目有關的中繼資訊。Contains meta-information about an individual element within the configuration. 這個類別無法被繼承。This class cannot be inherited.

ExeConfigurationFileMap

定義 .exe 應用程式的組態檔對應。Defines the configuration file mapping for an .exe application. 這個類別無法被繼承。This class cannot be inherited.

ExeContext

管理目前應用程式的路徑內容。Manages the path context for the current application. 這個類別無法被繼承。This class cannot be inherited.

GenericEnumConverter

在字串和列舉型別之間轉換。Converts between a string and an enumeration type.

IdnElement

Uri 類別中提供 International Domain Name (IDN) 處理的組態設定。Provides the configuration setting for International Domain Name (IDN) processing in the Uri class.

IgnoreSection

針對 System.Configuration 型別所未處理的組態區段提供包裝函式型別定義。Provides a wrapper type definition for configuration sections that are not handled by the System.Configuration types.

IgnoreSectionHandler

針對 System.Configuration 型別所未處理的組態區段提供舊版區段處理常式定義。Provides a legacy section-handler definition for configuration sections that are not handled by the System.Configuration types.

InfiniteIntConverter

在字串以及標準無限或整數值之間轉換。Converts between a string and the standard infinite or integer value.

InfiniteTimeSpanConverter

在字串以及標準無限 TimeSpan 值之間轉換。Converts between a string and the standard infinite TimeSpan value.

IntegerValidator

提供 Int32 值的驗證。Provides validation of an Int32 value.

IntegerValidatorAttribute

以宣告方式指示 .NET Framework 在組態屬性上執行整數驗證。Declaratively instructs the .NET Framework to perform integer validation on a configuration property. 這個類別無法被繼承。This class cannot be inherited.

IriParsingElement

Uri 類別中提供 International Resource Identifier (IRI) 處理的組態設定。Provides the configuration setting for International Resource Identifier (IRI) processing in the Uri class.

KeyValueConfigurationCollection

包含 KeyValueConfigurationElement 物件的集合。Contains a collection of KeyValueConfigurationElement objects.

KeyValueConfigurationElement

表示包含索引鍵/值組的組態項目。Represents a configuration element that contains a key/value pair.

LocalFileSettingsProvider

提供應用程式設定類別的持續性 (Persistence)。Provides persistence for application settings classes.

LongValidator

提供 Int64 值的驗證。Provides validation of an Int64 value.

LongValidatorAttribute

以宣告方式指示 .NET Framework 在組態屬性上執行長整數驗證。Declaratively instructs the .NET Framework to perform long-integer validation on a configuration property. 這個類別無法被繼承。This class cannot be inherited.

NameValueConfigurationCollection

包含 NameValueConfigurationElement 物件的集合。Contains a collection of NameValueConfigurationElement objects. 這個類別無法被繼承。This class cannot be inherited.

NameValueConfigurationElement

包含 String 名稱和 String 值的組態項目。A configuration element that contains a String name and String value. 這個類別無法被繼承。This class cannot be inherited.

NameValueFileSectionHandler

提供對組態檔的存取。Provides access to a configuration file. 這個型別支援 .NET Framework 組態基礎結構,且其目的不是要直接從您的程式碼中使用。This type supports the .NET Framework configuration infrastructure and is not intended to be used directly from your code.

NameValueSectionHandler

提供來自組態區段的名稱 / 值組之組態資訊。Provides name/value-pair configuration information from a configuration section.

NoSettingsVersionUpgradeAttribute

指定設定提供者應停用偵測到應用程式升級時叫用的任何邏輯。Specifies that a settings provider should disable any logic that gets invoked when an application upgrade is detected. 這個類別無法被繼承。This class cannot be inherited.

PositiveTimeSpanValidator

提供 TimeSpan 物件的驗證。Provides validation of a TimeSpan object. 這個類別無法被繼承。This class cannot be inherited.

PositiveTimeSpanValidatorAttribute

以宣告方式指示 .NET Framework 在組態屬性上執行時間驗證。Declaratively instructs the .NET Framework to perform time validation on a configuration property. 這個類別無法被繼承。This class cannot be inherited.

PropertyInformation

包含組態內與個別屬性有關的中繼資訊。Contains meta-information on an individual property within the configuration. 這個型別無法被繼承。This type cannot be inherited.

PropertyInformationCollection

包含 PropertyInformation 物件的集合。Contains a collection of PropertyInformation objects. 這個類別無法被繼承。This class cannot be inherited.

ProtectedConfiguration

提供對目前應用程式之組態檔的受保護組態提供者的存取權。Provides access to the protected-configuration providers for the current application's configuration file.

ProtectedConfigurationProvider

為基底類別,用來建立提供者,以加密和解密受保護的組態資料。Is the base class to create providers for encrypting and decrypting protected-configuration data.

ProtectedConfigurationProviderCollection

提供 ProtectedConfigurationProvider 物件的集合。Provides a collection of ProtectedConfigurationProvider objects.

ProtectedConfigurationSection

提供對 configProtectedData 組態區段的程式方式存取。Provides programmatic access to the configProtectedData configuration section. 這個類別無法被繼承。This class cannot be inherited.

ProtectedProviderSettings

代表一組設定項目,設定 <configProtectedData> 設定區段的提供者。Represents a group of configuration elements that configure the providers for the <configProtectedData> configuration section.

ProviderSettings

表示與提供者關聯的組態項目。Represents the configuration elements associated with a provider.

ProviderSettingsCollection

表示 ProviderSettings 物件的集合。Represents a collection of ProviderSettings objects.

RegexStringValidator

根據規則運算式所提供的規則來提供字串的驗證。Provides validation of a string based on the rules provided by a regular expression.

RegexStringValidatorAttribute

以宣告方式指示 .NET Framework 在組態屬性上利用規則運算式執行字串驗證。Declaratively instructs the .NET Framework to perform string validation on a configuration property using a regular expression. 這個類別無法被繼承。This class cannot be inherited.

RsaProtectedConfigurationProvider

提供 ProtectedConfigurationProvider 執行個體,可使用 RSA 加密來加密和解密組態資料。Provides a ProtectedConfigurationProvider instance that uses RSA encryption to encrypt and decrypt configuration data.

SchemeSettingElement

表示 SchemeSettingElementCollection 類別中的項目。Represents an element in a SchemeSettingElementCollection class.

SchemeSettingElementCollection

表示 SchemeSettingElement 物件的集合。Represents a collection of SchemeSettingElement objects.

SectionInformation

包含與組態階層架構內個別區段有關的中繼資料。Contains metadata about an individual section within the configuration hierarchy. 這個類別無法被繼承。This class cannot be inherited.

SettingAttribute

表示用來將設定資訊與設定屬性 (Property) 產生關聯的自訂設定屬性 (Attribute)。Represents a custom settings attribute used to associate settings information with a settings property.

SettingChangingEventArgs

提供 SettingChanging 事件的資料。Provides data for the SettingChanging event.

SettingElement

表示用來更新組態中項目的簡化組態項目。Represents a simplified configuration element used for updating elements in the configuration. 這個類別無法被繼承。This class cannot be inherited.

SettingElementCollection

包含 SettingElement 物件的集合。Contains a collection of SettingElement objects. 這個類別無法被繼承。This class cannot be inherited.

SettingsAttributeDictionary

表示用來描述組態物件以及 SettingsProperty 物件的索引鍵 / 值組的集合。Represents a collection of key/value pairs used to describe a configuration object as well as a SettingsProperty object.

SettingsBase

提供用來支援使用者屬性設定的基底類別。Provides the base class used to support user property settings.

SettingsContext

提供提供者在保存設定時可以使用的內容資訊。Provides contextual information that the provider can use when persisting settings.

SettingsDescriptionAttribute

提供描述個別組態屬性的字串。Provides a string that describes an individual configuration property. 這個類別無法被繼承。This class cannot be inherited.

SettingsGroupDescriptionAttribute

提供描述應用程式設定屬性群組的字串。Provides a string that describes an application settings property group. 這個類別無法被繼承。This class cannot be inherited.

SettingsGroupNameAttribute

指定應用程式設定屬性群組的名稱。Specifies a name for application settings property group. 這個類別無法被繼承。This class cannot be inherited.

SettingsLoadedEventArgs

提供 SettingsLoaded 事件的資料。Provides data for the SettingsLoaded event.

SettingsManageabilityAttribute

指定應用程式設定屬性的特殊服務。Specifies special services for application settings properties. 這個類別無法被繼承。This class cannot be inherited.

SettingsProperty

在內部會當做類別使用,此類別表示與個別組態屬性有關的中繼資料。Used internally as the class that represents metadata about an individual configuration property.

SettingsPropertyCollection

包含 SettingsProperty 物件的集合。Contains a collection of SettingsProperty objects.

SettingsPropertyIsReadOnlyException

提供唯讀 SettingsProperty 物件的例外狀況。Provides an exception for read-only SettingsProperty objects.

SettingsPropertyNotFoundException

提供找不到的 SettingsProperty 物件之例外狀況。Provides an exception for SettingsProperty objects that are not found.

SettingsPropertyValue

包含可以由 SettingsBase 執行個體載入及儲存的設定屬性之值。Contains the value of a settings property that can be loaded and stored by an instance of SettingsBase.

SettingsPropertyValueCollection

包含設定屬性值的集合,其可將 SettingsProperty 物件對應到 SettingsPropertyValue 物件。Contains a collection of settings property values that map SettingsProperty objects to SettingsPropertyValue objects.

SettingsPropertyWrongTypeException

提供無效型別與 SettingsProperty 物件一起使用時所擲回的例外狀況。Provides an exception that is thrown when an invalid type is used with a SettingsProperty object.

SettingsProvider

做為應用程式設定架構中衍生自訂設定提供者的基底類別。Acts as a base class for deriving custom settings providers in the application settings architecture.

SettingsProviderAttribute

指定設定提供者,用於為目前應用程式設定類別或屬性提供儲存區。Specifies the settings provider used to provide storage for the current application settings class or property. 這個類別無法被繼承。This class cannot be inherited.

SettingsProviderCollection

表示應用程式設定提供者的集合。Represents a collection of application settings providers.

SettingsSerializeAsAttribute

指定設定提供者應使用的序列化機制。Specifies the serialization mechanism that the settings provider should use. 這個類別無法被繼承。This class cannot be inherited.

SettingValueElement

包含 XML,其表示設定之序列化的值。Contains the XML representing the serialized value of the setting. 這個類別無法被繼承。This class cannot be inherited.

SingleTagSectionHandler

處理 .config 檔案中以單一 XML 標記 (Tag) 表示的組態區段。Handles configuration sections that are represented by a single XML tag in the .config file.

SpecialSettingAttribute

表示應用程式設定屬性具有特殊的意義。Indicates that an application settings property has a special significance. 這個類別無法被繼承。This class cannot be inherited.

StringValidator

提供字串的驗證。Provides validation of a string.

StringValidatorAttribute

以宣告方式指示 .NET Framework 在組態屬性上執行字串驗證。Declaratively instructs the .NET Framework to perform string validation on a configuration property. 這個類別無法被繼承。This class cannot be inherited.

SubclassTypeValidator

驗證物件是否為指定之型別的衍生類別。Validates that an object is a derived class of a specified type.

SubclassTypeValidatorAttribute

以宣告方式指示 .NET Framework 在組態屬性上執行驗證。Declaratively instructs the .NET Framework to perform validation on a configuration property. 這個類別無法被繼承。This class cannot be inherited.

TimeSpanMinutesConverter

轉換以分鐘表示的時間範圍。Converts a time span expressed in minutes.

TimeSpanMinutesOrInfiniteConverter

轉換以分鐘或標準無限時間範圍表示的 TimeSpanConverts a TimeSpan expressed in minutes or as a standard infinite time span.

TimeSpanSecondsConverter

轉換以秒鐘表示的時間範圍。Converts a time span expressed in seconds.

TimeSpanSecondsOrInfiniteConverter

轉換以秒鐘或標準無限時間範圍表示的 TimeSpanConverts a TimeSpan expressed in seconds or as a standard infinite time span.

TimeSpanValidator

提供 TimeSpan 物件的驗證。Provides validation of a TimeSpan object.

TimeSpanValidatorAttribute

以宣告方式指示 .NET Framework 在組態屬性上執行時間驗證。Declaratively instructs the .NET Framework to perform time validation on a configuration property. 這個類別無法被繼承。This class cannot be inherited.

TypeNameConverter

在型別和字串值之間轉換。Converts between type and string values. 這個類別無法被繼承。This class cannot be inherited.

UriSection

代表組態檔內的 URI 區段。Represents the Uri section within a configuration file.

UserScopedSettingAttribute

指定應用程式設定群組或屬性,其包含應用程式之每個使用者的不同值。Specifies that an application settings group or property contains distinct values for each user of an application. 這個類別無法被繼承。This class cannot be inherited.

UserSettingsGroup

表示組態檔中的相關使用者設定區段群組。Represents a grouping of related user settings sections within a configuration file. 這個類別無法被繼承。This class cannot be inherited.

WhiteSpaceTrimStringConverter

將字串轉換成它的標準格式。Converts a string to its canonical format.

介面

IApplicationSettingsProvider

定義用戶端為主之應用程式設定提供者的擴充功能。Defines extended capabilities for client-based application settings providers.

IConfigurationSectionHandler

處理特定組態區段的存取。Handles the access to certain configuration sections.

IConfigurationSystem

提供標準的組態方法。Provides standard configuration methods.

IPersistComponentSettings

定義用來儲存並擷取應用程式設定之控制項或程式庫的標準功能。Defines standard functionality for controls or libraries that store and retrieve application settings.

ISettingsProviderService

提供用於定義替代應用程式設定提供者的介面。Provides an interface for defining an alternate application settings provider.

列舉

ConfigurationAllowDefinition

指定組態檔階層架構中的位置,這些位置可以設定或覆寫 ConfigurationSection 物件內所包含的屬性。Specifies the locations within the configuration-file hierarchy that can set or override the properties contained within a ConfigurationSection object.

ConfigurationAllowExeDefinition

指定組態檔階層架構中的位置,這些位置可以設定或覆寫 ConfigurationSection 物件內所包含的屬性。Specifies the locations within the configuration-file hierarchy that can set or override the properties contained within a ConfigurationSection object.

ConfigurationElementCollectionType

指定 ConfigurationElementCollectionType 物件的型別。Specifies the type of a ConfigurationElementCollectionType object.

ConfigurationPropertyOptions

指定屬性所要套用的選項。Specifies the options to apply to a property.

ConfigurationSaveMode

判斷哪些屬性會寫出到組態檔中。Determines which properties are written out to a configuration file.

ConfigurationUserLevel

用於指定哪個組態檔要由 Configuration 物件來表示。Used to specify which configuration file is to be represented by the Configuration object.

OverrideMode

指定子目錄中組態項目覆寫組態項目的行為。Specifies the override behavior of a configuration element for configuration elements in child directories.

PropertyValueOrigin

指定組態屬性值所源自的組態階層架構層次。Specifies the level in the configuration hierarchy where a configuration property value originated.

SettingsManageability

提供值,表示應用程式設定應該可以使用哪些服務。Provides values to indicate which services should be made available to application settings.

SettingsSerializeAs

判斷用於儲存應用程式設定的序列化 (Serialization) 配置。Determines the serialization scheme used to store application settings.

SpecialSetting

指定應用程式設定屬性的特殊設定分類。Specifies the special setting category of a application settings property.

委派

SettingChangingEventHandler

代表將處理 SettingChanging 事件的方法。Represents the method that will handle the SettingChanging event.

SettingsLoadedEventHandler

代表將處理 SettingsLoaded 事件的方法。Represents the method that will handle the SettingsLoaded event.

SettingsSavingEventHandler

代表將處理 SettingsSaving 事件的方法。Represents the method that will handle the SettingsSaving event.

ValidatorCallback

表示在驗證物件之後要呼叫的方法。Represents a method to be called after the validation of an object.