Table of Contents

Interface ICurrentContactProvider

Namespace
CMS.ContactManagement
Assembly
CMS.ContactManagement.dll

Service for recognizing and storing information about a contact currently browsing the live site.

public interface ICurrentContactProvider
Extension Methods

Methods

GetCurrentContact()

Recognizes a contact currently browsing the live site. If the contact cannot be recognized a new one is created. A returned contact is always valid (exists in database, is not merged, etc.).

ContactInfo GetCurrentContact()

Returns

ContactInfo

The recognized contact or a new contact, if it was not possible to recognize the contact.

Exceptions

InvalidOperationException

Processing of contacts cannot continue. This can be due to the insufficient license, disabled online marketing or incorrect request state.

GetExistingContact()

Gets a contact assigned to the visitor currently browsing the live site (contact can only be recognized during web request). A returned contact is always valid (exists in database, is not merged, etc.). If no contact is currently assigned to the visitor null is returned.

ContactInfo GetExistingContact()

Returns

ContactInfo

The recognized contact or null when there is no contact assigned to current live site visitor

Exceptions

InvalidOperationException

Processing of contacts cannot continue. This can be due to the insufficient license, disabled online marketing or incorrect request state.

SetCurrentContact(ContactInfo)

Stores information about the current contact into the persistent storage (IContactPersistentStorage), so that the next time (possibly in another request in the same session) GetCurrentContact() is called, the stored contact is returned.

void SetCurrentContact(ContactInfo contact)

Parameters

contact ContactInfo

The contact who performed the request

Exceptions

InvalidOperationException

Processing of contacts cannot continue. This can be due to the insufficient license, disabled online marketing or incorrect request state.