Delete Method (AddressEntries Collection)

Delete Method (AddressEntries Collection)

The Delete method removes all the AddressEntry objects from the AddressEntries collection.

Syntax

objAddrEntriesColl.Delete( )

Remarks

The Delete method performs an irreversible operation on the collection. It calls Release on the collection's reference to every AddressEntry object. If you have another reference to an address entry, you can still access its properties and methods, but you can never again associate it with any collection because the Add method always creates a new object. You should Set your reference variable either to Nothing or to another address entry.

The final Release on each AddressEntry object takes place when you assign your reference variable to Nothing, or when you call Delete if you had no other reference. At this point the object is removed from memory. Attempted access to a released object results in an error return of CdoE_INVALID_OBJECT.

Be cautious using the Delete method with a collection, because it deletes all the collection's member objects. To delete only one AddressEntry object, use the Delete method specific to that object.

The Delete method on a large collection takes effect immediately and is permanent. A deleted member cannot be recovered. However, the collection itself is still valid, and you can Add new members to it.

The CDO Library does not support addition, deletion, or modification of members of a distribution list (DL) on the global address list (GAL).

See Also

Concepts

AddressEntries Collection Object