System.Configuration.SettingsContext 类
方法描述
提供上下文信息，这些信息可由提供程序在保持设置时可使用。
语法定义(C# System.Configuration.SettingsContext 类 的用法)
[SerializableAttribute] public class SettingsContext : Hashtable
构造函数
| 构造函数名称 | 构造函数描述 |
|---|---|
| SettingsContext | 初始化 SettingsContext 类的新实例。 |
成员/方法
| 方法名称 | 方法描述 |
|---|---|
| Add | 将带有指定键和值的元素添加到 Hashtable 中。 （继承自 Hashtable。） |
| Clear | 从 Hashtable 中移除所有元素。 （继承自 Hashtable。） |
| Clone | 创建 Hashtable 的浅表副本。 （继承自 Hashtable。） |
| Contains | 确定 Hashtable 是否包含特定键。 （继承自 Hashtable。） |
| ContainsKey | 确定 Hashtable 是否包含特定键。 （继承自 Hashtable。） |
| ContainsValue | 确定 Hashtable 是否包含特定值。 （继承自 Hashtable。） |
| CopyTo | 将 Hashtable 元素复制到一维 Array 实例中的指定索引位置。 （继承自 Hashtable。） |
| Equals(Object) | 确定指定的 Object 是否等于当前的 Object。 （继承自 Object。） |
| Finalize | 允许对象在“垃圾回收”回收之前尝试释放资源并执行其他清理操作。 （继承自 Object。） |
| GetEnumerator | 返回循环访问 Hashtable 的 IDictionaryEnumerator。 （继承自 Hashtable。） |
| GetHash | 返回指定键的哈希代码。 （继承自 Hashtable。） |
| GetHashCode | 用作特定类型的哈希函数。 （继承自 Object。） |
| GetObjectData | 实现 ISerializable 接口，并返回序列化 Hashtable 所需的数据。 （继承自 Hashtable。） |
| GetType | 获取当前实例的 Type。 （继承自 Object。） |
| KeyEquals | 将特定 Object 与 Hashtable 中的特定键进行比较。 （继承自 Hashtable。） |
| MemberwiseClone | 创建当前 Object 的浅表副本。 （继承自 Object。） |
| OnDeserialization | 实现 ISerializable 接口，并在完成反序列化之后引发反序列化事件。 （继承自 Hashtable。） |
| Remove | 从 Hashtable 中移除带有指定键的元素。 （继承自 Hashtable。） |
| ToString | 返回表示当前对象的字符串。 （继承自 Object。） |
提示和注释
SettingsContext 类是应用程序用于向设置提供程序提供上下文信息的基类。 虽然此类并不是抽象类，但应用程序可选择创建一个专用类，该专用类从 SettingsContext 类继承，并向特定类型的提供程序提供附加信息。 然后提供程序便可以在写入属性时检查上下文设置。
SettingsContext 类主要用于提供使用 SettingsBase 类和相关基础结构的功能。 SettingsContext 类提供有关 SettingsBase 实例正在存储的属性数据的附加的功能特定的上下文信息。 因此，在 SettingsContext 类中存储附加信息非常简单，无需从此类派生（或从其他 Settings* 类派生）以便支持附加的功能特定的上下文信息。
例如，ASP.NET 使用 SettingsContext 类传递与 SettingsBase 所管理的数据关联的用户名，以及一个指示用户是否已经过身份的属性。 通过这种方式，ASP.NET 使用 SettingsContext 类可识别已验证身份的和匿名的配置文件数据。
System.Configuration.SettingsContext 类例子
线程安全
此类型的任何公共 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 系统要求。