Contacts
List of examples:
Contacts
Creating a contact
// Creates a new contact object
ContactInfo newContact = new ContactInfo()
{
ContactLastName = "Smith",
ContactFirstName = "John",
// Enables activity tracking for the new contact
ContactMonitored = true
};
// Saves the contact to the database
ContactInfoProvider.SetContactInfo(newContact);
Updating a contact
// Gets the first contact whose last name is 'Smith'
ContactInfo updateContact = ContactInfoProvider.GetContacts()
.WhereEquals("ContactLastName", "Smith")
.FirstObject;
if (updateContact != null)
{
// Updates the contact's properties
updateContact.ContactCompanyName = "Company Inc.";
// Saves the updated contact to the database
ContactInfoProvider.SetContactInfo(updateContact);
}
Updating multiple contacts
// Gets all contacts whose last name is 'Smith'
var contacts = ContactInfoProvider.GetContacts().WhereEquals("ContactLastName", "Smith");
// Loops through individual contacts
foreach (ContactInfo contact in contacts)
{
// Updates the properties of the contact
contact.ContactCompanyName = "Company Inc.";
// Saves the updated contact to the database
ContactInfoProvider.SetContactInfo(contact);
}
Linking contacts with user accounts
// Gets the first contact whose last name is 'Smith'
ContactInfo contact = ContactInfoProvider.GetContacts()
.WhereEquals("ContactLastName", "Smith")
.FirstObject;
if (contact != null)
{
// Links the contact with the current user
Service.Entry<IContactRelationAssigner>().Assign(
MembershipContext.AuthenticatedUser.UserID,
MemberTypeEnum.CmsUser,
contact.ContactID,
false);
}
Removing user accounts from contacts
// Gets the first contact whose last name is 'Smith'
ContactInfo contact = ContactInfoProvider.GetContacts()
.WhereEquals("ContactLastName", "Smith")
.FirstObject;
if (contact != null)
{
// Gets the relationship between the contact and the current user
ContactMembershipInfo contactMembership = ContactMembershipInfoProvider.GetMembershipInfo(
contact.ContactID,
MembershipContext.AuthenticatedUser.UserID,
MemberTypeEnum.CmsUser);
// Deletes the contact-user relationship
ContactMembershipInfoProvider.DeleteMembershipInfo(contactMembership.MembershipID);
}
Deleting a contact
// Gets the first contact whose last name is 'Smith'
ContactInfo deleteContact = ContactInfoProvider.GetContacts()
.WhereEquals("ContactLastName", "Smith")
.FirstObject;
if (deleteContact != null)
{
// Deletes the contact
ContactInfoProvider.DeleteContactInfo(deleteContact);
}
Contact statuses
Creating a contact status
// Creates a new contact status object
ContactStatusInfo newStatus = new ContactStatusInfo()
{
ContactStatusDisplayName = "New contact status",
ContactStatusName = "NewContactStatus"
};
// Saves the contact status to the database
ContactStatusInfoProvider.SetContactStatusInfo(newStatus);
Updating a contact status
// Gets the contact status
ContactStatusInfo updateStatus = ContactStatusInfoProvider.GetContactStatusInfo("NewContactStatus");
if (updateStatus != null)
{
// Updates the contact status properties
updateStatus.ContactStatusDisplayName = updateStatus.ContactStatusDisplayName.ToLowerCSafe();
// Saves the modified contact status to the database
ContactStatusInfoProvider.SetContactStatusInfo(updateStatus);
}
Updating multiple contact statuses
// Gets all contact statuses whose code name starts with 'New'
var statuses = ContactStatusInfoProvider.GetContactStatuses()
.WhereStartsWith("ContactStatusName","New");
// Loops through individual contact statuses
foreach (ContactStatusInfo contactStatus in statuses)
{
// Updates the contact status properties
contactStatus.ContactStatusDisplayName = contactStatus.ContactStatusDisplayName.ToUpper();
// Saves the modified contact status to the database
ContactStatusInfoProvider.SetContactStatusInfo(contactStatus);
}
Assigning a status to a contact
// Gets the first contact whose last name is 'Smith'
ContactInfo contact = ContactInfoProvider.GetContacts()
.WhereEquals("ContactLastName", "Smith")
.FirstObject;
// Gets the contact status
ContactStatusInfo contactStatus = ContactStatusInfoProvider.GetContactStatusInfo("NewContactStatus");
if ((contact != null) && (contactStatus != null))
{
// Checks that the contact doesn't already have the given status
if (contact.ContactStatusID != contactStatus.ContactStatusID)
{
// Assigns the status to the contact
contact.ContactStatusID = contactStatus.ContactStatusID;
// Saves the updated contact to the database
ContactInfoProvider.SetContactInfo(contact);
}
}
Removing statuses from contacts
// Gets the contact status
ContactStatusInfo contactStatus = ContactStatusInfoProvider.GetContactStatusInfo("NewContactStatus");
if (contactStatus != null)
{
// Gets all contacts that have the specified status
var contacts = ContactInfoProvider.GetContacts()
.WhereEquals("ContactStatusID", contactStatus.ContactStatusID);
// Loops through the contacts
foreach (ContactInfo contact in contacts)
{
// Sets the status to 'None' for each contact
contact.ContactStatusID = 0;
// Saves the updated contact to the database
ContactInfoProvider.SetContactInfo(contact);
}
}
Deleting a contact status
// Gets the contact status
ContactStatusInfo deleteStatus = ContactStatusInfoProvider.GetContactStatusInfo("NewContactStatus");
if (deleteStatus != null)
{
// Deletes the contact status
ContactStatusInfoProvider.DeleteContactStatusInfo(deleteStatus);
}