Share via


ContactItem Members (Outlook)

Represents a contact in a Contacts folder.

Methods

Name

Description

AddBusinessCardLogoPicture

Adds a logo picture to the current Electronic Business Card of the contact item.

AddPicture

Adds a picture to a contact item.

ClearTaskFlag

Clears the ContactItem object as a task.

Close

Closes and optionally saves changes to the Outlook item.

Copy

Creates another instance of an object.

Delete

Deletes an object from the collection.

Display

Displays a new Inspector object for the item.

ForwardAsBusinessCard

Creates a new MailItem object containing contact information and, optionally, an Electronic Business Card (EBC) image based on the specified ContactItem object.

ForwardAsVcard

Creates a MailItem and attaches the contact information in vCard format.

GetConversation

Obtains a Conversation object that represents the conversation to which this item belongs.

MarkAsTask

Marks a ContactItem object as a task and assigns a task interval for the object.

Move

Moves a Microsoft Outlook item to a new folder.

PrintOut

Prints the Outlook item using all default settings.The PrintOut method is the only Outlook method that can be used for printing.

RemovePicture

Removes a picture from a Contacts item.

ResetBusinessCard

Resets the Electronic Business Card on the contact item to the default business card, deleting any custom layout and logo on the Electronic Business Card.

Save

Saves the Microsoft Outlook item to the current folder or, if this is a new item, to the Outlook default folder for the item type.

SaveAs

Saves the Microsoft Outlook item to the specified path and in the format of the specified file type. If the file type is not specified, the MSG format (.msg) is used.

SaveBusinessCardImage

Saves an image of the business card generated from the specified ContactItem object.

ShowBusinessCardEditor

Displays the electronic business card (EBC) editor dialog box for the ContactItem object.

ShowCategoriesDialog

Displays the Show Categories dialog box, which allows you to select categories that correspond to the subject of the item.

ShowCheckPhoneDialog

Displays the Check Phone Number dialog box for a specified telephone number contained by a ContactItem object.

Properties

Name

Description

Account

Returns or sets a String representing the account for the contact. Read/write.

Actions

Returns an Actions collection that represents all the available actions for the item. Read-only.

Anniversary

Returns or sets a Date indicating the anniversary date for the contact. Read/write.

Application

Returns an Application object that represents the parent Outlook application for the object. Read-only.

AssistantName

Returns or sets a String representing the name of the person who is the assistant for the contact. Read/write.

AssistantTelephoneNumber

Returns or sets a String representing the telephone number of the person who is the assistant for the contact. Read/write.

Attachments

Returns an Attachments object that represents all the attachments for the specified item. Read-only.

AutoResolvedWinner

Returns a Boolean that determines if the item is a winner of an automatic conflict resolution. Read-only.

BillingInformation

Returns or sets a String representing the billing information associated with the Outlook item. Read/write.

Birthday

Returns or sets a Date indicating the birthday for the contact. Read/write.

Body

Returns or sets a String representing the clear-text body of the Outlook item. Read/write.

Business2TelephoneNumber

Returns or sets a String representing the second business telephone number for the contact. Read/write.

BusinessAddress

Returns or sets a String representing the whole, unparsed business address for the contact. Read/write.

BusinessAddressCity

Returns or sets a String representing the city name portion of the business address for the contact. Read/write.

BusinessAddressCountry

Returns or sets a String representing the country/region code portion of the business address for the contact. Read/write.

BusinessAddressPostalCode

Returns or sets a String representing the postal code (zip code) portion of the business address for the contact. Read/write.

BusinessAddressPostOfficeBox

Returns or sets a String representing the post office box number portion of the business address for the contact. Read/write.

BusinessAddressState

Returns or sets a String representing the state code portion of the business address for the contact. Read/write.

BusinessAddressStreet

Returns or sets a String representing the street address portion of the business address for the contact. Read/write.

BusinessCardLayoutXml

Returns or sets a String that represents the XML markup for the layout of the Electronic Business Card. Read/write.

BusinessCardType

Returns an OlBusinessCardType constant that specifies the type of Electronic Business Card used by this contact. Read-only.

BusinessFaxNumber

Returns or sets a String representing the business fax number for the contact. Read/write.

BusinessHomePage

Returns or sets a String representing the URL of the business Web page for the contact. Read/write.

BusinessTelephoneNumber

Returns or sets a String representing the first business telephone number for the contact. Read/write.

CallbackTelephoneNumber

Returns or sets a String representing the callback telephone number for the contact. Read/write.

CarTelephoneNumber

Returns or sets a String representing the car telephone number for the contact. Read/write.

Categories

Returns or sets a String representing the categories assigned to the Outlook item. Read/write.

Children

Returns or sets a String representing the names of the children of the contact. Read/write.

Class

Returns an OlObjectClass constant indicating the object's class. Read-only.

Companies

Returns or sets a String representing the names of the companies associated with the Outlook item. Read/write.

CompanyAndFullName

Returns a String representing the concatenated company name and full name for the contact. Read-only.

CompanyLastFirstNoSpace

Returns a String representing the company name for the contact followed by the concatenated last name, first name, and middle name with no space between the last and first names. Read-only.

CompanyLastFirstSpaceOnly

Returns a String representing the company name for the contact followed by the concatenated last name, first name, and middle name with spaces between the last, first, and middle names. Read-only.

CompanyMainTelephoneNumber

Returns or sets a String representing the company main telephone number for the contact. Read/write.

CompanyName

Returns or sets a String representing the company name for the contact. Read/write.

ComputerNetworkName

Returns or sets a String representing the name of the computer network for the contact. Read/write.

Conflicts

Return the Conflicts object that represents the items that are in conflict for any Outlook item object. Read-only.

ConversationID

Returns a String that uniquely identifies a Conversation object that the ContactItem object belongs to. Read-only.

ConversationIndex

Returns a String that indicates the relative position of the item within the conversation thread. Read-only.

ConversationTopic

Returns a String representing the topic of the conversation thread of the Outlook item. Read-only.

CreationTime

Returns a Date indicating the creation time for the Outlook item. Read-only.

CustomerID

Returns or sets a String representing the customer ID for the contact. Read/write.

Department

Returns or sets a String representing the department name for the contact. Read/write.

DownloadState

Returns a constant that belongs to the OlDownloadState enumeration indicating the download state of the item. Read-only.

Email1Address

Returns or sets a String representing the e-mail address of the first e-mail entry for the contact. Read/write.

Email1AddressType

Returns or sets a String representing the address type (such as EX or SMTP) of the first e-mail entry for the contact. Read/write.

Email1DisplayName

Returns a String representing the display name of the first e-mail address for the contact. Read/write.

Email1EntryID

Returns a String representing the entry ID of the first e-mail address for the contact. Read-only.

Email2Address

Returns or sets a String representing the e-mail address of the second e-mail entry for the contact. Read/write.

Email2AddressType

Returns or sets a String representing the address type (such as EX or SMTP) of the second e-mail entry for the contact. Read/write.

Email2DisplayName

Returns a String representing the display name of the second e-mail entry for the contact. Read/write.

Email2EntryID

Returns a String representing the entry ID of the second e-mail entry for the contact. Read-only.

Email3Address

Returns or sets a String representing the e-mail address of the third e-mail entry for the contact. Read/write.

Email3AddressType

Returns or sets a String representing the address type (such as EX or SMTP) of the third e-mail entry for the contact. Read/write.

Email3DisplayName

Returns a String representing the display name of the third e-mail entry for the contact. Read/write.

Email3EntryID

Returns a String representing the entry ID of the third e-mail entry for the contact. Read-only.

EntryID

Returns a String representing the unique Entry ID of the object. Read-only.

FileAs

Returns or sets a String indicating the default keyword string assigned to the contact when it is filed. Read/write.

FirstName

Returns or sets a String representing the first name for the contact. Read/write.

FormDescription

Returns the FormDescription object that represents the form description for the specified Outlook item. Read-only.

FTPSite

Returns or sets a String representing the FTP site entry for the contact. Read/write.

FullName

Returns or sets a String specifying the whole, unparsed full name for the contact. Read/write.

FullNameAndCompany

Returns a String representing the full name and company of the contact by concatenating the values of the FullName and CompanyName properties. Read-only.

Gender

Returns or sets an OlGender constant indicating the gender of the contact. Read/write.

GetInspector

Returns an Inspector object that represents an inspector initialized to contain the specified item. Read-only.

GovernmentIDNumber

Returns or sets a String representing the government ID number for the contact. Read/write.

HasPicture

Returns True if a Contacts item has a picture associated with it. Read-only

Hobby

Returns or sets a String representing the hobby for the contact. Read/write.

Home2TelephoneNumber

Returns or sets a String representing the second home telephone number for the contact. Read/write.

HomeAddress

Returns or sets a String representing the full, unparsed text of the home address for the contact. Read/write.

HomeAddressCity

Returns or sets a String representing the city portion of the home address for the contact. Read/write.

HomeAddressCountry

Returns or sets a String representing the country/region portion of the home address for the contact. Read/write.

HomeAddressPostalCode

Returns or sets a String representing the postal code portion of the home address for the contact. Read/write.

HomeAddressPostOfficeBox

Returns or sets a String the post office box number portion of the home address for the contact. Read/write.

HomeAddressState

Returns or sets a String representing the state portion of the home address for the contact. Read/write.

HomeAddressStreet

Returns or sets a String representing the street portion of the home address for the contact. Read/write.

HomeFaxNumber

Returns or sets a String representing the home fax number for the contact. Read/write.

HomeTelephoneNumber

Returns or sets a String representing the first home telephone number for the contact. Read/write.

IMAddress

Returns or sets a String that represents a contact's Microsoft Instant Messenger address. Read/write.

Importance

Returns or sets an OlImportance constant indicating the relative importance level for the Outlook item. Read/write.

Initials

Returns or sets a String representing the initials for the contact. Read/write.

InternetFreeBusyAddress

Returns or sets a String corresponding to the Address box on the Details tab for a contact. Read/write.

IsConflict

Returns a Boolean that determines if the item is in conflict. Read-only.

ISDNNumber

Returns or sets a String representing the ISDN number for the contact. Read/write.

IsMarkedAsTask

Returns a Boolean value that indicates whether the ContactItem is marked as a task. Read-only.

ItemProperties

Returns an ItemProperties collection that represents all standard and user-defined properties associated with the Outlook item. Read-only.

JobTitle

Returns or sets a String representing the job title for the contact. Read/write.

Journal

Returns a Boolean that indicates True if the transaction of the contact will be journalized. Read/write.

Language

Returns or sets a String that represents the language in which the contact writes messages. Read/write.

LastFirstAndSuffix

Returns a String representing the last name, first name, middle name, and suffix of the contact. Read-only.

LastFirstNoSpace

Returns a String representing the concatenated last name, first name, and middle name of the contact with no space between the last name and the first name. Read-only.

LastFirstNoSpaceAndSuffix

Returns a String that contains the last name, first name, and suffix of the user without a space. Read-only

LastFirstNoSpaceCompany

Returns a String representing the concatenated last name, first name, and middle name of the contact with no space between the last name and the first name. Read-only.

LastFirstSpaceOnly

Returns a String representing the concatenated last name, first name, and middle name of the contact with spaces between them. Read-only.

LastFirstSpaceOnlyCompany

Returns a String representing the concatenated last name, first name, and middle name of the contact with spaces between them. Read-only.

LastModificationTime

Returns a Date specifying the date and time that the Outlook item was last modified. Read-only.

LastName

Returns or sets a String representing the last name for the contact. Read/write.

LastNameAndFirstName

Returns a String representing the concatenated last name and first name for the contact. Read-only.

Links

Returns a Links collection that represents the contacts to which the item is linked. Read-only.

MailingAddress

Returns or sets a String representing the full, unparsed selected mailing address for the contact. Read/write.

MailingAddressCity

Returns or sets a String representing the city name portion of the selected mailing address of the contact. Read/write.

MailingAddressCountry

Returns or sets a String representing the country/region code portion of the selected mailing address of the contact. Read/write.

MailingAddressPostalCode

Returns or sets a String representing the postal code (zip code) portion of the selected mailing address of the contact. Read/write.

MailingAddressPostOfficeBox

Returns or sets a String representing the post office box number portion of the selected mailing address of the contact. Read/write.

MailingAddressState

Returns or sets a String representing the state code portion for the selected mailing address of the contact. Read/write.

MailingAddressStreet

Returns or sets a String representing the street address portion of the selected mailing address of the contact. Read/write.

ManagerName

Returns or sets a String representing the manager name for the contact. Read/write.

MarkForDownload

Returns or sets an OlRemoteStatus constant that determines the status of an item once it is received by a remote user. Read/write.

MessageClass

Returns or sets a String representing the message class for the Outlook item. Read/write.

MiddleName

Returns or sets a String representing the middle name for the contact. Read/write.

Mileage

Returns or sets a String representing the mileage for an item. Read/write.

MobileTelephoneNumber

Returns or sets a String representing the mobile telephone number for the contact. Read/write.

NetMeetingAlias

Returns or sets a String indicating the user's Microsoft NetMeeting ID, or alias. Read/write.

NetMeetingServer

Returns or sets a String specifying the name of the Microsoft NetMeeting server being used for an online meeting. Read/write.

NickName

Returns or sets a String representing the nickname for the contact. Read/write.

NoAging

Returns or sets a Boolean value that is True to not age the Outlook item. Read/write.

OfficeLocation

Returns or sets a String specifying the specific office location (for example, Building 1 Room 1 or Suite 123) for the contact. Read/write.

OrganizationalIDNumber

Returns or sets a String representing the organizational ID number for the contact. Read/write.

OtherAddress

Returns or sets a String representing the other address for the contact. Read/write.

OtherAddressCity

Returns or sets a String representing the city portion of the other address for the contact. Read/write.

OtherAddressCountry

Returns or sets a String representing the country/region portion of the other address for the contact. Read/write.

OtherAddressPostalCode

Returns or sets a String representing the postal code portion of the other address for the contact. Read/write.

OtherAddressPostOfficeBox

Returns or sets a String representing the post office box portion of the other address for the contact. Read/write.

OtherAddressState

Returns or sets a String representing the state portion of the other address for the contact. Read/write.

OtherAddressStreet

Returns or sets a String representing the street portion of the other address for the contact. Read/write.

OtherFaxNumber

Returns or sets a String representing the other fax number for the contact. Read/write.

OtherTelephoneNumber

Returns or sets a String representing the other telephone number for the contact. Read/write.

OutlookInternalVersion

Returns a Long representing the build number of the Outlook application for an Outlook item. Read-only.

OutlookVersion

Returns a String indicating the major and minor version number of the Outlook application for an Outlook item. Read-only.

PagerNumber

Returns or sets a String representing the pager number for the contact. Read/write.

Parent

Returns the parent Object of the specified object. Read-only.

PersonalHomePage

Returns or sets a String representing the URL of the personal Web page for the contact. Read/write.

PrimaryTelephoneNumber

Returns or sets a String specifying the primary telephone number for the contact. Read/write.

Profession

Returns or sets a String indicating the profession for the contact. Read/write.

PropertyAccessor

Returns a PropertyAccessor object that supports creating, getting, setting, and deleting properties of the parent ContactItem object. Read-only.

RadioTelephoneNumber

Returns or sets a String indicating the radio telephone number for the contact. Read/write.

ReferredBy

Returns or sets a String specifying the referral name entry for the contact. Read/write.

ReminderOverrideDefault

Returns or sets a Boolean value that is True if the reminder overrides the default reminder behavior for the item. Read/write.

ReminderPlaySound

Returns or sets a Boolean value that is True if the reminder should play a sound when it occurs for this item. Read/write.

ReminderSet

Returns or sets a Boolean value that is True if a reminder has been set for this item. Read/write.

ReminderSoundFile

Returns or sets a String indicating the path and file name of the sound file to play when the reminder occurs for the Outlook item. Read/write.

ReminderTime

Returns or sets a Date indicating the date and time at which the reminder should occur for the specified item. Read/write.

RTFBody

Returns or sets a Byte array that represents the body of the Microsoft Outlook item in Rich Text Format. Read/write.

Saved

Returns a Boolean value that is True if the Outlook item has not been modified since the last save. Read-only.

SelectedMailingAddress

Returns or sets an OlMailingAddress constant indicating the type of the mailing address for the contact. Read/write.

Sensitivity

Returns or sets a constant in the OlSensitivity enumeration indicating the sensitivity for the Outlook item. Read/write.

Session

Returns the NameSpace object for the current session. Read-only.

Size

Returns a Long indicating the size (in bytes) of the Outlook item. Read-only.

Spouse

Returns or sets a String indicating the spouse/partner name entry for the contact. Read/write.

Subject

Returns or sets a String indicating the subject for the Outlook item. Read/write.

Suffix

Returns or sets a String indicating the name suffix (such as Jr., III, or Ph.D.) for the specified contact. Read/write.

TaskCompletedDate

Returns or sets a Date value that represents the completion date of the task for this ContactItem. Read/write.

TaskDueDate

Returns or sets a Date value that represents the due date of the task for this ContactItem. Read/write.

TaskStartDate

Returns or sets a Date value that represents the start date of the task for this ContactItem object. Read/write.

TaskSubject

Returns or sets a String value that represents the subject of the task for the ContactItem object. Read/write.

TelexNumber

Returns or sets a String indicating the telex number for the contact. Read/write.

Title

Returns or sets a String indicating the title for the contact. Read/write.

ToDoTaskOrdinal

Returns or sets a Date value that represents the ordinal value of the task for the ContactItem. Read/write.

TTYTDDTelephoneNumber

Returns or sets a String specifying the TTY/TDD telephone number for the contact. Read/write.

UnRead

Returns or sets a Boolean value that is True if the Outlook item has not been opened (read). Read/write.

User1

Returns or sets a String specifying the first field on the Contacts form intended for miscellaneous use for the contact. Read/write.

User2

Returns or sets a String specifying the second field on the Contacts form intended for miscellaneous use for the contact. Read/write.

User3

Returns or sets a String specifying the third field on the Contacts form intended for miscellaneous use for the contact. Read/write.

User4

Returns or sets a String specifying the fourth field on the Contacts form intended for miscellaneous use for the contact. Read/write.

UserProperties

Returns the UserProperties collection that represents all the user properties for the Outlook item. Read-only.

WebPage

Returns or sets a String indicating the URL of the Web page for the contact. Read/write.

YomiCompanyName

Returns or sets a String indicating the Japanese phonetic rendering (yomigana) of the company name for the contact. Read/write.

YomiFirstName

Returns or sets a String indicating the Japanese phonetic rendering (yomigana) of the first name for the contact. Read/write.

YomiLastName

Returns or sets a String indicating the Japanese phonetic rendering (yomigana) of the last name for the contact. Read/write.

Events

Name

Description

AfterWrite

Occurs after Microsoft Outlook has saved the item.

AttachmentAdd

Occurs when an attachment has been added to an instance of the parent object.

AttachmentRead

Occurs when an attachment in an instance of the parent object has been opened for reading.

AttachmentRemove

Occurs when an attachment has been removed from an instance of the parent object.

BeforeAttachmentAdd

Occurs before an attachment is added to an instance of the parent object.

BeforeAttachmentPreview

Occurs before an attachment associated with an instance of the parent object is previewed.

BeforeAttachmentRead

Occurs before an attachment associated with an instance of the parent object is read from the file system, an attachment stream, or an Attachment object.

BeforeAttachmentSave

Occurs just before an attachment is saved.

BeforeAttachmentWriteToTempFile

Occurs before an attachment associated with an instance of the parent object is written to a temporary file.

BeforeAutoSave

Occurs before the item is automatically saved by Outlook.

BeforeCheckNames

Occurs just before Microsoft Outlook starts resolving names in the recipient collection for an item (which is an instance of the parent object).

BeforeDelete

Occurs before an item (which is an instance of the parent object) is deleted.

BeforeRead

Occurs before Microsoft Outlook begins to read the properties for the item.

Close

Occurs when the inspector associated with an item (which is an instance of the parent object) is being closed.

CustomAction

Occurs when a custom action of an item (which is an instance of the parent object) executes.

CustomPropertyChange

Occurs when a custom property of an item (which is an instance of the parent object) is changed.

Forward

Occurs when the user selects the Forward action for an item (which is an instance of the parent object).

Open

Occurs when an instance of the parent object is being opened in an Inspector.

PropertyChange

Occurs when an explicit built-in property (for example, Subject) of an instance of the parent object is changed.

Read

Occurs when an instance of the parent object is opened for editing by the user.

Reply

Occurs when the user selects the Reply action for an item (which is an instance of the parent object).

ReplyAll

Occurs when the user selects the ReplyAll action for an item (which is an instance of the parent object).

Send

Occurs when the user selects the Send action for an item (which is an instance of the parent object).

Unload

Occurs before an Outlook item is unloaded from memory, either programmatically or by user action.

Write

Occurs when an instance of the parent object is saved, either explicitly (for example, using the Save or SaveAs methods) or implicitly (for example, in response to a prompt when closing the item's inspector).