Bewerken

Delen via


SettingsProperty Class

Definition

Used internally as the class that represents metadata about an individual configuration property.

public ref class SettingsProperty
public class SettingsProperty
type SettingsProperty = class
Public Class SettingsProperty
Inheritance
SettingsProperty

Remarks

SettingsProperty is used to describe settings properties of a class derived from SettingsBase. The Settings API allows a collection of settings properties to be grouped into a common language runtime class.

When persisting settings, the SettingsBase base class asks for a collection of SettingsProperty objects, grouped in a collection of type SettingsPropertyCollection. It does this by calling its own Properties member. Inherited classes should return a collection of properties to persist.

Each SettingsProperty object includes metadata about the property, including the following:

  • Name.

  • Default value.

  • Property type.

  • Serialization method.

  • Provider to use for persistence.

  • Other arbitrary attributes that are context and provider specific.

Constructors

SettingsProperty(SettingsProperty)

Initializes a new instance of the SettingsProperty class, based on the supplied parameter.

SettingsProperty(String, Type, SettingsProvider, Boolean, Object, SettingsSerializeAs, SettingsAttributeDictionary, Boolean, Boolean)

Creates a new instance of the SettingsProperty class based on the supplied parameters.

SettingsProperty(String)

Initializes a new instance of the SettingsProperty class. based on the supplied parameter.

Properties

Attributes

Gets a SettingsAttributeDictionary object containing the attributes of the SettingsProperty object.

DefaultValue

Gets or sets the default value of the SettingsProperty object.

IsReadOnly

Gets or sets a value specifying whether a SettingsProperty object is read-only.

Name

Gets or sets the name of the SettingsProperty.

PropertyType

Gets or sets the type for the SettingsProperty.

Provider

Gets or sets the provider for the SettingsProperty.

SerializeAs

Gets or sets a SettingsSerializeAs object for the SettingsProperty.

ThrowOnErrorDeserializing

Gets or sets a value specifying whether an error will be thrown when the property is unsuccessfully deserialized.

ThrowOnErrorSerializing

Gets or sets a value specifying whether an error will be thrown when the property is unsuccessfully serialized.

Methods

Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetType()

Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Returns a string that represents the current object.

(Inherited from Object)

Applies to