IdeaBlade DevForce 2010 Help Reference
IdeaBladeConfig Class
Members  See Also  Send Feedback
IdeaBlade.Core Assembly > IdeaBlade.Core Namespace : IdeaBladeConfig Class



Used to manage configuration properties within a DevForce application.

Object Model

IdeaBladeConfig ClassIdeaBladeConfig ClassLoggingElement ClassNotificationServiceElement ClassObjectServerElement ClassSimpleElementCollection ClassString Class

Syntax

Visual Basic (Declaration) 
<XmlRootAttribute("http://schemas.ideablade.com/2010/IdeaBladeConfig")>
<XmlTypeAttribute("ideablade.configuration")>
Public Class IdeaBladeConfig 
   Implements System.ICloneable 
Visual Basic (Usage)Copy Code
Dim instance As IdeaBladeConfig
C# 
[XmlRootAttribute("http://schemas.ideablade.com/2010/IdeaBladeConfig")]
[XmlTypeAttribute("ideablade.configuration")]
public class IdeaBladeConfig : System.ICloneable  
C++/CLI 
[XmlRootAttribute("http://schemas.ideablade.com/2010/IdeaBladeConfig")]
[XmlTypeAttribute("ideablade.configuration")]
public ref class IdeaBladeConfig : public 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 debuglog.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 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

See Also

© 2013 All Rights Reserved.