Zaks.Collection Readme

Zaks.Collection : A Generic COM Collection object
Version : 1.0
Release Date : 25 May 98
Copyright (c) 1998 by Simon Fell. All rights reserved.
Contact:
email : Simon Fell
WWW : Zaks Solutions Web Site

If you have any problems using this component please report it.

Description
Zaks.Collection allows any number of Variants to be stored, each associated with a name(key).

Installation Instructions
To use this ASP component move the DLL into a sub directory (like \winnt\system32\inetsrv\asp\Cmpnts or \winnt\system32) and run (from the directory copied to)

regsvr32 zakscollection.dll
If you are replacing an earlier version, remember to shutdown & restart IIS to reload the new version.

License Agreement
Zaks.Collection is copyright (C) 1998 by Simon Z. Fell

Zaks.Collection is currently free to download and use. You may NOT redistribute the package through BBS, Internet, FTP sites or by any other means without written permission from the Author.
You are prohibited from:
charging a fee or requesting donations for the package;
modifying the package.

All trademarks/registered names acknowledged.

Zaks.Collection is provided as is, without warranty of any kind. The author shall not be liable for damages of any kind. Use of this software indicates you agree to this.

How To Use
Example ASP & WSH scripts are included in the download

Object Properties / Methods
All the code snippets assume that

set c = Server.CreateObject("Zaks.Collection")

has already been called.

Property : Item(szKey) : Allows access to a particular item in the collection, using the key szKey (is the default property)

Examples
c.Item("One") = "The First One"
c("Two") = "The Second one"
msgbox c.Item("ErrorDesc1")
msgbox c("ErrorDesc2")
c("client") = objClient

Property : Count : Returns the current number of entries in the collection.
```
Examples
msgbox c.count
```
Method : Add(szKey, vItem) : Adds a new item (vItem) to the collection with the key szKey, returns true if the item was added successfully, false if there is already an entry with this key.
```
Examples
bOK = c.add("ErrorDesc1", "Don't press the red button until the end !")
bOK = c.add("szCookies", request("HTTP_COOKIE"))
```
Method : Remove(szKey) : Removes an item from the collection with the key szKey, returns true if the item was removed successfully, false if it doesn't exist.
```
Examples
bOK = c.Remove("ErrorDesc1")
bOK = c.Remove("szCookies")
```
Property : _NewEnum : This creates a new enumerator, to enumerator the values in the collection (is the default enumerator).
```
Example
For each vItem in c
	msgbox vItem
next
```
Property : Keys : This creates a new enumerator, to enumerator the keys in the collection.
```
Example
For each key in c.keys
	msgbox key
next
```