dotmailer SDK: dotMailer.Sdk.AddressBook.DmAddressBook Class Reference

dotmailer SDK

dotmailer SDK
Tools to access and manage an account in the dotMailer system
dotMailer.Sdk.AddressBook.DmAddressBook Class Reference

Represents an address book in dotMailer More...

Inheritance diagram for dotMailer.Sdk.AddressBook.DmAddressBook:
dotMailer.Sdk.Interfaces.IDmAddressBook dotMailer.Sdk.Interfaces.IDmObject dotMailer.Sdk.Cache.IDmCacheableObject

Public Member Functions

DmContactCollection ContactsUnsubscribedSince (DateTime sinceDate)
 Returns a list of contacts that have unsubscribed from the address book since the specified date
 
DmContactCollection ContactsModifedSince (DateTime sinceDate)
 Returns a list of contacts that have been modified in the address book since the specified date
 
bool RemoveContact (string contactMail, bool preventResubscribe, bool totalUnsubscribe)
 Removes a contact from the address book
 
bool RemoveAllContacts (bool preventResubscribe, bool totalUnsubscribe)
 Removes all of the contacts in the address book
 

Properties

int Id [get, set]
 The system Id of the address book
 
int AccountId [get, set]
 Returns the dotMailer account Id for this address book
 
bool IsNew [get, set]
 Is this a newly crated address book
 
string Name [get, set]
 The name of the address book
 
string UserTag1 [get, set]
 User Tag
 
string UserTag2 [get, set]
 User Tag
 
string UserTag3 [get, set]
 User Tag
 
int NumberOfContacts [get]
 Gets the number of contacts that are held by the address book
 
DmCampaignCollection Campaigns [get]
 Gets the campaigns that have sent emails to this address book
 
DmContactCollection Contacts [get]
 Gets the collection of contacts
 
bool IsDirty [get]
 Returns true if the object has changed
 
string ObjectType [get, set]
 Returns the type name of the class Used by the serialisation process
 
string ExternalId [get]
 Gets/Sets the generated Id that uniquely identifies this record
 
- Properties inherited from dotMailer.Sdk.Interfaces.IDmAddressBook
int Id [get, set]
 The Id of the address book
 
string Name [get, set]
 The name of the address book
 
- Properties inherited from dotMailer.Sdk.Interfaces.IDmObject
int AccountId [get]
 The DotMailer account Id for this object
 
string ExternalId [get]
 A key that represents this object, used for synching with external applications
 
bool IsDirty [get]
 has the data of the object changed
 

Detailed Description

Represents an address book in dotMailer

Member Function Documentation

DmContactCollection dotMailer.Sdk.AddressBook.DmAddressBook.ContactsModifedSince ( DateTime  sinceDate)

Returns a list of contacts that have been modified in the address book since the specified date

Parameters
sinceDateDatTime to start listing from
Returns
DmContactCollection containing matching contacts
Exceptions
NullReferenceExceptionThrown if Address Book Id is invalid
DmContactCollection dotMailer.Sdk.AddressBook.DmAddressBook.ContactsUnsubscribedSince ( DateTime  sinceDate)

Returns a list of contacts that have unsubscribed from the address book since the specified date

Parameters
sinceDateDateTime to start listing from
Returns
DmContactCollection containing matching contacts
Exceptions
NullReferenceExceptionThrown if Address Book Id is invalid
bool dotMailer.Sdk.AddressBook.DmAddressBook.RemoveAllContacts ( bool  preventResubscribe,
bool  totalUnsubscribe 
)

Removes all of the contacts in the address book

Parameters
preventResubscribeif true, will prevent the contacts from re-subscribing to the address book
totalUnsubscribeif true, the contacts will be prevented from being added to any address book
Returns
true if all of the contacts were successfully removed
Exceptions
NullReferenceExceptionThrown if Address Book Id is invalid
bool dotMailer.Sdk.AddressBook.DmAddressBook.RemoveContact ( string  contactMail,
bool  preventResubscribe,
bool  totalUnsubscribe 
)

Removes a contact from the address book

Parameters
contactMailThe email address of the contact
preventResubscribeif true, will prevent the contact from re-subscribing to the address book
totalUnsubscribeif true, the contact will be prevented from being added to any address book
Returns
true if specified contact was removed
Exceptions
NullReferenceExceptionThrown if Address Book Id is invalid

Property Documentation

int dotMailer.Sdk.AddressBook.DmAddressBook.AccountId
getset

Returns the dotMailer account Id for this address book

DmCampaignCollection dotMailer.Sdk.AddressBook.DmAddressBook.Campaigns
get

Gets the campaigns that have sent emails to this address book

DmContactCollection dotMailer.Sdk.AddressBook.DmAddressBook.Contacts
get

Gets the collection of contacts

string dotMailer.Sdk.AddressBook.DmAddressBook.ExternalId
get

Gets/Sets the generated Id that uniquely identifies this record

int dotMailer.Sdk.AddressBook.DmAddressBook.Id
getset

The system Id of the address book

bool dotMailer.Sdk.AddressBook.DmAddressBook.IsDirty
get

Returns true if the object has changed

bool dotMailer.Sdk.AddressBook.DmAddressBook.IsNew
getset

Is this a newly crated address book

string dotMailer.Sdk.AddressBook.DmAddressBook.Name
getset

The name of the address book

int dotMailer.Sdk.AddressBook.DmAddressBook.NumberOfContacts
get

Gets the number of contacts that are held by the address book

string dotMailer.Sdk.AddressBook.DmAddressBook.ObjectType
getset

Returns the type name of the class Used by the serialisation process

string dotMailer.Sdk.AddressBook.DmAddressBook.UserTag1
getset

User Tag

string dotMailer.Sdk.AddressBook.DmAddressBook.UserTag2
getset

User Tag

string dotMailer.Sdk.AddressBook.DmAddressBook.UserTag3
getset

User Tag

Generated by   doxygen 1.8.3