IdeaBladeConfig Class

Used to manage configuration properties within a DevForce application.

Object Model

Syntax

Visual Basic
C#

'Declaration
 
<XmlTypeAttribute("ideablade.configuration")>
<XmlRootAttribute("http://schemas.ideablade.com/2010/IdeaBladeConfig")>
Public Class IdeaBladeConfig 
   Implements System.ICloneable

'Usage
 
Dim instance As IdeaBladeConfig

[XmlType("ideablade.configuration")]
[XmlRoot("http://schemas.ideablade.com/2010/IdeaBladeConfig")]
public class IdeaBladeConfig : System.ICloneable

Remarks

IdeaBladeConfig is the in-memory representation of the ideaBlade.configuration section in a configuration file. Use IdeaBladeConfig.Instance to obtain the loaded configuration information; there is usually no need for you to construct an instance of this class.

DevForce probes for a .config file somewhat differently than standard .NET looks for the .config file. The probing sequence DevForce uses to find this file is as follows - note that probing continues until a valid configuration is found and loaded -

1) If the ConfigFileLocation static property is set, this directory is searched for any file named or matching "*.exe.config", "web.config" or "app.config", in this order. Note that any files matching *.dll.config will not be found.

2) If the ConfigFileAssembly static property is set, the assembly is probed for an embedded resource named "app.config".

3) The BaseAppDirectory for a file named or matching "*.exe.config" or "web.config" or "app.config", in this order. This property is readonly and determined at run time, and is usually the directory from which the entry assembly was loaded.

4) An embedded resource named "app.config" in the entry assembly.

If configuration information cannot be found or cannot be loaded, then your application may not run correctly. If your configuration cannot be loaded or you think the wrong information has been loaded, check the logFile output (usually named DevForceDebugLog.xml) for tracing messages. All probe attempts are written to the log file.

The .config file holding the IdeaBlade configuration information can also contain other configuration sections. If you embed the file in an assembly .NET will be unable to find these other configuration sections, since embedding the app.config is a DevForce-specific feature. In these situations, you should instead use an appropriately named loose .config file (e.g., MyApp.exe.config, web.config) so that the System.Configuration.ConfigurationManager can load all configuration data.

Inheritance Hierarchy

System.Object
IdeaBlade.Core.IdeaBladeConfig

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

IdeaBladeConfig Members
IdeaBlade.Core Namespace