Navigation : Products / AbyssLabs.INIFile Component

AbyssLabs.INIFile Component

Version number: 1.2.0.14
Last updated: September 26, 2004
License type: Freeware
Component type: In-process COM-server
Threading model: Apartment
ProgId: AbyssLabs.INIFile
CLSID: 243C45C8-8EF2-4EF6-B215-8EC4F7DEC3A3

Product overview

This component is a regular in-proc COM-server providing an access to INI files from such script languages as VBScript, JavaScript, ASP, WSH, and T-SQL. INI files can be used for storing and retrieving an application settings between sessions, for configuration of any application that stores its configuration in INI files and etc.

Usage

= to create an instance: set ini = CreateObject( "AbyssLabs.INIFile" )
= to write a value: call ini.Save( "c:\path\file.ini", "my_section", "my_key", "some_value" )
= to read a data: value = ini.Read( "c:\path\file.ini", "my_section", "my_key", "default_value" )
= to delete a key: value = ini.DeleteKey( "c:\path\file.ini", "my_section", "my_key" )
= to delete a whole section: value = ini.DeleteSection( "c:\path\file.ini", "my_section" )

= to get a list of all sections: sections = ini.Sections( "c:\path\file.ini" )
This function returns a "1-base array". Each item of that array contains a section name. Use UBound(sections) to get a number of sections. See test1.vbs file for the sample code.

= to get all key/value pairs of the specified section: keys = ini.AllKeys( "c:\path\file.ini", "section" )
This function returns "1-based array" containing whole section data formatted as "KEY=VALUE". Use UBound(keys) to get a number of array items. See test2.vbs for the sample code.

Notes

Read() function can not read a string that is longer that 1024 characters.

In AllKeys(), the specified profile section must not exceed 32000 characters.

In NTFS file system, some access permissions can be assigned to the INI file. By default, such permissions are "full access for everyone", but sometime they can limit an access. This component can not break these restrictions.

This component has Apartment threading model. That means following for ASP/IIS programmers:
= it can be created in page, session, and application scope
= in an application scope it can be created using <OBJECT ...> notation only
= the page scope is highly recommended due to lack of performance in other cases

Installation procedure

The installation package contains a usual installation program that installs the component itself, all required libraries, and documentation files. A default installation folder is C:\Program files\AbyssLabs\INIFile.

Technical support