Contact Contact 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) Contact(ExchangeService) Contact(ExchangeService)

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

Properties

Alias Alias 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 AllowedResponseActions 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 ArchiveTag 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 AssistantName AssistantName

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

Attachments Attachments Attachments

Gets a list of the attachments to this item.

(Inherited from Item)
Birthday Birthday Birthday

Gets or sets the birthday of the contact.

Body Body Body

Gets or sets the body of this item.

(Inherited from Item)
BusinessHomePage BusinessHomePage BusinessHomePage

Gets or sets the business home page of the contact.

Categories Categories Categories

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

(Inherited from Item)
Children Children Children

Gets or sets a list of children for the contact.

Companies Companies Companies

Gets or sets a list of companies for the contact.

CompanyName CompanyName CompanyName

Gets or sets the company name of the contact.

CompleteName CompleteName CompleteName

Gets or sets the complete name of the contact.

ContactSource ContactSource ContactSource

Gets the source of the contact.

ConversationId ConversationId ConversationId

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

(Inherited from Item)
Culture Culture Culture

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

(Inherited from Item)
DateTimeCreated DateTimeCreated DateTimeCreated

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

(Inherited from Item)
DateTimeReceived DateTimeReceived DateTimeReceived

Gets the time when this item was received.

(Inherited from Item)
DateTimeSent DateTimeSent DateTimeSent

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

(Inherited from Item)
Department Department Department

Gets or sets the department of the contact.

DirectoryId DirectoryId 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 DirectoryPhoto 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 DirectReports 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 DisplayCc DisplayCc

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

(Inherited from Item)
DisplayName DisplayName DisplayName

Gets or sets the display name of the contact.

DisplayTo DisplayTo DisplayTo

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

(Inherited from Item)
EffectiveRights EffectiveRights EffectiveRights

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

(Inherited from Item)
EmailAddresses EmailAddresses EmailAddresses

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

EntityExtractionResult EntityExtractionResult 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 ExtendedProperties ExtendedProperties

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

(Inherited from Item)
FileAs FileAs 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 FileAsMapping FileAsMapping

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

Flag Flag 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 Generation Generation

Gets or sets the generation of the contact.

GivenName GivenName GivenName

Gets or sets the given name of the contact.

HasAttachments HasAttachments HasAttachments

Gets a value that indicates whether the item has attachments.

(Inherited from Item)
HasPicture HasPicture HasPicture

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

IconIndex IconIndex 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 Id Id

Gets the ID of this item.

(Inherited from Item)
ImAddresses ImAddresses ImAddresses

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

Importance Importance Importance

Gets or sets the importance of this item.

(Inherited from Item)
Initials Initials Initials

Gets or sets the initials of the contact.

InReplyTo InReplyTo InReplyTo

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

(Inherited from Item)
InstanceKey InstanceKey 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 InternetMessageHeaders 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 IsAssociated IsAssociated

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

(Inherited from Item)
IsAttachment IsAttachment IsAttachment

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

(Inherited from Item)
IsDirty IsDirty IsDirty

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

(Inherited from ServiceObject)
IsDraft IsDraft 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 IsFromMe IsFromMe

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

(Inherited from Item)
IsNew IsNew 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 IsReminderSet IsReminderSet

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

(Inherited from Item)
IsResend IsResend IsResend

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

(Inherited from Item)
IsSubmitted IsSubmitted IsSubmitted

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

(Inherited from Item)
IsUnmodified IsUnmodified IsUnmodified

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

(Inherited from Item)
ItemClass ItemClass ItemClass

Gets or sets the custom class name of this item.

(Inherited from Item)
Item[PropertyDefinitionBase] Item[PropertyDefinitionBase] Item[PropertyDefinitionBase]

Gets the value of the specified property in this instance.

(Inherited from ServiceObject)
JobTitle JobTitle JobTitle

Gets or sets the job title of the contact.

LastModifiedName LastModifiedName LastModifiedName

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

(Inherited from Item)
LastModifiedTime LastModifiedTime LastModifiedTime

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

(Inherited from Item)
Manager Manager Manager

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

ManagerMailbox ManagerMailbox 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 MiddleName MiddleName

Gets or sets the middle name of the contact.

Mileage Mileage Mileage

Gets or sets the mileage for the contact.

MimeContent MimeContent MimeContent

Gets the MIME content of this item.

(Inherited from Item)
MSExchangeCertificate MSExchangeCertificate 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 NickName NickName

Gets or sets the nickname of the contact.

NormalizedBody NormalizedBody 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 Notes 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 OfficeLocation OfficeLocation

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

ParentFolderId ParentFolderId ParentFolderId

Gets the ID of the parent folder of this item.

(Inherited from Item)
PhoneNumbers PhoneNumbers PhoneNumbers

Gets an indexed list of telephone numbers for the contact.

PhoneticFirstName PhoneticFirstName 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 PhoneticFullName 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 PhoneticLastName 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 PhysicalAddresses PhysicalAddresses

Gets an indexed list of physical addresses for the contact.

PolicyTag PolicyTag 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 PostalAddressIndex 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 Preview 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 Profession Profession

Gets or sets the profession of the contact.

ReminderDueBy ReminderDueBy ReminderDueBy

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

(Inherited from Item)
ReminderMinutesBeforeStart ReminderMinutesBeforeStart ReminderMinutesBeforeStart

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

(Inherited from Item)
RetentionDate RetentionDate 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 Schema Schema

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

(Inherited from ServiceObject)
Sensitivity Sensitivity Sensitivity

Gets the sensitivity of this item.

(Inherited from Item)
Service Service Service

Gets the Exchange service for this object.

(Inherited from ServiceObject)
Size Size Size

Gets the size of this item.

(Inherited from Item)
SpouseName SpouseName SpouseName

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

StoreEntryId StoreEntryId 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 Subject Subject

Gets or sets the subject of this item.

(Inherited from Item)
Surname Surname Surname

Gets or sets the surname of the contact.

TextBody TextBody 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 UniqueBody UniqueBody

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

(Inherited from Item)
UserSMIMECertificate UserSMIMECertificate 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 WebClientEditFormQueryString 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 WebClientReadFormQueryString 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 WeddingAnniversary WeddingAnniversary

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

Methods

Bind(ExchangeService, ItemId) Bind(ExchangeService, ItemId) 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) Bind(ExchangeService, ItemId, PropertySet) 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) Copy(FolderId) 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) Copy(WellKnownFolderName) 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) Delete(DeleteMode) Delete(DeleteMode)

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

(Inherited from Item)
Delete(DeleteMode, Boolean) Delete(DeleteMode, Boolean) Delete(DeleteMode, Boolean)

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

(Inherited from Item)
GetContactPictureAttachment() GetContactPictureAttachment() GetContactPictureAttachment()

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

GetLoadedPropertyDefinitions() GetLoadedPropertyDefinitions() GetLoadedPropertyDefinitions()

Provides the collection of loaded property definitions.

(Inherited from ServiceObject)
Load() Load() Load()

Loads the first-class properties.

(Inherited from ServiceObject)
Load(PropertySet) Load(PropertySet) Load(PropertySet)

Loads the specified set of properties.

(Inherited from ServiceObject)
Move(FolderId) Move(FolderId) 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) Move(WellKnownFolderName) 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() RemoveContactPicture() RemoveContactPicture()

Removes the contact's picture.

RemoveExtendedProperty(ExtendedPropertyDefinition) RemoveExtendedProperty(ExtendedPropertyDefinition) RemoveExtendedProperty(ExtendedPropertyDefinition)

Removes an extended property.

(Inherited from Item)
Save() Save() 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) Save(FolderId) 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) Save(WellKnownFolderName) 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[]) SetContactPicture(Byte[]) SetContactPicture(Byte[])

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

SetContactPicture(Stream) SetContactPicture(Stream) SetContactPicture(Stream)

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

SetContactPicture(String) SetContactPicture(String) SetContactPicture(String)

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

SetExtendedProperty(ExtendedPropertyDefinition, Object) SetExtendedProperty(ExtendedPropertyDefinition, Object) SetExtendedProperty(ExtendedPropertyDefinition, Object)

Sets the specified extended property to the specified value.

(Inherited from Item)
TryGetProperty(PropertyDefinitionBase, Object) TryGetProperty(PropertyDefinitionBase, Object) TryGetProperty(PropertyDefinitionBase, Object)

Tries to get the value of a specified property.

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

Tries to get the value of a specified property.

(Inherited from ServiceObject)
Update(ConflictResolutionMode) Update(ConflictResolutionMode) 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) Update(ConflictResolutionMode, Boolean) 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