SharpConfig 1.4.0

============================================= ChangeLog for SharpConfig 1.4. Last version was 1.3. Author: Cemalettin Dervis PLEASE NOTE: This release contains some significant API changes and may break your existing API in terms of errors! ============================================= 1. General ----------------------- - Added assemblies for .NET 3.0, 3.5 and 4.5. - Improved API documentation. - Added a sample application. - Internalized some methods that shouldn't be public. - Comment now allows empty values. - Improved section parsing in terms of performance and stability. - SharpConfig now accepts multiple sections and settings that have the same name (issue #5). - Changed array bracket symbols from [] to {}. 2. Fixes ----------------------- - Fixed a bug in the parsing process ( Configuration.Parse() ) that would not reset the temporary fields when the parsing failed. - Fixed a potential memory leak in Configuration.(De)SerializeBinary(). 3. API Changes ----------------------- - Changed Configuration and Section to be collections themselves. It's now possible to iterate through Configuration and Section objects directly instead of accessing their properties such as "Section" and "Settings". - When a section is accessed used Configuration[string] and a section with the specified name couldn't be found, the configuration will create a new section, add it to itself and return that instead. This eases the population of configurations. Note: this functionality is also implemented in Section[string]. - New types: - ConfigurationElement class - Removed types: - CommentCollection class - SectionCollection class - SettingCollection class - ParseFlags enum. Parsing options can now be set via static properties of the Configuration class. - CommentType enum. Replaced by a char, accessible via the Comment.Symbol property. - New methods: - Configuration.LoadFromText() - Setting.SetValue<T>() - Renamed methods: - Configuration.Load(filename) -> Configuration.LoadFromFile() - Configuration.Load(stream) -> Configuration.LoadFromStream() - Added encoding overloads for Configuration.Load/Save methods (issue #1). - Added new static properties to the Configuration class: - NumberFormat (issue #3) - IsCaseSensitive - ValidCommentChars (issue #4) - Changed the Comment struct to a class. - Removed pre-comments. - Changed the Configuration class to be non-sealed. - Renamed the SettingCategory class to Section. - Renamed the SettingCategoryCollection class to SectionCollection. - Added a new property: Setting.ArraySize. - Improved the Setting.GetValue methods. You can now use GetValue() to obtain single and array objects. GetValueArray() has been removed subsequently. - Added a new method: Section.CreateObject<T>(). - Renamed Section.AssignTo<T>() to MapTo<T>(). - Improved MapTo<T>() and added an overload that specifies a value for case-sensitive property assignment.