SettingsContext Class
Provides contextual information that the provider can use when persisting settings.
Assembly: System (in System.dll)
The SettingsContext type exposes the following members.
| Name | Description | |
|---|---|---|
![]() | comparer | Obsolete. Gets or sets the IComparer to use for the Hashtable. (Inherited from Hashtable.) |
![]() | Count | Gets the number of key/value pairs contained in the Hashtable. (Inherited from Hashtable.) |
![]() | EqualityComparer | Gets the IEqualityComparer to use for the Hashtable. (Inherited from Hashtable.) |
![]() | hcp | Obsolete. Gets or sets the object that can dispense hash codes. (Inherited from Hashtable.) |
![]() | IsFixedSize | Gets a value indicating whether the Hashtable has a fixed size. (Inherited from Hashtable.) |
![]() | IsReadOnly | Gets a value indicating whether the Hashtable is read-only. (Inherited from Hashtable.) |
![]() | IsSynchronized | Gets a value indicating whether access to the Hashtable is synchronized (thread safe). (Inherited from Hashtable.) |
![]() | Item | Gets or sets the value associated with the specified key. (Inherited from Hashtable.) |
![]() | Keys | Gets an ICollection containing the keys in the Hashtable. (Inherited from Hashtable.) |
![]() | SyncRoot | Gets an object that can be used to synchronize access to the Hashtable. (Inherited from Hashtable.) |
![]() | Values | Gets an ICollection containing the values in the Hashtable. (Inherited from Hashtable.) |
| Name | Description | |
|---|---|---|
![]() | Add | Adds an element with the specified key and value into the Hashtable. (Inherited from Hashtable.) |
![]() | Clear | Removes all elements from the Hashtable. (Inherited from Hashtable.) |
![]() | Clone | Creates a shallow copy of the Hashtable. (Inherited from Hashtable.) |
![]() | Contains | Determines whether the Hashtable contains a specific key. (Inherited from Hashtable.) |
![]() | ContainsKey | Determines whether the Hashtable contains a specific key. (Inherited from Hashtable.) |
![]() | ContainsValue | Determines whether the Hashtable contains a specific value. (Inherited from Hashtable.) |
![]() | CopyTo | Copies the Hashtable elements to a one-dimensional Array instance at the specified index. (Inherited from Hashtable.) |
![]() | Equals(Object) | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
![]() | Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
![]() | GetEnumerator | Returns an IDictionaryEnumerator that iterates through the Hashtable. (Inherited from Hashtable.) |
![]() | GetHash | Returns the hash code for the specified key. (Inherited from Hashtable.) |
![]() | GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
![]() | GetObjectData | Implements the ISerializable interface and returns the data needed to serialize the Hashtable. (Inherited from Hashtable.) |
![]() | GetType | Gets the Type of the current instance. (Inherited from Object.) |
![]() | KeyEquals | Compares a specific Object with a specific key in the Hashtable. (Inherited from Hashtable.) |
![]() | MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
![]() | OnDeserialization | Implements the ISerializable interface and raises the deserialization event when the deserialization is complete. (Inherited from Hashtable.) |
![]() | Remove | Removes the element with the specified key from the Hashtable. (Inherited from Hashtable.) |
![]() | ToString | Returns a string that represents the current object. (Inherited from Object.) |
The SettingsContext class is the base class used by applications to provide contextual information to the settings provider. Although the class is not abstract, an application can choose to create a specialized class that inherits from SettingsContext class and provides additional information to specific types of providers. The provider can then examine contextual settings when writing properties.
The primary purpose of the SettingsContext class is to provide features that use the SettingsBase class and related infrastructure. The SettingsContext class provides additional feature-specific contextual information about the property data being stored by the SettingsBase instance. Therefore, it is very simple to store additional information in a SettingsContext class without deriving from it (or from other Settings* classes) in order to support additional feature-specific context information.
For example, ASP.NET uses the SettingsContext class to pass along the username associated with the data managed by a SettingsBase instance, as well as a property indicating whether the user is considered authenticated. In this way, ASP.NET uses the SettingsContext class to identify authenticated versus anonymous Profile data.
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
