The Folder object represents a folder or container within the MAPI system. A folder can contain subfolders and messages.
| Specified in type library: | CDO.DLL |
| First available in: | CDO Library version 1.0.a |
| Parent objects: | Folders collection InfoStore Session |
| Child objects: | Fields collection Folders collection Messages collection |
| Default property: | (none) |
Name |
Available since version | Type |
Access |
|---|---|---|---|
| Application | 1.0.a | String | Read-only |
| Class | 1.0.a | Long | Read-only |
| Fields | 1.0.a | Field object or Fields collection object | Read-only |
| FolderID | 1.0.a | String | Read-only |
| Folders | 1.0.a | Folders collection object | Read-only |
| HiddenMessages | 1.2 | Messages collection object | Read-only |
| ID | 1.0.a | String | Read-only |
| MAPIOBJECT | 1.0.a | IUnknown object | Read/write (Note: Not available to Visual Basic applications) |
| Messages | 1.0.a | Messages collection object | Read-only |
| Name | 1.0.a | String | Read/write |
| Parent | 1.0.a | Folders collection object or InfoStore object | Read-only |
| Session | 1.0.a | Session object | Read-only |
| StoreID | 1.0.a | String | Read-only |
Name |
Available since version | Parameters |
|---|---|---|
| CopyTo | 1.1 | folderID as String, (optional) storeID as String, (optional) name as String, (optional) copySubfolders as Boolean |
| Delete | 1.0.a | (none) |
| IsSameAs | 1.1 | objFolder2 as Object |
| MoveTo | 1.1 | folderID as String, (optional) storeID as String |
| Update | 1.0.a | (optional) makePermanent as Boolean, (optional) refreshObject as Boolean |
A Folder object can be rendered into HTML hypertext using the CDO Rendering ObjectRenderer object. To specify this, set the object renderer's DataSource property to the Folder object itself. The individual properties that can be rendered with the RenderProperty method are indicated in the Folder object property descriptions.
A Folder object can also be rendered as the parent of a Messages collection, using the ContainerRenderer object. The individual properties that can be rendered with the RenderProperty method are indicated in the Folder object property descriptions.
Changes to a folder are not saved by MAPI until you call its Update method.