DefaultSettingValueAttribute 클래스

정의

네임스페이스:

System.Configuration

어셈블리:

System.Configuration.ConfigurationManager.dll

패키지:

System.Configuration.ConfigurationManager v8.0.0

Source:

DefaultSettingValueAttribute.cs

애플리케이션 설정 속성의 기본값을 지정합니다.

public ref class DefaultSettingValueAttribute sealed : Attribute

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

[<System.AttributeUsage(System.AttributeTargets.Property)>]
type DefaultSettingValueAttribute = class
    inherit Attribute

Public NotInheritable Class DefaultSettingValueAttribute
Inherits Attribute

상속

Object

Attribute

DefaultSettingValueAttribute

특성

AttributeUsageAttribute

예제

다음 코드 예제를 사용 DefaultSettingValueAttribute 하는 방법을 보여 줍니다.는 래퍼 클래스의 네 가지 속성 중 세 가지에 FormSettings 적용 된 클래스에서 ApplicationSettingsBase 파생 되는 속성입니다. 이 클래스는 양식의 위치, 크기, 배경색 및 텍스트를 유지하는 데 사용됩니다. 이러한 양식 속성 중 처음 세 가지에는 연결된 기본값이 있습니다.

전체 코드 예제는 클래스 개요에 ApplicationSettingsBase 나열됩니다.

//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:
    [UserScopedSettingAttribute()]
    [DefaultSettingValueAttribute("0, 0")]
    property Point FormLocation
    {
        Point get()
        {
            return (Point)(this["FormLocation"]);
        }
        void set( Point value )
        {
            this["FormLocation"] = value;
        }
    }

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

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

};

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

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

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

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

'Application settings wrapper class. This class defines the settings we intend to use in our application.
NotInheritable Class FormSettings
    Inherits ApplicationSettingsBase

    <UserScopedSettingAttribute()> _
    Public Property FormText() As String
        Get
            Return CStr(Me("FormText"))
        End Get
        Set(ByVal value As String)
            Me("FormText") = value
        End Set
    End Property

    <UserScopedSettingAttribute(), DefaultSettingValueAttribute("0, 0")> _
    Public Property FormLocation() As Point
        Get
            Return CType(Me("FormLocation"), Point)
        End Get
        Set(ByVal value As Point)
            Me("FormLocation") = value
        End Set
    End Property

    <UserScopedSettingAttribute(), DefaultSettingValueAttribute("225, 200")> _
    Public Property FormSize() As Size
        Get
            Return CType(Me("FormSize"), Size)
        End Get
        Set(ByVal value As Size)
            Me("FormSize") = value
        End Set
    End Property

    <UserScopedSettingAttribute(), DefaultSettingValueAttribute("LightGray")> _
    Public Property FormBackColor() As Color
        Get
            Return CType(Me("FormBackColor"), Color)
        End Get
        Set(ByVal value As Color)
            Me("FormBackColor") = value
        End Set
    End Property
End Class

설명

중요

DefaultSettingValueAttribute 개별 설정 속성에만 적용할 수 있습니다. 전체 애플리케이션 설정 클래스에이 특성을 적용할 올바르지 않습니다.

설정 공급자에 따라 의 사용에 DefaultSettingValueAttribute대한 요구 사항이나 제한 사항이 다를 수 있습니다. 예를 들어 에는 LocalFileSettingsProvider 이 특성이 필요하지 않으며 데이터 저장소에 이미 있는 기본값 또는 사용자 수정 값이 있는 경우 이 특성에서 제공하는 모든 값을 재정의합니다.

DefaultSettingValueAttribute 기본값을 문자열로 나타낼 수 있어야 합니다. 따라서 XML serialization을 사용하는 설정은 이 특성을 통해 지정된 기본값을 가질 수 없습니다. 일부 공급자는 를 사용하여 컴파일 시간에 지정할 수 있는 여러 serialization 체계를 SettingsSerializeAsAttribute지원하도록 선택할 수 있습니다.

주의

이 특성에 지정된 기본값은 결과 컴파일된 .exe 또는 .dll 파일에 일반 텍스트로 저장됩니다. 따라서 이러한 기본값은 본질적으로 안전하지 않습니다.

생성자

DefaultSettingValueAttribute(String)

DefaultSettingValueAttribute 클래스의 인스턴스를 초기화합니다.

속성

TypeId	파생 클래스에서 구현된 경우 이 Attribute에 대한 고유 식별자를 가져옵니다. (다음에서 상속됨 Attribute)
Value	애플리케이션 설정 속성의 기본값을 가져옵니다.

메서드

Equals(Object)	이 인스턴스가 지정된 개체와 같은지를 나타내는 값을 반환합니다. (다음에서 상속됨 Attribute)
GetHashCode()	이 인스턴스의 해시 코드를 반환합니다. (다음에서 상속됨 Attribute)
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
IsDefaultAttribute()	파생 클래스에서 재정의된 경우 이 인스턴스 값이 파생 클래스에 대한 기본값인지 여부를 표시합니다. (다음에서 상속됨 Attribute)
Match(Object)	파생 클래스에서 재정의된 경우 이 인스턴스가 지정된 개체와 같은지 여부를 나타내는 값을 반환합니다. (다음에서 상속됨 Attribute)
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)

추가 정보

• SettingsProvider
• LocalFileSettingsProvider
• SettingsSerializeAsAttribute
• Windows Forms에 대한 애플리케이션 설정