DefaultSettingValueAttribute

.NET Framework クラス ライブラリ リファレンス

DefaultSettingValueAttribute クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

アプリケーション設定プロパティの既定値を指定します。

名前空間: System.Configuration
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

<AttributeUsageAttribute(AttributeTargets.Property)> _
Public NotInheritable Class
 DefaultSettingValueAttribute
    Inherits Attribute

Visual Basic (使用法)

Dim instance As DefaultSettingValueAttribute

C#

[AttributeUsageAttribute(AttributeTargets.Property)] 
public sealed class DefaultSettingValueAttribute
 : Attribute

C++

[AttributeUsageAttribute(AttributeTargets::Property)] 
public ref class DefaultSettingValueAttribute
 sealed : public Attribute

J#

/** @attribute AttributeUsageAttribute(AttributeTargets.Property) */ 
public final class DefaultSettingValueAttribute
 extends Attribute

JScript

AttributeUsageAttribute(AttributeTargets.Property) 
public final class DefaultSettingValueAttribute
 extends Attribute

解説

注意
この属性で指定された既定値は、結果としてコンパイルされた .exe ファイルまたは .dll ファイルにプレーンテキストとして保存されます。したがって、これらの既定値はセキュリティで保護されていません。

使用例

ApplicationSettingsBase クラスから派生した FormSettings ラッパー クラスの 4 つのプロパティのうちの 3 つに適用される DefaultSettingValueAttribute の使用方法を次のコード例に示します。このクラスは、フォームの場所、サイズ、背景色、およびテキストを永続化させるために使用します。これらのフォーム プロパティのうち最初の 3 つには、これらに関連付けられた既定値が設定されます。

コード例全体は、ApplicationSettingsBase クラスの概要で示されています。

C#

//Application settings wrapper class
sealed class FormSettings : ApplicationSettingsBase
{
    [UserScopedSettingAttribute()]
    public String FormText
    {
        get { return (String)this["FormText"];
 }
        set { this["FormText"] =
 value; }
    }

    [UserScopedSetting()]
    [DefaultSettingValueAttribute("0, 0")]
    public Point FormLocation
    {
        get { return (Point)(this["FormLocation"]);
 }
        set { this["FormLocation"]
 = value; }
    }

    [UserScopedSetting()]
    [DefaultSettingValueAttribute("225, 200")]
    public Size FormSize
    {
        get { return (Size)this["FormSize"];
 }
        set { this["FormSize"] =
 value; }
    }

    [UserScopedSetting()]
    [DefaultSettingValueAttribute("LightGray")]
    public Color FormBackColor
    {
        get { return (Color)this["FormBackColor"];
 }
        set { this["FormBackColor"]
 = value; }
    }

}

C++

//Application settings wrapper class
ref class FormSettings sealed: public ApplicationSettingsBase
{
public:
    [UserScopedSettingAttribute()]
    property String^ FormText
    {
        String^ get()
        {
            return (String^)this["FormText"];
        }
        void set( String^ value )
        {
            this["FormText"] = value;
        }
    }

public:
    [UserScopedSetting()]
    [DefaultSettingValueAttribute("0, 0")]
    property Point FormLocation
    {
        Point get()
        {
            return (Point)(this["FormLocation"]);
        }
        void set( Point value )
        {
            this["FormLocation"] = value;
        }
    }

public:
    [UserScopedSetting()]
    [DefaultSettingValueAttribute("225, 200")]
    property Size FormSize
    {
        Size get()
        {
            return (Size)this["FormSize"];
        }
        void set( Size value )
        {
            this["FormSize"] = value;
        }
    }

public:
    [UserScopedSetting()]
    [DefaultSettingValueAttribute("LightGray")]
    property Color FormBackColor
    {
        Color get()
        {
            return (Color)this["FormBackColor"];
        }
        void set(Color value)
        {
            this["FormBackColor"] = value;
        }
    }

};

継承階層

System.Object
   System.Attribute
    System.Configuration.DefaultSettingValueAttribute

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DefaultSettingValueAttribute メンバ
System.Configuration 名前空間
SettingsProvider
LocalFileSettingsProvider
SettingsSerializeAsAttribute
その他の技術情報
Windows フォームのアプリケーション設定