Item Property (Attachments Collection)
Item Property (Attachments Collection)
The Item property returns a single Attachment object from the Attachments collection. Read-only.
Syntax
objAttachColl.Item(index)
objAttachColl.Item(recordKey)
index
Long. An integer ranging from 1 to objAttachColl.Count.
recordKey
String. The MAPI record key of an individual attachment.
The Item property is the default property of an Attachments collection, meaning that objAttachColl**(index)** is syntactically equivalent to objAttachColl.Item(index) in Microsoft® Visual Basic® code.
Data Type
Object (Attachment)
Remarks
The Item property works like an accessor property for small collections.
The Item(index) syntax selects an arbitrary Attachment object within the Attachments collection.
The Item(recordKey) syntax returns the first Attachment object with a MAPI record key equivalent to the string specified by recordKey. You can obtain the MAPI record key of an attachment through its Fields collection, but you cannot convert it programmatically to the requisite string format with Visual Basic. The record key is in a counted binary format for which Visual Basic and CDO have no corresponding data type.
The recordKey parameter corresponds to the MAPI property PR_RECORD_KEY, converted to a string of hexadecimal characters.
Although the Item property itself is read-only, the Attachment object it returns can be accessed in the normal manner, and its properties retain their respective read/write or read-only accessibility.
Example
This code fragment shows the Count and Item properties working together to traverse the collection:
' from Util_SmallCollectionCount(objAttachColl As Object)
Dim strItemName(100) as String
Dim i As Integer ' loop counter
' error handling omitted from this fragment ...
For i = 1 To objAttachColl.Count Step 1
strItemName(i) = objAttachColl.Item(i).Name
' or = objAttachColl(i) since Item and Name are default properties
If 100 = i Then ' max size of string array
Exit Function
End If
Next i