アプリケーション設定のスキーマ
更新 : 2007 年 11 月
アプリケーション設定によって、Windows フォームまたは ASP.NET アプリケーションはアプリケーション スコープおよびユーザー スコープの設定を格納および取得できます。ここにおける「設定」は、データベース接続文字列からユーザーの既定のウィンドウ サイズにいたるまでのアプリケーションまたは現在のユーザー固有の情報を意味します。
既定では、Windows フォーム アプリケーションのアプリケーション設定は、.NET 構成システムを使用して設定を XML 構成ファイルに格納する LocalFileSettingsProvider を使用します。アプリケーション設定が使用するファイルの詳細については、「アプリケーション設定アーキテクチャ」を参照してください。
アプリケーション設定は、使用する構成ファイルで次の要素を定義します。
要素 |
説明 |
|---|---|
<applicationSettings> 要素 |
アプリケーション固有のすべての <setting> タグが含まれます。 |
<userSettings> 要素 |
現在のユーザー固有のすべての <setting> タグが含まれます。 |
<setting> 要素 |
設定を定義します。<applicationSettings> または <userSettings> の子要素です。 |
<value> 要素 |
設定の値を定義します。<setting> の子要素です。 |
<applicationSettings> 要素
この要素には、クライアント コンピュータのアプリケーションのインスタンス固有のすべての <setting> タグが含まれます。属性は定義されません。
<userSettings> 要素
この要素には、アプリケーションを使用しているユーザー固有のすべての <setting> タグが含まれます。属性は定義されません。
<setting> 要素
この要素は、設定を定義します。次の属性があります。
要素 |
説明 |
|---|---|
name |
必ず指定します。設定の一意の ID です。Visual Studio を使用して作成された設定は ProjectName.Properties.Settings という名前で保存されます。 |
serializedAs |
必ず指定します。テキストに値をシリアル化するために使用する形式です。次の値を指定できます。
|
<value> 要素
この要素には、設定の値が含まれます。
使用例
2 つのアプリケーション スコープの設定および 2 つのユーザー スコープの設定を定義するアプリケーション設定ファイルのコード例を次に示します。
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<configSections>
<sectionGroup name="applicationSettings" type="System.Configuration.ApplicationSettingsGroup, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" >
<section name="WindowsApplication1.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
</sectionGroup>
<sectionGroup name="userSettings" type="System.Configuration.UserSettingsGroup, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" >
<section name="WindowsApplication1.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" allowExeDefinition="MachineToLocalUser" />
</sectionGroup>
</configSections>
<applicationSettings>
<WindowsApplication1.Properties.Settings>
<setting name="Cursor" serializeAs="String">
<value>Default</value>
</setting>
<setting name="DoubleBuffering" serializeAs="String">
<value>False</value>
</setting>
</WindowsApplication1.Properties.Settings>
</applicationSettings>
<userSettings>
<WindowsApplication1.Properties.Settings>
<setting name="FormTitle" serializeAs="String">
<value>Form1</value>
</setting>
<setting name="FormSize" serializeAs="String">
<value>595, 536</value>
</setting>
</WindowsApplication1.Properties.Settings>
</userSettings>
</configuration>