MailSubscriptionHandler Class Content Studio 5.7 SDK
Content Studio Web Content Management System

[This is preliminary documentation and is subject to change.]

Adds base functionality to a Subscription event handler that implements mail sending functionality.
Inheritance Hierarchy


Namespace: ContentStudio.Document.Subscription.EventHandler
Assembly: CSSubscriptionEventHandler (in CSSubscriptionEventHandler.dll) Version: (

public abstract class MailSubscriptionHandler : SubscriptionEventHandlerBase

The MailSubscriptionHandler type exposes the following members.


Protected methodMailSubscriptionHandler
Initializes a new instance of the MailSubscriptionHandler class.

Protected propertyConnectionId (Inherited from SubscriptionEventHandlerBase.)
Protected propertyContent Obsolete. (Inherited from SubscriptionEventHandlerBase.)
Protected propertyCredentials
Gets the credentials to use when communicating with the message server. The data was passed in the content argument of the EventHandler(Int32, Int32, String, String, ICSCredentialsContainer, Int32, String) method inc combination with the xml passed in.
(Inherited from SubscriptionEventHandlerBase.)
Protected propertyEventId (Inherited from SubscriptionEventHandlerBase.)
Protected propertyExtendedProperties
Gets or a collections of extended properties that was sent to the event handler.
(Inherited from SubscriptionEventHandlerBase.)
Public propertyFailedCount
Gets or sets the number of subscribers to whom a message was not sent for some reason.
(Inherited from SubscriptionEventHandlerBase.)
Protected propertyFailureRetryInterval
Gets the interval that the handler should wait before it tries to resend a failed message.
Protected propertyLogger
Gets or sets the logger object that is used when logging to a syslog.
(Inherited from SubscriptionEventHandlerBase.)
Protected propertyMaxNumberOfAllowedFailedRecipients
Gets or sets the max number of allowed failed recipients allowed before the event handler reports an error and stops.
Public propertyMessage
Gets the mail message to be sent out to a subscriber.
Protected propertyMessageDocumentUrl
Gets URL to the Content Studio document to send to subscribers.
Protected propertyNumberOfFailedRecipients
Gets the number of failed recipients during the mail sending operation.
Protected propertyOriginalBody
Gets the original body.
Protected propertyOriginalHtmlBody
Gets the original message body generated from the Content Studio message source document.
Protected propertyProperties
Gets the regular properties that was passed in to the event handler.
(Inherited from SubscriptionEventHandlerBase.)
Protected propertyRecipientFailRetryLimit
Gets the maximum number of times that the event handler should try to resend a message to a client when there is a non-fatal, temporary error.
Public propertySendCount
Gets or gets the number of sent messages.
(Inherited from SubscriptionEventHandlerBase.)
Protected propertySessionId
Gets the numeric value of the session used by the Service Manager when it communicates with Content Studio.
(Inherited from SubscriptionEventHandlerBase.)
Protected propertySmptClient
Gets a SMPT client to use when sending mail messages.
Protected propertySmtpFailureLimit
Gets the number of SMTP failures that is accepted before the handler stops and reports an error.
Public propertyStatusText
Gets the status text that is sent back to the Service Manager after that the event handler has finished. For success this value can be "OK" or "Success". The status can also be an informative message that should be logged in the Content Studio event log.
(Inherited from SubscriptionEventHandlerBase.)
Public propertySubscribers
Gets or gets the number of found subscribers.
(Inherited from SubscriptionEventHandlerBase.)
Protected propertySubscriptionTypeHandled
Gets or sets the subscription type handled.
(Inherited from SubscriptionEventHandlerBase.)
Protected propertyTimeOut (Inherited from SubscriptionEventHandlerBase.)

Protected methodCreateLogger
Creates the logger object that logs events to its implementation of the ISysLogWriter interface.
(Inherited from SubscriptionEventHandlerBase.)
Protected methodCreateMessage
When implemented in derived class creates a message to be sent out to subscribers. This method gets called once from the event handler.
(Overrides SubscriptionEventHandlerBaseCreateMessage.)
Public methodDispose
Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
(Inherited from SubscriptionEventHandlerBase.)
Protected methodDispose(Boolean)
Releases unmanaged and - optionally - managed resources
(Overrides SubscriptionEventHandlerBaseDispose(Boolean).)
Public methodEquals (Inherited from Object.)
Public methodEventHandler
Defines an asyncronous Content Studio event handler. This method gets called by Content Studio Service Manager when it needs to handle a subscription related event.
(Inherited from SubscriptionEventHandlerBase.)
Protected methodFinalize
Releases unmanaged resources and performs other cleanup operations before the SubscriptionEventHandlerBase is reclaimed by garbage collection.
(Inherited from SubscriptionEventHandlerBase.)
Public methodGetHashCode (Inherited from Object.)
Public methodGetType (Inherited from Object.)
Protected methodMemberwiseClone (Inherited from Object.)
Protected methodReadData
Gets a list of subscribers that should receive messages.
(Inherited from SubscriptionEventHandlerBase.)
Protected methodCode exampleSendMessage
Sends the message to the specified subscriber.
(Overrides SubscriptionEventHandlerBaseSendMessage(SubscriptionInformation).)
Protected methodSetMailMessageContent
Sets a new Html body an text body of a message.
Protected methodSetStatus
Sets the status text that is sent back to the Service Manager after that the event handler has finished.
(Inherited from SubscriptionEventHandlerBase.)
Public methodToString (Inherited from Object.)
Protected methodValidateEvent
When implemented in derived classes, checks if the the event passed in is valid for this implementation.
(Overrides SubscriptionEventHandlerBaseValidateEvent(Int32).)
Protected methodCode exampleValidateMessage
Validates a message before it is sent to a single subscriber.
(Overrides SubscriptionEventHandlerBaseValidateMessage(SubscriptionInformation).)
Protected methodValidateSubscriber
Validates the subscriber to see if he/she should receive the message.
(Overrides SubscriptionEventHandlerBaseValidateSubscriber(SubscriptionInformation).)
Public methodCode exampleWriteToLog
Writes a message to the logger provided that a logger exists.
(Inherited from SubscriptionEventHandlerBase.)

Protected eventFinished
Occurs when the event handler has done its job.
(Inherited from SubscriptionEventHandlerBase.)
Protected eventInitialized
Occurs when the event handler has parsed and read all of the passed in even handler arguments but before the actual job has started. A developer can subscribe to this event to do private initialization specific to the current implementation.
(Inherited from SubscriptionEventHandlerBase.)
See Also