System.Configuration.DefaultSettingValueAttribute 类
方法描述
指定应用程序设置属性的默认值。
语法定义(C# System.Configuration.DefaultSettingValueAttribute 类 的用法)
[AttributeUsageAttribute(AttributeTargets.Property)] public sealed class DefaultSettingValueAttribute : Attribute
构造函数
| 构造函数名称 | 构造函数描述 |
|---|---|
| DefaultSettingValueAttribute | 初始化 DefaultSettingValueAttribute 类的实例。 |
成员/方法
| 方法名称 | 方法描述 |
|---|---|
| Equals | 基础结构。返回一个值，该值指示此实例是否与指定的对象相等。 （继承自 Attribute。） |
| Finalize | 允许对象在“垃圾回收”回收之前尝试释放资源并执行其他清理操作。 （继承自 Object。） |
| GetHashCode | 返回此实例的哈希代码。 （继承自 Attribute。） |
| GetType | 获取当前实例的 Type。 （继承自 Object。） |
| IsDefaultAttribute | 当在派生类中重写时，指示此实例的值是否是派生类的默认值。 （继承自 Attribute。） |
| Match | 当在派生类中重写时，返回一个指示此实例是否等于指定对象的值。 （继承自 Attribute。） |
| MemberwiseClone | 创建当前 Object 的浅表副本。 （继承自 Object。） |
| ToString | 返回表示当前对象的字符串。 （继承自 Object。） |
提示和注释
重要事项
DefaultSettingValueAttribute 只能应用于各个设置属性；对于将此特性应用于整个应用程序设置类是无效的。
不同的设置提供程序对于 DefaultSettingValueAttribute 的使用可能具有不同的要求或限制。 例如，如果数据存储区中已存在任何值（默认值或用户修改的值），则 LocalFileSettingsProvider 不需要此特性，并且将重写此特性提供的任何值。
DefaultSettingValueAttribute 要求可以将默认值表示为字符串。 因此，使用 XML 序列化的设置无法具有通过此特性指定的默认值。 一些提供程序可能会选择支持编译时使用 SettingsSerializeAsAttribute 指定的多个序列化方案。
警告
此特性指定的默认值作为纯文本存储在编译生成的 .exe 文件或 .dll 文件中。 因此，这些默认值本身是不安全的。
System.Configuration.DefaultSettingValueAttribute 类例子
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; }
}
}
线程安全
此类型的任何公共 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 系统要求。