アプリケーション設定アーキテクチャは、ASP.NET および Windows フォームの内部で使用され、この両方の環境で共有される多くの基本クラスを含みます。最も重要な基本クラスは SettingsBase であり、コレクションを介した設定へのアクセスと、設定を読み込んだり保存したりするための下位のメソッドを提供します。各環境は、SettingsBase から派生した独自のクラスを実装し、その環境用の追加の設定機能を提供します。Windows フォーム ベースのアプリケーションでは、次に示すような機能を基本クラスに追加する ApplicationSettingsBase クラスの派生クラス上で、すべてのアプリケーション設定を定義する必要があります。

• 高水準の読み込み操作および保存操作

• ユーザー スコープの設定のサポート

• ユーザー設定から定義済み既定値への復帰

• 以前のバージョンのアプリケーションで使用した設定のアップグレード

• 設定の変更前または保存前における検証

設定は、System.Configuration 名前空間内で定義されている数多くの属性を使用して表すことができます。これらの属性については、「アプリケーション設定の属性」を参照してください。設定を定義する際は、ApplicationScopedSettingAttribute または UserScopedSettingAttribute のいずれかを使用して設定を適用する必要があります。これにより、その設定がアプリケーション全体に適用されるか、または現在のユーザーにだけ適用されるかが指定されます。

次のコード例では、 BackgroundColor という単一の設定を持つカスタム設定クラスを定義します。

Imports System.Configuration

Public Class MyAppSettings
    Inherits ApplicationSettingsBase
    <UserScopedSetting()> _
    <DefaultSettingValue("white")> _
    Public Property BackgroundColor() As Color
        Get
            BackgroundColor = Me("BackgroundColor")
        End Get

        Set(ByVal value As Color)
            Me("BackgroundColor") = value
        End Set
    End Property
End Class

using System;
using System.Configuration;
using System.Drawing;

public class MyUserSettings : ApplicationSettingsBase
{
    [UserScopedSetting()]
    [DefaultSettingValue("white")]
    public Color BackgroundColor
    {
        get
        {
            return ((Color)this["BackgroundColor"]);
        }
        set
        {
            this["BackgroundColor"] = (Color)value;
        }
    }
}

ApplicationSettingsBase クラス自体は設定の永続化も読み込みも行いません。この作業は SettingsProvider の派生クラスである設定プロバイダによって行われます。ApplicationSettingsBase の派生クラスが SettingsProviderAttribute を使用して設定プロバイダを指定しない場合は、既定のプロバイダである LocalFileSettingsProvider が使用されます。

もともと .NET Framework と共にリリースされた構成システムでは、ローカル コンピュータの machine.config ファイルまたはアプリケーションと共に配置する app.exe.config ファイルを介した、静的なアプリケーション構成データの提供がサポートされています。LocalFileSettingsProvider クラスによって、このネイティブ サポートが次のように拡張されます。

• アプリケーション スコープの設定は machine.config ファイルまたは app.exe.config ファイルに格納できます。machine.config は常に読み取り専用です。一方、app.exe.config はセキュリティ上の配慮から、大部分のアプリケーションで読み取り専用に制限されています。

• ユーザー スコープの設定は app.exe.config ファイルに格納できます。この場合、設定は静的な既定値として扱われます。

• 既定値以外のユーザー スコープの設定は、user.config という新しいファイルに格納されます。user は現在このアプリケーションを実行しているユーザーの名前です。ユーザー スコープの設定の既定値は、DefaultSettingValueAttribute を使用して指定できます。ユーザー スコープの設定はアプリケーションの実行時に変更されることがよくあるため、user.config は常に読み取り/書き込み用となります。

この 3 つの構成ファイルはいずれも XML 形式で設定を格納します。アプリケーション スコープの設定の最上位 XML 要素は、<appSettings> で、ユーザー スコープの設定の最上位 XML 要素は <userSettings> です。アプリケーション スコープの設定およびユーザー スコープの設定の既定値を含む app.exe.config ファイルは、次のようになります。

<?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>

構成ファイルのアプリケーション設定セクションに含まれる要素の定義については、「アプリケーション設定のスキーマ」を参照してください。

設定のバインディング

設定のシリアル化

設定ファイルの場所

アプリケーション設定は部分信頼で機能するように設計されています。部分信頼とは、インターネット上やイントラネット上でホストされる Windows フォーム アプリケーションにとって既定となる制限された環境のことです。既定の設定プロバイダと共にアプリケーション設定を使用する場合、部分信頼以外に特別なアクセス許可は必要ありません。

ClickOnce アプリケーション内でアプリケーション設定を使用する場合、user.config ファイルは ClickOnce のデータ ディレクトリに格納されます。アプリケーションの user.config ファイルのサイズを、ClickOnce で設定したデータ ディレクトリ クォータより大きくすることはできません。詳細については、「ClickOnce とアプリケーション設定」を参照してください。

アプリケーション設定アーキテクチャでは、ApplicationSettingsBase から派生したアプリケーション設定ラッパー クラスと、SettingsProvider から派生した、1 つまたは複数の関連するプロバイダとの間には緩い結合があります。この結合は、ラッパー クラスまたはその個々のプロパティに適用されている SettingsProviderAttribute によってのみ定義されます。設定プロバイダを明示的に指定しないと、既定のプロバイダである LocalFileSettingsProvider が使用されます。したがって、このアーキテクチャではカスタム設定プロバイダの作成と使用がサポートされていることになります。

たとえば、すべての設定データを Microsoft SQL Server データベースに格納するプロバイダである SqlSettingsProvider を使用するとします。SettingsProvider 派生クラスは、この情報を System.Collections.Specialized..::.NameValueCollection 型のパラメータとして Initialize メソッドで受け取ります。次に、GetPropertyValues メソッドを実装して、設定値をデータ ストアから取得し、SetPropertyValues を使用して保存します。このプロバイダは、GetPropertyValues に指定される SettingsPropertyCollection を使用して、プロパティの名前、型、スコープや、このプロパティに対して定義されたその他の設定属性を判断します。

このプロバイダでは、1 つのプロパティと 1 つのメソッドを実装する必要がありますが、この実装はわかりにくいことがあります。ApplicationName プロパティは、SettingsProvider の抽象プロパティです。次のような値を返すようにプログラムする必要があります。

Public Overrides Property ApplicationName() As String
    Get
        ApplicationName = System.Reflection.Assembly.GetExecutingAssembly().GetName().Name
    End Get
    Set(ByVal value As String)
        ' Do nothing.
    End Set
End Property

public override string ApplicationName
{
    get
    {
        return (System.Reflection.Assembly.GetExecutingAssembly().GetName().Name);
    }
    set
    {
        // Do nothing.
    }
}

また、派生クラスは、引数を受け取らず値を返さない Initialize メソッドも実装する必要があります。このメソッドは SettingsProvider によって定義されません。

最後にプロバイダに IApplicationSettingsProvider を実装して、設定の更新、設定値から既定値への復帰、およびアプリケーションのあるバージョンから別のバージョンへの設定のアップグレードをサポートします。

カスタム プロバイダの実装とコンパイルを行った後、設定クラスに対して、既定のプロバイダではなくこのプロバイダを使用するように指示する必要があります。これには、SettingsProviderAttribute を使用します。設定クラス全体にこのプロバイダを適用した場合、このプロバイダはこのクラスが定義する各設定に対して使用されます。個々の設定に適用した場合、アプリケーション設定アーキテクチャは、該当する設定に対してのみこのプロバイダを使用し、それ以外の設定については LocalFileSettingsProvider を使用します。次のコード例では、設定クラスに対してカスタム プロバイダを使用するように指示する方法を示します。

Imports System.Configuration

<SettingsProvider("SqlSettingsProvider")> _
Public Class CustomSettings
    Inherits ApplicationSettingsBase

    ' Implementation goes here.
End Class

using System;
using System.Collections.Generic;
using System.Text;
using System.Configuration;

namespace ApplicationSettingsArchitectureCS
{
    class CustomSettings : ApplicationSettingsBase
    {
        // Implementation goes here.
    }
}

複数のスレッドから同時にプロバイダを呼び出すことができますが、プロバイダは常に同じストレージの場所に書き込みを行います。したがって、アプリケーション設定アーキテクチャによってインスタンス化されるカスタム プロバイダ クラスは 1 つだけです。

重要 :
カスタム プロバイダがスレッド セーフであり、構成ファイルへの書き込みを実行できるのは一度に 1 つのスレッドだけであることを確認しておく必要があります。

カスタム プロバイダは System.Configuration 名前空間で定義されているすべての設定属性をサポートする必要はありませんが、少なくとも ApplicationScopedSettingAttribute、UserScopedSettingAttribute、および DefaultSettingValueAttribute をサポートしている必要があります。サポートしていない属性については、カスタム プロバイダは警告なしに失敗し、例外をスローしません。ただし、設定クラスが無効な属性の組み合わせを使用した場合 (同じ設定に ApplicationScopedSettingAttribute と UserScopedSettingAttribute を適用するなど)、カスタム プロバイダは例外をスローし、操作が中断されます。

概念

参照