Contact Class

Definition

Represents a contact. The properties that are available on contacts are defined by the ContactSchema class.

public ref class Contact : Microsoft::Exchange::WebServices::Data::Item
public class Contact : Microsoft.Exchange.WebServices.Data.Item
Public Class Contact
Inherits Item
Inheritance

Constructors

Contact(ExchangeService)

Initializes an unsaved local instance of the Contact class. To bind to an existing contact, use the Bind method instead.

Properties

Alias

Gets the contact's alias. This property was introduced in Exchange Server 2010 SP2 and the Exchange Web Services (EWS) Managed API 1.2.

AllowedResponseActions

Gets a value that indicates which response actions are allowed on this item. Examples of response actions are Reply and Forward.

(Inherited from Item)
ArchiveTag

Gets or sets the archive tag. The ArchiveTag property is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2013.

(Inherited from Item)
AssistantName

Gets or sets the name of the contact's assistant.

Attachments

Gets a list of the attachments to this item.

(Inherited from Item)
Birthday

Gets or sets the birthday of the contact.

Body

Gets or sets the body of this item.

(Inherited from Item)
BusinessHomePage

Gets or sets the business home page of the contact.

Categories

Gets or sets the list of categories that are associated with this item.

(Inherited from Item)
Children

Gets or sets a list of children for the contact.

Companies

Gets or sets a list of companies for the contact.

CompanyName

Gets or sets the company name of the contact.

CompleteName

Gets or sets the complete name of the contact.

ContactSource

Gets the source of the contact.

ConversationId

Gets the ID of the conversation that this item is part of.

(Inherited from Item)
Culture

Gets or sets the culture that is associated with this item.

(Inherited from Item)
DateTimeCreated

Gets the date and time at which this item was created.

(Inherited from Item)
DateTimeReceived

Gets the time when this item was received.

(Inherited from Item)
DateTimeSent

Gets the date and time at which this item was sent.

(Inherited from Item)
Department

Gets or sets the department of the contact.

DirectoryId

Gets the contact's directory identifier. This property was introduced in Exchange Server 2010 SP2 and the Exchange Web Services (EWS) Managed API 1.2.

DirectoryPhoto

Gets the contact's photo. This property was introduced in Exchange Server 2010 SP2 and the Exchange Web Services (EWS) Managed API 1.2.

DirectReports

Gets the contact's direct reports. This property was introduced in Exchange Server 2010 SP2 and the Exchange Web Services (EWS) Managed API 1.2.

DisplayCc

Gets a text string that lists the Cc recipients of this item.

(Inherited from Item)
DisplayName

Gets or sets the display name of the contact.

DisplayTo

Gets a text string that lists the To recipients of this item.

(Inherited from Item)
EffectiveRights

Gets a value that indicates the effective rights that the current authenticated user has on this item.

(Inherited from Item)
EmailAddresses

Gets an indexed list of e-mail addresses for the contact.

EntityExtractionResult

Gets the entity extraction information on the item. The EntityExtractionResult property is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2013.

(Inherited from Item)
ExtendedProperties

Gets a list of extended properties that are defined on this item.

(Inherited from Item)
FileAs

Gets or sets the name under which this contact is filed. This property can be manually set or can be automatically calculated based on the value of the FileAsMapping property.

FileAsMapping

Gets or sets a value that indicates how the FileAs property should be automatically calculated.

Flag

Gets or sets a flag value that indicates the status, start date, due date, or completion date for an item. The Flag property is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2013.

(Inherited from Item)
Generation

Gets or sets the generation of the contact.

GivenName

Gets or sets the given name of the contact.

HasAttachments

Gets a value that indicates whether the item has attachments.

(Inherited from Item)
HasPicture

Gets a value that indicates whether the contact has a picture.

IconIndex

Gets the icon index. The IconIndex property is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2013.

(Inherited from Item)
Id

Gets the ID of this item.

(Inherited from Item)
ImAddresses

Gets an indexed list of instant messaging (IM) addresses for the contact.

Importance

Gets or sets the importance of this item.

(Inherited from Item)
Initials

Gets or sets the initials of the contact.

InReplyTo

Gets or sets the In-Reply-To reference of this item.

(Inherited from Item)
InstanceKey

Gets the item instance key. The InstanceKey property is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2013.

(Inherited from Item)
InternetMessageHeaders

Gets a list of Internet headers for this item. To get the entire collection of Internet message headers, use the PR_TRANSPORT_MESSAGE_HEADERS property.

(Inherited from Item)
IsAssociated

Gets a value that indicates whether this is an associated item.

(Inherited from Item)
IsAttachment

Gets a value that indicates whether the item is an attachment.

(Inherited from Item)
IsDirty

Gets a value that indicates whether the object has been modified.

(Inherited from ServiceObject)
IsDraft

Gets a value that indicates whether the item is a draft. An item is a draft when it has not yet been sent.

(Inherited from Item)
IsFromMe

Gets a value that indicates whether the item has been sent by the current authenticated user.

(Inherited from Item)
IsNew

Gets a value that indicates whether this object is a real store item or a local object that has yet to be saved.

(Inherited from Item)
IsReminderSet

Gets or sets a value that indicates whether a reminder is set for this item.

(Inherited from Item)
IsResend

Gets a value that indicates whether the item is a resend of another item.

(Inherited from Item)
IsSubmitted

Gets a value that indicates whether the message has been submitted to be sent.

(Inherited from Item)
IsUnmodified

Gets a value that indicates whether the item has been modified since it was created.

(Inherited from Item)
Item[PropertyDefinitionBase]

Gets the value of the specified property in this instance.

(Inherited from ServiceObject)
ItemClass

Gets or sets the custom class name of this item.

(Inherited from Item)
JobTitle

Gets or sets the job title of the contact.

LastModifiedName

Gets the name of the user who last modified this item.

(Inherited from Item)
LastModifiedTime

Gets the date and time that this item was last modified.

(Inherited from Item)
Manager

Gets or sets the name of the contact's manager.

ManagerMailbox

Gets the email address of contact's direct manager. This property was introduced in Exchange Server 2010 SP2 and the Exchange Web Services (EWS) Managed API 1.2.

MiddleName

Gets or sets the middle name of the contact.

Mileage

Gets or sets the mileage for the contact.

MimeContent

Gets the MIME content of this item.

(Inherited from Item)
MSExchangeCertificate

Gets a binary array encoding the contact’s Microsoft Exchange certificate. This property was introduced in Exchange Server 2010 SP2 and the Exchange Web Services (EWS) Managed API 1.2.

NickName

Gets or sets the nickname of the contact.

NormalizedBody

Gets the message body of an item that has been converted to a normalized value. The NormalizedBody property is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2013.

(Inherited from Item)
Notes

Gets the notes property of a contact. This property was introduced in Exchange Server 2010 SP2 and the Exchange Web Services (EWS) Managed API 1.2.

OfficeLocation

Gets or sets the location of the contact's office.

ParentFolderId

Gets the ID of the parent folder of this item.

(Inherited from Item)
PhoneNumbers

Gets an indexed list of telephone numbers for the contact.

PhoneticFirstName

Gets a contact’s first name using the phonetic alphabet. This property was introduced in Exchange Server 2010 SP2 and the Exchange Web Services (EWS) Managed API 1.2.

PhoneticFullName

Gets a contact’s full name, including first and last, using the phonetic alphabet. This property was introduced in Exchange Server 2010 SP2 and the Exchange Web Services (EWS) Managed API 1.2.

PhoneticLastName

Gets a contact’s last name using the phonetic alphabet. This property was introduced in Exchange Server 2010 SP2 and the Exchange Web Services (EWS) Managed API 1.2.

PhysicalAddresses

Gets an indexed list of physical addresses for the contact.

PolicyTag

Gets or sets the retention policy value. The PolicyTag property is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2013.

(Inherited from Item)
PostalAddressIndex

Gets or sets the index of the contact's postal address. When set, PostalAddressIndex refers to an entry in the PhysicalAddresses property indexed list.

Preview

Gets the item preview. The Preview property is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2013.

(Inherited from Item)
Profession

Gets or sets the profession of the contact.

ReminderDueBy

Gets or sets the date and time when the reminder is due for this item.

(Inherited from Item)
ReminderMinutesBeforeStart

Gets or sets the number of minutes before the start of this item that the reminder should be triggered.

(Inherited from Item)
RetentionDate

Gets the date until which an item must be preserved. The RetentionDate property is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2013.

(Inherited from Item)
Schema

Gets the schema that is associated with this type of object.

(Inherited from ServiceObject)
Sensitivity

Gets the sensitivity of this item.

(Inherited from Item)
Service

Gets the Exchange service for this object.

(Inherited from ServiceObject)
Size

Gets the size of this item.

(Inherited from Item)
SpouseName

Gets or sets the name of the contact's spouse/partner.

StoreEntryId

Gets the entry ID of the store that hosts the item. The StoreEntryId property is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2013.

(Inherited from Item)
Subject

Gets or sets the subject of this item.

(Inherited from Item)
Surname

Gets or sets the surname of the contact.

TextBody

Gets the text body of the item. The TextBody property is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2013.

(Inherited from Item)
UniqueBody

Gets the body part that is unique to the conversation that this item is part of.

(Inherited from Item)
UserSMIMECertificate

Gets a binary array encoding the contact’s SMIME certificate. This property was introduced in Exchange Server 2010 SP2 and the Exchange Web Services (EWS) Managed API 1.2.

WebClientEditFormQueryString

Gets the query string that can be appended to the Outlook Web App URL to open this item in a web browser.

(Inherited from Item)
WebClientReadFormQueryString

Gets the query string that should be appended to the Exchange web client URL to open this item by using the appropriate read form in a web browser.

(Inherited from Item)
WeddingAnniversary

Gets or sets the date of the contact's wedding anniversary.

Methods

Bind(ExchangeService, ItemId)

Binds to an existing contact and loads its first class properties. Calling this method results in a call to Exchange Web Services (EWS).

Bind(ExchangeService, ItemId, PropertySet)

Binds to an existing contact and loads the specified set of properties. Calling this method results in a call to Exchange Web Services (EWS).

Copy(FolderId)

Creates a copy of this item in the specified folder. Calling this method results in a call to Exchange Web Services (EWS).

(Inherited from Item)
Copy(WellKnownFolderName)

Creates a copy of this item in the specified folder. Calling this method results in a call to Exchange Web Services (EWS).

(Inherited from Item)
Delete(DeleteMode)

Deletes the item. Calling this method results in a call to Exchange Web Services (EWS).

(Inherited from Item)
Delete(DeleteMode, Boolean)

Deletes the item. Calling this method results in a call to EWS.

(Inherited from Item)
GetContactPictureAttachment()

Returns the file attachment that contains the contact's picture.

GetLoadedPropertyDefinitions()

Provides the collection of loaded property definitions.

(Inherited from ServiceObject)
Load()

Loads the first-class properties.

(Inherited from ServiceObject)
Load(PropertySet)

Loads the specified set of properties.

(Inherited from ServiceObject)
Move(FolderId)

Moves this item to the specified folder. Calling this method results in a call to Exchange Web Services (EWS).

(Inherited from Item)
Move(WellKnownFolderName)

Moves this item to the specified folder. Calling this method results in a call to Exchange Web Services (EWS).

(Inherited from Item)
RemoveContactPicture()

Removes the contact's picture.

RemoveExtendedProperty(ExtendedPropertyDefinition)

Removes an extended property.

(Inherited from Item)
Save()

Saves this item in the default folder based on the item's type. Calling this method results in at least one call to Exchange Web Services (EWS). Multiple calls to EWS might be made if attachments have been added.

(Inherited from Item)
Save(FolderId)

Saves this item in a specific folder. Calling this method results in at least one call to Exchange Web Services (EWS). Multiple calls to EWS might be made if attachments have been added.

(Inherited from Item)
Save(WellKnownFolderName)

Saves this item in a specific folder. Calling this method results in at least one call to Exchange Web Services (EWS). Multiple calls to EWS might be made if attachments have been added.

(Inherited from Item)
SetContactPicture(Byte[])

Sets the contact's picture by using the specified byte array.

SetContactPicture(Stream)

Sets the contact's picture by using the specified stream.

SetContactPicture(String)

Sets the contact's picture by using the specified file.

SetExtendedProperty(ExtendedPropertyDefinition, Object)

Sets the specified extended property to the specified value.

(Inherited from Item)
TryGetProperty(PropertyDefinitionBase, Object)

Tries to get the value of a specified property.

(Inherited from ServiceObject)
TryGetProperty<T>(PropertyDefinitionBase, T)

Tries to get the value of a specified property.

(Inherited from ServiceObject)
Update(ConflictResolutionMode)

Applies the local changes that have been made to this item. Calling this method results in at least one call to Exchange Web Services (EWS). Multiple calls to EWS might be made if attachments have been added or removed.

(Inherited from Item)
Update(ConflictResolutionMode, Boolean)

Applies the local changes that have been made to this item. Calling this method results in at least one call to EWS. Mutliple calls to EWS might be made if attachments have been added or removed.

(Inherited from Item)

Applies to