Click or drag to resize

Contact Class

Represents an immutable contact object which exposes all possible contact details. The contact object can also be used to subscribe for presence updates.
Inheritance Hierarchy
SystemObject
  Avaya.ClientServicesBaseContact
    Avaya.ClientServicesContact

Namespace:  Avaya.ClientServices
Assembly:  AvayaClientServices (in AvayaClientServices.dll) Version: 550.0.60.0
Syntax
C#
public class Contact : BaseContact

The Contact type exposes the following members.

Properties
  NameDescription
Public propertyAddToGroupCapability
Capability indicating whether this contact can be added to a group.
Public propertyAlias
The native alias.
Public propertyAsciiAlias
The non-localized alias.
Public propertyAsciiDisplayName
The non-localized display name.
Public propertyAsciiFirstName
The non-localized first name.
Public propertyAsciiLastName
The non-localized last name.
Public propertyAsciiMiddleName
The non-localized middle name.
Public propertyCanAddIMAddress
True if addition of IM address will not make contact invalid.
Public propertyCity
The city.
Public propertyCompany
The company.
Public propertyContactSources
The contact sources
Public propertyCountry
The country.
Public propertyCustom1
The list of custom1 values.
Public propertyCustom2
The list of custom2 values.
Public propertyCustom3
The list of custom3 values.
Public propertyDeleteContactCapability
Capability indicating whether this contact can be deleted. See also ContactService.DeleteContact() method.
Public propertyDepartment
The department.
Public propertyDisplayName
The native display name.
Public propertyEmailAddresses
The list of email addresses.
Public propertyExtendedContactDetailsAvailable
True if extended contact details are available.
Public propertyExtraFields
The list extra fields used for local contacts.
Public propertyFirstName
The native first name.
Public propertyHasPicture
Indicating whether contact has a picture.
Public propertyIMAddresses
The list of IM addresses.
Public propertyIsBuddy
The buddy flag. Used for presence feature purpose.
Public propertyIsFavorite
The favorite flag.
Public propertyIsVip
The VIP flag.
Public propertyLanguage
The language is per contact record.
Public propertyLastName
The native last name.
Public propertyLocation
The location.
Public propertyManager
The name of a person who is a supervisor.
Public propertyMiddleName
The native middle name.
Public propertyNotes
The notes field.
Public propertyPhoneNumbers
The list of phone numbers.
Public propertyPictureData
The contact picture bytes. Picture data can be in jpeg or png format.
Public propertyPostalCode
The postal code.
Public propertyPresence
Public propertyRank
The rank field with non-negative double value defining contact sorting order. 0.0 value means "No rank".
Public propertyState
The state.
Public propertyStreetAddress
The street address.
Public propertyTitle
The title or company role.
Public propertyUniqueAddressForMatching
The matching/merging address. That parameter can be used as record unique id.
Public propertyUpdateContactCapability
Capability indicating whether this contact can be updated. See also ContactService.UpdateContact() method.
Public propertyVideoCapable
True if contact is video capable.
Top
Methods
  NameDescription
Public methodCanAddEmailAddressOfType
True if addition of email address of a specified type will not make contact invalid.
Public methodCanAddPhoneNumberOfType
True if addition of phone number of a specified type will not make contact invalid.
Protected methodGetAlias (Overrides BaseContactGetAlias.)
Protected methodGetAsciiAlias (Overrides BaseContactGetAsciiAlias.)
Protected methodGetAsciiDisplayName (Overrides BaseContactGetAsciiDisplayName.)
Protected methodGetAsciiFirstName (Overrides BaseContactGetAsciiFirstName.)
Protected methodGetAsciiLastName (Overrides BaseContactGetAsciiLastName.)
Protected methodGetAsciiMiddleName (Overrides BaseContactGetAsciiMiddleName.)
Protected methodGetCity (Overrides BaseContactGetCity.)
Protected methodGetCompany (Overrides BaseContactGetCompany.)
Protected methodGetCountry (Overrides BaseContactGetCountry.)
Protected methodGetCustom1 (Overrides BaseContactGetCustom1.)
Protected methodGetCustom2 (Overrides BaseContactGetCustom2.)
Protected methodGetCustom3 (Overrides BaseContactGetCustom3.)
Protected methodGetDepartment (Overrides BaseContactGetDepartment.)
Protected methodGetDisplayName (Overrides BaseContactGetDisplayName.)
Protected methodGetEmailAddresses (Overrides BaseContactGetEmailAddresses.)
Protected methodGetExtraFields (Overrides BaseContactGetExtraFields.)
Protected methodGetFirstName (Overrides BaseContactGetFirstName.)
Protected methodGetIMAddresses (Overrides BaseContactGetIMAddresses.)
Protected methodGetIsBuddy (Overrides BaseContactGetIsBuddy.)
Protected methodGetIsFavorite (Overrides BaseContactGetIsFavorite.)
Protected methodGetIsVideoCapable (Overrides BaseContactGetIsVideoCapable.)
Protected methodGetIsVip (Overrides BaseContactGetIsVip.)
Protected methodGetLanguage (Overrides BaseContactGetLanguage.)
Protected methodGetLastName (Overrides BaseContactGetLastName.)
Protected methodGetLocation (Overrides BaseContactGetLocation.)
Protected methodGetManager (Overrides BaseContactGetManager.)
Protected methodGetMiddleName (Overrides BaseContactGetMiddleName.)
Protected methodGetNotes (Overrides BaseContactGetNotes.)
Protected methodGetPhoneNumbers (Overrides BaseContactGetPhoneNumbers.)
Protected methodGetPostalCode (Overrides BaseContactGetPostalCode.)
Protected methodGetRank (Overrides BaseContactGetRank.)
Protected methodGetState (Overrides BaseContactGetState.)
Protected methodGetStreetAddress (Overrides BaseContactGetStreetAddress.)
Protected methodGetTitle (Overrides BaseContactGetTitle.)
Protected methodGetUniqueAddressForMatching (Overrides BaseContactGetUniqueAddressForMatching.)
Public methodRemovePictureFromCache
Removes contact's picture from cache. This method helps to manage the application memory. When the contact picture is not needed, it can be removed and downloaded again in the future.
Public methodRetrievePicture
Retrieves the picture for contact. Check if picture is available using HasPicture flag.
Public methodStartPresence
Begin monitoring presence for this contact. The Presence property will start being updated after this method is invoked. See also method StopPresence.
Public methodStopPresence
Stop monitoring presence for this contact. The Presence property will be reset and will not update after this method is called.
Top
Events
  NameDescription
Public eventContactChanged
Occurs when some field of the contact changes, either through local or remote actions.
Public eventPresenceChanged
Occurs when the contact's presence information changes. Note, that StartPresence must be invoked in order to trigger receiving presence updates. When the last listener is removed, StopPresence is automatically invoked which stops receiving presence updates for the contact.
Top
Remarks

See also EditableContact class.

Contacts can be retrieved by using ContactService methods ContactService.GetContacts(ContactRetrievalWatcher ^,ContactSourceType) or ContactService.SearchContacts(SearchContactsWatcher ^,System::String ^,SearchScopeType,SearchSourceType,uint32_t,uint32_t). Both methods are returning data retrievals which are notifying about operation status and new record coming in.

This object can not be used to edit the contact record. In order to update contact use method ContactService.CreateEditableContact and then operate on EditableContact object which should be passed to ContactService.UpdateContact method.

See Also