System.Configuration.UserScopedSettingAttribute 类

方法描述

指定应用程序设置组或属性对于应用程序的每个用户包含不同的值。 此类不能被继承。

语法定义(C# System.Configuration.UserScopedSettingAttribute 类 的用法)

[AttributeUsageAttribute(AttributeTargets.Property)]
public sealed class UserScopedSettingAttribute : SettingAttribute

构造函数

构造函数名称 构造函数描述
UserScopedSettingAttribute 初始化 UserScopedSettingAttribute 类的新实例。

成员/方法

方法名称 方法描述
Equals 基础结构。返回一个值,该值指示此实例是否与指定的对象相等。 (继承自 Attribute。)
Finalize 允许对象在“垃圾回收”回收之前尝试释放资源并执行其他清理操作。 (继承自 Object。)
GetHashCode 返回此实例的哈希代码。 (继承自 Attribute。)
GetType 获取当前实例的 Type。 (继承自 Object。)
IsDefaultAttribute 当在派生类中重写时,指示此实例的值是否是派生类的默认值。 (继承自 Attribute。)
Match 当在派生类中重写时,返回一个指示此实例是否等于指定对象的值。 (继承自 Attribute。)
MemberwiseClone 创建当前 Object 的浅表副本。 (继承自 Object。)
ToString 返回表示当前对象的字符串。 (继承自 Object。)

提示和注释

应用程序设置属性的范围可以基于应用程序级别,也可以基于用户级别。 顾名思义,应用程序范围的属性为应用程序的所有用户提供统一值,而用户范围的属性则为应用程序的每个用户提供专有的值。

UserScopedSettingAttribute 指示应将某属性视为用户级别的设置,并且应通过设置提供程序相应作出合适的存储决策。

每个应用程序设置属性都需要一个范围特性。 如果未对某个属性应用 ApplicationScopedSettingAttribute 或 UserScopedSettingAttribute,则设置提供程序将忽略该属性,即不对其进行序列化。 但是,将这两个特性应用于相同的设置属性是无效的。 这种尝试将导致引发 ConfigurationErrorsException。

System.Configuration.UserScopedSettingAttribute 类例子

ApplicationSettingsBase 类概述中列出了完整的代码示例。

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

}

继承层次结构

System.Object

System.Attribute

System.Configuration.SettingAttribute

System.Configuration.UserScopedSettingAttribute

命名空间

namespace: System.Configuration

程序集: System(在 System.dll 中)

线程安全

此类型的任何公共 static(在 Visual Basic 中为 Shared) 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

版本信息

.NET Framework 受以下版本支持:4、3.5、3.0、2.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。