CStorage Class

Provide an interface to handle large Email Messages and attachments

Inheritance Hierarchy

Object
CStorage

Namespace: VO
Assembly: VOInternetClasses (in VOInternetClasses.dll) Version: 2.21

Syntax

Copy

 CLASS CStorage

public class CStorage

Request Example View Source

The CStorage type exposes the following members.

Constructors

	Name	Description
	CStorage	Enter topic text here.

Top

Properties

	Name	Description
	AttachmentSize	Returns the file size of a currently stored or an opened attachment file. This access is called during receiving an email.
	NoSave	You can use this assign to suppress the storing of the attachments into the storage. This makes sense, if you want to store only raw email files.

Top

Methods

	Name	Description
	AttachmentAdd	This method is called when an email is received to initialize the saving of a new attachment. The implementation in CStorage generates a unique ID and creates the (empty) file.
	AttachmentClose	This method is called after receiving of an attachment or after reading of an attachment from the storage during sending. The implementation in CStorage closes an open file.
	AttachmentDelete	This method returns the full path of an attachment file addressed through cAttachID.
	AttachmentFullPath	This method returns the full path of an attachment file addressed through cAttachID.
	AttachmentOpen	This method is called during sending of an email, if an attachment have to be sent. It prepares the loading process from the storage. In our case it addresses the attachment file and opens it.
	AttachmentRead	This method is called during sending of an attachment. It reads a data block from the attachment file. In our implementation it reads 1536 bytes. The result string is the encoded value of this data block.
	AttachmentSave	Stores the attachment with the ID cAttachID to the file cToFile. cToFile must be a full path name. This method is called from CEMail:SaveAs().
	AttachmentWrite	This method is called multiple times per attachment during the receive process.
	CreateNewEMail	Missing documentation
	LoadEMail	This method returns a CEMail object filled with all data addressed through the cID. You have to implement this method and the meaning of cID. THIS METHOD IS NOT IMPLEMENTED IN CSTORAGE AND NOT CALLED BY THE INTERNET CLASSES
	RawClose	This method is called when an email was received completely.
	RawNew	This method is called at the beginning before any data is received. You have to implement how you want to store and address the raw data here.
	RawWrite	Now this method is called multiple times until the complete email including all attachments is received. You have to implement how you want to store each data block.
	SaveAttachments	This method stores all attachments of an email into the storage.
	SaveEMail	This method stores a CEMail object including all data under the address of the cID. You have to implement this method and the meaning of cID. THIS METHOD IS NOT IMPLEMENTED IN CSTORAGE AND NOT CALLED BY THE INTERNET CLASSES

Top

Remarks

This class is used Exclusively by the CEMail Class to read and write attachments. The class reads/writes attachments in a disk folder. If you want to store attachments on another location (for example a SQL Database) then you should subclass this class and override the implementation of the methods. CStorage also gives you an interface to store the raw data of received emails. During reception of an email the following three methods are called: RawNew() RawWrite() RawClose() You can use these methods to implement your own mechanism to save the raw email contents. This class provides an interface that is used to handle streaming of inbound and outbound messages

Reference

VO Namespace