DefaultSettingValueAttribute Osztály

Definíció

Névtér:

System.Configuration

Szerelvény:

System.Configuration.ConfigurationManager.dll

Csomag:

System.Configuration.ConfigurationManager v11.0.0-preview.5.26302.115

Forrás:

DefaultSettingValueAttribute.cs

Az alkalmazásbeállítások tulajdonság alapértelmezett értékét adja meg.

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

Öröklődés

Object

Attribute

DefaultSettingValueAttribute

Attribútumok

AttributeUsageAttribute

Példák

Az alábbi példakód a burkolóosztály négy tulajdonságából DefaultSettingValueAttribute háromra alkalmazott használatát FormSettings mutatja be, amely az ApplicationSettingsBase osztályból származik. Ez az osztály az űrlap helyének, méretének, háttérszínének és szövegének megőrzésére szolgál. Az űrlaptulajdonságok közül az első háromhoz alapértelmezett értékek vannak társítva.

A teljes kód példa az osztály áttekintésében ApplicationSettingsBase szerepel.

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

Megjegyzések

Important

DefaultSettingValueAttribute csak az egyes beállítások tulajdonságaira alkalmazható; érvénytelen, ha ezt az attribútumot egy teljes alkalmazásbeállítási osztályra alkalmazza.

A különböző beállításszolgáltatók eltérő követelményekkel vagy korlátozásokkal rendelkezhetnek a .DefaultSettingValueAttribute Például az LocalFileSettingsProvider attribútum nem igényel ilyen attribútumot, és felülírja az attribútum által biztosított értékeket, ha az adattárban már vannak olyan értékek – alapértelmezett vagy felhasználó által módosított –, amelyek már megtalálhatók.

DefaultSettingValueAttribute az alapértelmezett érték sztringként való ábrázolásához szükséges. Ennek eredményeképpen az XML-szerializálást használó beállításoknak nem lehet alapértelmezett értékük ezen attribútum használatával megadva. Egyes szolgáltatók dönthetnek úgy, hogy támogatnak több szerializálási sémát, amelyek a fordításkor SettingsSerializeAsAttributea .

Figyelmeztetés

Az attribútum által megadott alapértelmezett értékek egyszerű szövegként vannak tárolva az eredményül kapott .exe vagy .dll fájlban. Ezért ezek az alapértelmezett értékek eredendően nem biztonságosak.

Konstruktorok

Name	Description
DefaultSettingValueAttribute(String)	Inicializálja az osztály egy példányát DefaultSettingValueAttribute .

Tulajdonságok

Name	Description
Value	Lekéri az alkalmazásbeállítások tulajdonság alapértelmezett értékét.

Lásd még

• SettingsProvider
• LocalFileSettingsProvider
• SettingsSerializeAsAttribute
• Alkalmazásbeállítások Windows Formshez