Gemstone.Configuration Defines extensions for setting up configuration defaults for Gemstone projects. Configures the builder using the defined settings from Gemstone project configuration sources. The configuration builder. Settings for configuring default sources. The configuration builder. This extension function configures common configuration sources for a Gemstone project. The instance controls the configuration sources that are available. Handling of settings are defined in a hierarchy where the settings are loaded are in the following priority order, from lowest to hightest: INI file (defaults.ini) - Machine Level INI file (settings.ini) - Machine Level SQLite database (settings.db) - User Level Environment variables - Machine Level Environment variables - User Level Configures the builder using the default configuration sources for Gemstone projects. The configuration builder. Action for configuring default app settings. INI file can be produced in lieu of a UI for configuration. Use SQLite for user configuration storage. Use environmental variables for configuration. Split long description lines into multiple lines. Configured INI path. Set to null for default %ProgramData% path. The configuration builder. This extension function configures common configuration sources for a Gemstone project. The provided parameters control the configuration sources that are available. Handling of settings are defined in a hierarchy where the settings are loaded are in the following priority order, from lowest to hightest: INI file (defaults.ini) - Machine Level INI file (settings.ini) - Machine Level SQLite database (settings.db) - User Level Environment variables - Machine Level Environment variables - User Level Parses connection strings based on a settings object whose properties are annotated with the . Stores reflected information from a object used to parse connection strings. The object. The type converter used to convert the value of this property to and from a string. The name of the property as it appears in the connection string. The default value of the property if its value is not explicitly specified in the connection string. Indicates whether or not the property is required to be explicitly defined in the connection string. Gets all validation attributes that may be applied to the property. Creates a new instance of the class. The object. Type registry to use when parsing instances. Set to null for default registry. Default value for the property. Default value for the property. Default value for the property. Default value for the property. Default value for the property. Default value for the property. Creates a new instance of the class. Gets or sets the parameter delimiter used to separate key-value pairs in the connection string. Gets or sets the key-value delimiter used to separate keys from values in the connection string. Gets or sets the start value delimiter used to denote the start of a value in the cases where the value contains one of the delimiters defined for the connection string. Gets or sets the end value delimiter used to denote the end of a value in the cases where the value contains one of the delimiters defined for the connection string. Gets or sets the flag that determines whether to explicitly specify parameter values that match their defaults when serializing settings to a connection string. Gets or sets the flag that determines whether to include properties which are not annotated with the in the connection string. Serializes the given into a connection string. The object whose properties are to be serialized. A connection string containing the serialized properties. Deserializes the connection string parameters into the given . The connection string to be parsed. The object whose properties are to be populated with values from the connection string. is null. A required connection string parameter cannot be found in the connection string. Gets the set of properties which are part of the connection string. The type of the settings object used to look up properties via reflection. The set of properties which are part of the connection string. Converts the given string value to the type of the given property. The string value to be converted. The property used to determine what type to convert to. The given string converted to the type of the given property. Converts the given object to a string. The object to be converted. The property which defines the type of the object. The object converted to a string. Converts XML to a connection string. The root element of the XML to be converted to a connection string. A connection string converted from XML. Converts a connection string to XML. The connection string to be converted to XML. The connection string does not define exactly one root element. The XML root element converted from the connection string. Parses connection strings based on a settings object whose properties are annotated with . The type of the attribute to search for when determining whether to serialize a property to the connection string. Interface for connection string parameters that should be ignored when parsing. Gets a value that determines whether the connection string parameter should be ignored by the . Redefined to throw an exception. This property has no meaning when property serialization is determined by the existence of the typed parameter. Gets the set of properties which are part of the connection string. The type of the settings object used to look up properties via reflection. The set of properties which are part of the connection string. Gets or sets instance used for evaluating encountered instances of the on modeled connection string values that are marked with . Accessing this property will create a unique type registry for the current attribute type which will initially contain the values found in the and can be augmented with custom types. Set to null to restore use of the default type registry. Parses connection strings based on a settings object whose properties are annotated with and . The type of the attribute to search for when determining whether to serialize a property to the connection string. The type of the attribute to search for when determining which parameters are to be parsed recursively as connection strings. Serializes the given into a connection string. The object whose properties are to be serialized. A connection string containing the serialized properties. Deserializes the connection string parameters into the given . The connection string to be parsed. The object whose properties are to be populated with values from the connection string. is null. A required connection string parameter cannot be found in the connection string. Represents an evaluation type used to hold an expression to evaluate as well as return the value of the evaluation execution. Expected use of this class is with expression-based . Represents an evaluation type used to hold an expression to evaluate as well as return the value of the evaluation execution. Expected use of this class is with expression-based . Gets or sets the expression to evaluate. Expression is expected to return a value. Gets or sets the transpiled expression. Gets or sets the result of the expression evaluation. Value is cached. When is uninitialized, i.e., null, expression will be evaluated to acquire a result. Further requests will return cached result value. To re-evaluate expression, set to null before getting property. Builds a new using the existing and the global pre-defined . New . Gets an instance of that represents a null expression; Gets the global used to resolve types for [eval] typed settings. Applications can register more types and symbols with this property for use with [eval] settings. Ensure the types are registered before settings get bound to configurations sources, see . Defines a type converter for expressions. Pattern:
\\{((?<section>\\w+)\\.(?<key>\\w+)|env\\:(?<env>\\w+))\\}
Options:
RegexOptions.IgnoreCase | RegexOptions.Compiled
Explanation:
○ Match '{'.
○ 1st capture group.
○ Match with 2 alternative expressions.
○ Match a sequence of expressions.
○ "section" capture group.
○ Match a word character atomically at least once.
○ Match '.'.
○ "key" capture group.
○ Match a word character atomically at least once.
○ Match a sequence of expressions.
○ Match a character in the set [Ee].
○ Match a character in the set [Nn].
○ Match a character in the set [Vv].
○ Match ':'.
○ "env" capture group.
○ Match a word character atomically at least once.
○ Match '}'.
 The namespace organizes all Gemstone library functionality related to configuration. The root configuration namespace also includes common configuration classes, e.g., . Represents an attribute that determines if a property or field in a class should be serialized to the configuration file. Creates a new ; defaults to = true. Creates a new with the specified value. Assigns flag that determines if the property or field this modifies should be serialized to the configuration file. Gets or sets flag that determines if the property or field this modifies should be serialized to the configuration file. Represents an attribute that defines the setting name of a property or field in a class for settings when serializing the value to the configuration file. This attribute allows consumers to override the name of the setting going into the configuration file, if the attribute doesn't exist the property or field name is used. Creates a new with the specified value. Assigns name(s) used to serialize setting into config file. Gets the name used to serialize field or property into config file. Gets the names used to serialize field or property into config file. The namespace contains an implementation of that uses a SQLite database table to provide the configuration settings. Defines extensions for adding the to an pipeline. Adds the to the given . The configuration builder. The configuration builder. The SQLite configuration source will be configured with default parameters. DataSource=%PROGRAMDATA%\[AppName]\settings.db TableName=Setting ReadOnly=False Adds the to the given . The configuration builder. The action called to configure the . The configuration builder. Defines parameters for the . Creates a new instance of the class. Gets or sets the name of the table that stores configuration parameters. Gets or sets the path to the database file. Gets or sets the encryption key. Gets or sets the flag that determines whether to enable foreign key constraints. Gets or sets the cahcing mode used by connections to the database. Gets or sets the flag to indicate whether to enable recursive triggers. Gets the connection string as configured by the other properties in this class. The provider of configuration from a . Creates a new instance of the class. The parameters for the configuration source. Loads (or reloads) the data for this provider. Sets a value for a given key. The configuration key to set. The value to set. The source for configuration stored in a SQLite database. Creates a new instance of the class. The action called to set parameters for the source. Builds an from the SQLite configuration source. The configuration builder. The configuration provider. Custom -derived type for the GenerateSettingSubstitutionPatternRegex method. Cached, thread-safe singleton instance. Initializes the instance. Provides a factory for creating instances to be used by methods on . Creates an instance of a used by methods on . Provides the runner that contains the custom logic implementing the specified regular expression. Scan the starting from base.runtextstart for the next match. The text being scanned by the regular expression. Search starting from base.runtextpos for the next location a match could possibly start. The text being scanned by the regular expression. true if a possible match was found; false if no more matches are possible. Determine whether at base.runtextpos is a match for the regular expression. The text being scanned by the regular expression. true if the regular expression matches at the current position; otherwise, false. Helper methods used by generated -derived implementations. Default timeout value set in , or if none was set. Whether is non-infinite. Determines whether the character is part of the [\w] set.