次の方法で共有

アプリケーション設定の属性

  • [アーティクル]

アプリケーション設定アーキテクチャには、アプリケーション設定ラッパー クラスまたはその個々のプロパティに適用できる多くの属性が用意されています。 これらの属性は、カスタム ラッパーの指定されたニーズに合わせて機能を調整するために、アプリケーション設定インフラストラクチャ (特に設定プロバイダー) によって実行時に調べられます。

次の表に、アプリケーション設定ラッパー クラス、このクラスの個々のプロパティ、またはその両方に適用できる属性を示します。 定義上、UserScopedSettingAttribute または ApplicationScopedSettingAttributeのいずれか1つのスコープ属性のみを各設定プロパティに適用する必要があります。

手記

クラスから派生したカスタム設定プロバイダーは、ApplicationScopedSettingAttribute、UserScopedSettingAttribute、DefaultSettingValueAttributeの 3 つの属性を認識するためにのみ必要です。

属性 ターゲット 説明
SettingsProviderAttribute 両方とも 永続化に使用する設定プロバイダーの短い名前を指定します。

この属性が指定されていない場合は、既定のプロバイダーである LocalFileSettingsProviderが想定されます。
UserScopedSettingAttribute 両方とも ユーザー スコープのアプリケーション設定としてプロパティを定義します。
ApplicationScopedSettingAttribute 両方とも プロパティをアプリケーション スコープのアプリケーション設定として定義します。
DefaultSettingValueAttribute 財産 プロバイダーによってこのプロパティのハードコーディングされた既定値に逆シリアル化できる文字列を指定します。

LocalFileSettingsProvider は、この属性を必要とせず、既に永続化されている値がある場合は、この属性によって提供されるすべての値をオーバーライドします。
SettingsDescriptionAttribute 財産 個々の設定について説明的なテストを提供します。主に実行時ツールとデザイン時ツールで使用されます。
SettingsGroupNameAttribute クラス 設定グループの明示的な名前を指定します。 この属性がない場合、ApplicationSettingsBase はラッパー クラス名を使用します。
SettingsGroupDescriptionAttribute クラス 設定グループの説明的なテストを提供します。これは、主に実行時ツールとデザイン時ツールによって使用されます。
SettingsManageabilityAttribute 両方とも 設定グループまたはプロパティに提供する必要がある、0 個以上の管理容易性サービスを指定します。 使用可能なサービスは、SettingsManageability 列挙体によって記述されます。
SpecialSettingAttribute 財産 設定プロバイダーによる特別な処理を提案する、接続文字列などの特別な定義済みカテゴリに設定が属していることを示します。 この属性の定義済みのカテゴリは、SpecialSetting 列挙体によって定義されます。
SettingsSerializeAsAttribute 両方とも 設定グループまたはプロパティに推奨されるシリアル化メカニズムを指定します。 使用可能なシリアル化メカニズムは、SettingsSerializeAs 列挙体によって定義されます。
NoSettingsVersionUpgradeAttribute 財産 設定プロバイダーがマークされたプロパティのすべてのアプリケーション アップグレード機能を無効にすることを指定します。

クラス は、属性をアプリケーション設定ラッパー クラスにのみ適用できることを示します。 プロパティ は、属性を設定プロパティにのみ適用できることを示します。 両方の は、どちらのレベルでも属性を適用できることを示します。

関連項目