LocalFileSettingsProvider クラス

定義

名前空間:

System.Configuration

アセンブリ:

System.Configuration.ConfigurationManager.dll

パッケージ:

System.Configuration.ConfigurationManager v8.0.0

ソース:

LocalFileSettingsProvider.cs

アプリケーション設定クラスに永続性を持たせます。

C#

public class LocalFileSettingsProvider : System.Configuration.SettingsProvider, System.Configuration.IApplicationSettingsProvider

継承

Object

ProviderBase

SettingsProvider

LocalFileSettingsProvider

実装

IApplicationSettingsProvider

注釈

設定プロバイダーは、アプリケーション設定アーキテクチャで使用される構成データを格納するためのメカニズムを定義します。 .NET Frameworkには、LocalFileSettingsProvider構成データをローカル ファイル システムに格納する 1 つの既定の設定プロバイダー が含まれています。 アプリケーション設定プロパティまたはプロパティのグループは、 を使用して特定の設定プロバイダーに SettingsProviderAttribute関連付けられます。

通常、クライアント プログラムはこのクラスに明示的にアクセスしません。代わりに、アプリケーション設定アーキテクチャは、サービスが必要なときに適切な設定プロバイダーを自動的に呼び出します。 たとえば、 のメンバーの ApplicationSettingsBase 多くは、関連する設定プロバイダーに作業を委任します。

LocalFileSettingsProvider は、拡張子 .configが の構成ファイルに設定を保持します。 構成ファイルの内容は XML ドキュメントとして構成されます。 設定のスコープがアプリケーション レベルかユーザー レベルかに応じて、構成データはそれぞれ、 または セクション グループ内 <applicationSettings> の <userSettings> 要素として格納されます。 これらのセクション グループはそれぞれ、対応する AppSettingsSection または ClientSettingsSectionで表されます。 各セクション オブジェクトは、 型 IConfigurationSectionHandlerのオブジェクトである構成セクション ハンドラーによって所有および管理されます。

アプリケーション スコープの設定と既定のユーザー スコープ設定は、 という名前 application.exe.configのファイルに格納されます。このファイルは、実行可能ファイルと同じディレクトリに作成されます。 アプリケーション構成設定は読み取り専用です。 特定のユーザー データは、 という名前 user.configのファイルに格納され、ユーザーのホーム ディレクトリの下に格納されます。 ローミング プロファイルが有効になっている場合は、2 つのバージョンのユーザー構成ファイルが存在する可能性があります。 このような場合、ローミング バージョンのエントリは、ローカル ユーザー構成ファイル内の重複したエントリよりも優先されます。

アプリケーション設定の詳細については、「Windows フォームのアプリケーション設定」を参照してください。

コンストラクター

LocalFileSettingsProvider()

LocalFileSettingsProvider クラスの新しいインスタンスを初期化します。

プロパティ

ApplicationName	現在実行中のアプリケーションの名前を取得または設定します。
Description	管理ツールまたは他のユーザー インターフェイス (UI) での表示に適した、簡単でわかりやすい説明を取得します。 (継承元 ProviderBase)
Name	構成時にプロバイダーを参照するために使用される表示名を取得します。 (継承元 ProviderBase)

メソッド

Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetPreviousVersion(SettingsContext, SettingsProperty)	同じアプリケーションの以前のバージョンの、名前付き設定プロパティの値を返します。
GetPropertyValues(SettingsContext, SettingsPropertyCollection)	指定したアプリケーションのインスタンスと設定プロパティ グループの、設定プロパティ値のコレクションを返します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
Initialize(String, NameValueCollection)	プロバイダーを初期化します。
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
Reset(SettingsContext)	指定したアプリケーションに関連付けられているすべてのアプリケーション設定プロパティを既定値にリセットします。
SetPropertyValues(SettingsContext, SettingsPropertyValueCollection)	指定したプロパティ設定グループの値を設定します。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)
Upgrade(SettingsContext, SettingsPropertyCollection)	同じアプリケーションの以前のバージョンから、ユーザー スコープの以前の設定の移行を試みます。

適用対象

こちらもご覧ください

• SettingsProviderAttribute
• ApplicationScopedSettingAttribute
• UserScopedSettingAttribute
• ApplicationSettingsBase
• ClientSettingsSection
• IConfigurationSectionHandler
• アプリケーション設定アーキテクチャ