CNContactMBS.areKeysAvailable(keyDescriptors() as CNKeyDescriptorMBS) as Boolean

The isKeyAvailable or areKeysAvailable methods are used where you are not certain of the keys that when fetched. If this method returns false, refetch the contact using the contact identifier and the keys you want to fetch. Accessing a property that was not fetched will throw an CNContactPropertyNotFetchedExceptionName exception.

CNContactMBS.Constructor   Private

CNContactMBS.contactRelations as CNLabeledValueMBS()

This property is an array of CNLabeledValue objects, each of which has a label and a CNContactRelation value. This property was previously known as related names.

CNContactMBS.copy as CNContactMBS

CNContactMBS.dates as CNLabeledValueMBS()

This property is an array of CNLabeledValue objects, each of which has an NSString label and NSDateComponents value. You can use this property to store Gregorian dates such as anniversaries. Day and month components are required and year is optional. The calendar component can be nil or NSCalendarIdentifierGregorian. All other date components are invalid and including them results in an NSError object that includes the key paths of the invalid components and the error code CNErrorCodeValidationConfigurationError.

CNContactMBS.emailAddresses as CNLabeledValueMBS()

This property is an array of CNLabeledValue objects, each of which has a label and an NSString that contains the email address.

CNContactMBS.instantMessageAddresses as CNLabeledValueMBS()

This property is an array of CNLabeledValue objects, each of which has a label and a CNInstantMessageAddress value.

Some examples using this method:

• /Mac64bit/Contacts/Contacts Test

CNContactMBS.isKeyAvailable(key as String) as Boolean

The isKeyAvailable or areKeysAvailable methods are used when you are not certain of the keys that were fetched. If this method returns false, refetch the contact using the contact identifier and the keys you want to fetch. Accessing a property that was not fetched will throw CNContactPropertyNotFetchedExceptionName.

Some examples using this method:

• /Mac64bit/Contacts/Contacts Display Person

CNContactMBS.isUnifiedWithContactWithIdentifier(contactIdentifier as String) as Boolean

CNContactMBS.mutableCopy as CNMutableContactMBS

CNContactMBS.phoneNumbers as CNLabeledValueMBS()

This property is an array of CNLabeledValue objects, each of which has a label and a CNPhoneNumber value.

Some examples using this method:

• /Mac64bit/Contacts/Contacts Test

CNContactMBS.postalAddresses as CNLabeledValueMBS()

Dim c As CNContactMBS // your contact

Dim postalAddresses() As CNLabeledValueMBS = c.postalAddresses
For Each postalAddresse As CNLabeledValueMBS In postalAddresses
  
  Dim p As CNPostalAddressMBS = postalAddresse.Value
  
  MsgBox p.Street + EndOfLine + p.PostalCode + " " + p.City
Next

This property is an array of CNLabeledValue objects, each of which has a label and a CNPostalAddress value.

Some examples using this method:

• /Mac64bit/Contacts/Contacts Test

CNContactMBS.socialProfiles as CNLabeledValueMBS()

This property is an array of CNLabeledValue objects, each of which has a label and a CNSocialProfile value.

Some examples using this method:

• /Mac64bit/Contacts/Contacts Test

CNContactMBS.urlAddresses as CNLabeledValueMBS()

This property is an array of CNLabeledValue objects, each of which has a label and an NSString value that contains the URL.

CNContactMBS.valueForKey(key as String) as Variant

// your contact
dim c as CNContactMBS

dim value as Variant = c.valueForKey(c.CNContactPreviousFamilyNameKey)
if value = nil then
  // empty
else
  MsgBox value.StringValue
end if

Normally you use the properties, but if you loop over a list of keys, you can use this function to query value for key.