Contact Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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, 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). |
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). |
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, Boolean) |
Deletes the item. Calling this method results in a call to EWS. (Inherited from Item) |
Delete(DeleteMode) |
Deletes the item. Calling this method results in a call to Exchange Web Services (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, 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) |
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) |