FreeSMTP.Net

Provides properties and methods for constructing an e-mail message.

To send an e-mail message defined by an instance of this class, use the SMTP class. SMTP Class

Initializes a new instance of the EMailMessage class.

Initializes a new instance of the EMailMessage class with the subject, recipient, sender, text and format of the message.

The subject of the message. The recipient's e-mail address. The sender's e-mail address. The body text of the message. One of the BodyPartFormat values specifying the format of the body part.

Clears all existing members and collections.

Gets or sets the character encoding of the e-mail message.

One of the values that indicates the encoding type of the e-mail message. Default: System.Text.Encoding.ASCII. This property should be set for messages composed with character sets other than US-ASCII. See the System.Text.Encoding class in the MSDN documentation for more information.

Gets the CustomHeaderCollection object.

A object.

Gets the BodyPartCollection object.

A object. The FreeSMTP.Net assembly supports a maximum of one plain text body part and one HTML body part. The retail version of Quiksoft's SMTP .Net assembly supports an unlimited number of body parts.

Gets or sets the subject of the e-mail message..

The subject line of the e-mail message.

Gets or sets the priority of the e-mail message..

The priority value. See remarks. Setting this property will cause an "X-Priority" header to be added to the message with the value specified. Different mail readers may interpret the X-Priority setting differently. Some may not interpret it at all. The popular readers interpret "4"=low, "3"=normal and "1"=high.

Gets the RecipientCollection object.

Gets the object.

Gets the object specifying the sender of the message.

An object. The value specified by this property is used with the SMTP "MAIL FROM" command during the SMTP conversation. This command indicates to the SMTP host, the e-mail address of the message sender. Most mail servers will accept mail from anyone, however some mail servers will only accept mail from some senders.

Represents the method that will handle the SMTPStatus event of the SMTP Object.

Total bytes sent for this message. Total size of this message in bytes.

Provides properties and methods for sending messages using the SMTP protocol.

The SMTP object will send messages to an SMTP server or queue them for delivery by SMTPExpress.

Private Member

Sends an e-mail message without needing to create an object instance of the SMTP class.

SMTP server name or address Recipient's e-mail address Sender's e-mail address Subject of the message The text of the message body One of the BodyPartFormat values specifying the format of the body part Thrown when file cannot be read. Thrown when there is an SMTP protocol error. Thrown when a connection error occurs. SMTP.QuickSend("mail.domain.com", "webmaster@localhost","jdoe@quiksoft.com", "My Subject", "Hello how are you?", BodyPartFormat.Plain);

Initializes a new instance of the SMTP class with the SMTP mail server name or address.

Name or address of the SMTP server

Clears all existing members and collections.

Initializes a new instance of the SMTP class.

The SubmitToExpress method queues an e-mail message for delivery by SMTPExpress.

A reference to the EMailMessage object to queue The path to the Easymail SMTPExpress directory on the computer where EasyMailSMTP Express is installed. Thrown when a file cannot be written to or read from.

Sends an e-mail message to an SMTP server.

A reference to the EMailMessage object to send Thrown when file cannot be read. Thrown when there is an SMTP protocol error. Thrown when a connection error occurs.

Adds or removes a SMTPStatus delegate that is called with progress data as an e-mail message is being sent.

Gets the SMTPServerCollection object.

The object

Get or sets the path and filename of log file to output all transactions with the server.

Path to log file must already exist. The file will be created if it does not already exist, otherwise it will be appended to.

Summary description for Collection.

Array that actually holds the collection objects

Position at which collection is refferencing

Returns the enumerator.

Object

Moves to next record

true on success false if no more records

Resets collection to first object

Return the last item in the collection

Address object

Returns current object

Get number of items in collection

Thrown when the cancel method is called.

Exception related to the Specific Protocol.

Internal Interface that should be ignored.

Quiksoft Socket Class.

Size of buffers to use.

Allows class to write to a log file.

Holds the network stream.

Clears out stream buffers.

Sets the timeout value of the socket.

Millisecond timeout value

Recieves one SMTP line of data from the socket.

Data recievd Max size to recieve 0 on success

Quiksoft Socket Class.

Summary description for Encoder.

Converts a unicode string to Base64. IT wraps the lines at 75 characters.

Data to encode Stream object to write to.

Converts a character to its quoted-printable equivilent

Character to convert return equal sign plus character code with 2 decimal digits.

Base 64 encodes a file and wraps at 75 characters. Sends output to io stream.

File Name to Send Stream Object

Function to allow word wrap

Strin to wrap Number of characters to wrap at. Force break at same character disregard for word.

Used to write a message to memory. Uses StringBuilder for better perofrmance

Type of IO objects currently supported.

Message Object, stores all message information.

Save message to file stream.

File Stream

Writes the body of the message to a stream.

Writes attachment to stream doing any necessary encoding.

Attachment to write Stream

Write encoded bodypart to a stream.

Part to write Stream

Sends the header to a socket or file

IO stream to send to

Returns the number of attachments a message has.

Used to save or send an address.

Address Object IO Control object Type of address to use

Collection of body parts.

Collection of senders. Normally only one is used.

Recipients, To, CC, and BCC's

Collection of ATtachment Objects.

Priority of message.

Custom headers, should end with a CRLF

Set the options that the SMTP Object should use when creating messages.

No options.

Do not add "From" header.

Do not add "Date" header.

Do not add "Message-ID" header.

Do not add "To" header.

When this option is specified along with ESMTP authentication, the authentication account name will not be appended to the end of the MAIL FROM command. This option is to be used for servers which reject the MAIL FROM command when the authentication account name is appended.

Add the BCC header to the message.

Type of Address

Standard To

Carbon copy.

Blind Carbon Copy

Address is a From address

Recipients collection object

Addresses collection. Holds multiple addresses

Add an address to the collection

Returns the last item in the collection that is of a certain type.

Type of address to return Address object

Add Address to collection

e-mail Address Friendly Name Type

Adds an address to the collection

e-mail Address Type

Sender or FROM collection Object

Adds an email address to the collection

e-mail Address

Adds and E-mail address to the collection

E-Mail Address Friendly Name

Address object. Used to store e-mail addresses.

Constructor that creates Address class.

Email Address User name Type of Address

Email Address member string

Email Name

Type of Address

Email Address Property

Email Friendly Name property

Type of address. property

Attachments collection stores attachment objects.

Adds attachment object to collection

Attachment Object

Attachment Class

Mime Part boject

Encoding type to use

MimePart Options

Custom headers to add to MIME part. Must end in CRLF.

Data of message or FileName.

Content Type of part

Length of part. Read only

Friendly Attachment Name

Attachment data or file name.

Body Parts collection. Contains all parts of the message.

Adds a body part to the collection

Body Part object

Adds a body part to the collection

Bodypart text.

Mime encoding used on Mime entity.

No encoding used

Use Base64

Use Quoted Printable

Body Part object

Charset used.

Exception related to the Specific Protocol.

Exception related to the socket connection.

Exception related to the file system.

Thrown when the cancel method is called.

Enumerator that shows the type of callback that was made.

Progress of message being sent

A recipient had been rejected

The message ID was created.

Callback function definition.

Flags that can be set for ESMTP DSN

Default, do not send command to server.

Send the command but do what ever the server default is.

Notify if message fails.

Notify if message is sent succefully.

Notify if message is delayed.

Do not notify me.

Flags that can be set when using DSN to requiest what the server should return on failure.

Do not send command

Return what ever the server default is.

Return only the header of the message.

Return the full message.

Flasg that can be set for each MIME part.

No Flags

Do not add content type header

Do not add content transfer encoding header

Do not add the disposition headers

Do not add the description header

Use generic content type application/octet-stream

Part of the message, html image etc..

DATA is a file name.

Parameters that should be sent to the send method.

DSN ID as used in returned messages.

Flags that say when we want to be notified.

Flags that say what we want returned.

Says if we want to use pipelining or not.

Call back of status data.

User data sent back to callback.

Sending Options

Set the type of ESMTP Authentication to use.

Do not use Authentication

Use AUTH Login

Use Cram MD5. Not yet implemented.

Flags to use when importing HTML using the ImportHTML method.

None

Crate an alternative text representation.

Summary description for SMTP.

Buffer size of strings

Options

Socket class

Set when AUTH Login was used to authenticate

Set when server support ESMTP and EHLO command was sent

Set when the server is able to use piplining.

Log file to write log to.

Log file stream.

Log file stream writer.

Writes a string to the log file.

Data to write to log file.

Connects to an SMTP server.

Server Name Port number to connect to. Default is 25. Domain name to send to HELO or EHLO command. Options that can be set. returns 0 on success or -1 on error.

Disconnect for mail server.

Closes resources

Disconnect from mail server

Send message to mail server. Must connect first.

Message to send Options Send parameters 0

Sends SMTP command to server and returns response.

Command to send Response

Sends SMTP command to server and returns response

Command to send If pipeline then do not recevie. Response

Set the time we should wait for a socket to connect, receive and send data before timing out.

File to write status to

Provides enumerated values for the recipient type.

Standard to address.

Carbon copy.

Blind carbon copy

Provides properties and methods for an SMTP mail server that will be used when sending e-mail messages.

Initializes a new instance of the SMTPServer class with the name, port number and timeout value for the SMTP server.

Name or address of server

Initializes a new instance of the SMTPServer Class

Gets or sets the name or address of the SMTP server.

Name or address of the SMTP server

Represents a collection of SMTPServer objects.

An abstract class for a strongly typed collection.

This class is abstract. It is inherited by the other collection classes and can not be instantiated directly.

Initializes a new instance of the Collection class.

Array that actually holds the collection objects

Position at which collection is referencing

Returns the enumerator.

Object

Moves to the next record.

Returns true on success false if no more records are available.

Removes the first occurrence of a specific object from the collection.

The object to remove from the collection.

Resets the index of the collection to the first object.

Return the last item in the collection.

A reference to the last object in the collection.

Returns current object

Current object in the collection

Gets the number of items in collection.

Number of items in the collection

Initializes a new instance of the SMTPServerCollection class

Creates and adds a SMTPServer object to the collection.

Specifies the hostname or IP address of the SMTP server. The FreeSMTP.Net assembly supports a maximum of one mail server. The retail version of Quiksoft's SMTP .Net assembly supports an unlimited number of SMTP servers. Throws LimitationException if more then one mail server is added.

Adds a SMTPServer object to the collection.

Free SMTP component can only have one SMTP server specified. A reference to an object to add to the collection. Throws LimitationException if more then one mail server is added.

Provides properties and methods for constructing an e-mail Address.

Initializes a new instance of the Address class with an e-mail address and name.

The e-mail address. i.e. j.doe@domain.com The name of the addressee. i.e. John Doe

Initializes a new instance of the Address class with an e-mail address.

The e-mail address. i.e. j.doe@domain.com

Initializes a new instance of the Address class

Member variable that holds the e-mail Address.

Holds that

Gets and sets the e-mail address.

The e-mail address. i.e. j.doe@domain.com

Gets and sets the name of the addressee.

The name of the addressee. i.e. John Doe This property is optional. If this value is specified, the recieving application may use it to display the addressee's name instead of or in addition to their e-mail address.

Provides properties and methods for constructing an e-mail recipient.

Initializes a new instance of the Recipient class

Initializes a new instance of the Recipient class with an e-mail address, name and type.

The e-mail address. i.e. j.doe@domain.com The name of the recipient. i.e. John Doe Type of recipient. Must be one of the RecipientType values.

Gets or sets the e-mail address type of the recipient.

One of the RecipientType values. Default: RecipientType.To

Represents a collection of Recipient objects.

Initializes a new instance of the RecipientCollection class.

Adds a recipient object to the collection.

A reference to the Recipient object to add to the collection.

Creates a Recipient object using specified values and adds it to the RecipientCollection.

The recipient's e-mail address. i.e. j.doe@domain.com

Creates a Recipient object using specified values and adds it to the RecipientCollection.

The recipient's e-mail address. i.e. j.doe@domain.com The name of the recipient. i.e. John Doe

Creates a Recipient object using specified values and adds it to the RecipientCollection.

The recipient's e-mail address. i.e. j.doe@domain.com The name of the recipient. i.e. John Doe One of the RecipientType values.

Provides properties and methods for constructing an e-mail attachment.

Initializes a new instance of the Attachment class.

Initializes a new instance of the Attachment class with the attachment filename.

Name of the file to attach

Initializes a new instance of the Attachment class with the attachment filename and display name.

Name of the file to attach Filename used to label the attachment in the e-mail message. See the DisplayName Property for more information.

Gets and sets the filename of the attachment.

The full path and filename of the attachment.

Gets and sets the filename used to label the attachment in the e-mail message. See remarks.

The filename used to label the attachment in the e-mail message. See remarks. The DisplayName property allows you to label the attachment in the e-mail message with a name that is different than the original filename. This is useful if you are adding an attachment with a temporary file name such as 03230234.dat and want it to be labeled in the message by a more friendly name such as budget.xls. If the DisplayName property is not specified, the attachment will be labeled in the message with its original filename.

Represents a collection of Attachment objects.

Initializes a new instance of the AttachmentCollection class

Adds an attachment object to the collection.

Attachment object to add to the collection.

Creates an Attachment object using specified values and adds it to the AttachmentCollection.

The full path and filename of the attachment to add to the collection.

Creates an Attachment object using specified values and adds it to the AttachmentCollection.

The full path and filename of the attachment to add to the collection. Filename used to identify the attachment in the e-mail message. See the DisplayName Property for more information.

Provides properties and methods for adding a custom header to an e-mail message.

Custom headers can be used to specify additional information in the message, such as flags or instructions to be interprited by the receiving application.

Initializes a new instance of the CustomHeader class

Initializes a new instance of the CustomHeader class with a name and value.

Name of the header. Value of the header.

Gets and sets the name of the header.

Name of the header.

Gets or sets the value of the header.

Value of the header.

Represents a collection of CustomHeader objects.

Initializes a new instance of the CustomHeaderCollection class.

Adds a CustomHeader object to the CustomHeaderCollection.

A reference to the CustomHeader object to add to the collection.

Creates a CustomHeader object using the specified values and adds it to the CustomHeaderCollection.

Name of the header. Value of the header.

Provides properties and methods for constructing a body part of an e-mail message.

The body text is the main body of the message. The FreeSMTP.Net assembly supports a maximum of one plain text body part and one HTML body part. The retail version of Quiksoft's SMTP .Net assembly supports an unlimited number of body parts.

Initializes a new instance of the BodyPart class with a body.

The text of the body part.

Initializes a new instance of the BodyPart class with a body and its format.

The text of the body part One of the BodyPartFormat values specifying the format of the body part Thrown when an invalid value is specified.

Initializes a new instance of the BodyPart class with a body, its format and encoding.

The text of the body part One of the BodyPartFormat values specifying the format of the body part One of the BodyPartEncoding values specifying the encoding method to use on the body part Thrown when an invalid value is specified.

Initializes a new instance of the BodyPart class.

Gets or sets the text of the body part.

The text of the body part.

Gets or sets the format of the body part.

One of the BodyPartFormat values specifying the format of the body part. Default: BodyPartFormat.Plain Thrown when an invalid value is specified.

Gets or sets the encoding method to use on the body part.

One of the BodyPartEncoding values specifying the encoding method to use on the body part. Default: BodyPartEncoding.QuotedPrintable Thrown when an invalid value is specified.

Provides enumerated values for e-mail body format.

Specifies that the body part format is plain text.

Specifies that the body part format is HTML.

Provides enumerated values for e-mail body encoding.

Specifies that no encoding is to be used on the body part.

Specifies that Quoted-Printable encoding is to be used on the body part.

Represents a collection of the BodyParts that are transmitted with the message.

Initializes a new instance of the BodyPartCollection class.

Creates a BodyPart object using specified values and adds it to the BodyPartCollection.

The FreeSMTP.Net assembly supports a maximum of one plain text body part and one HTML body part. The retail version of Quiksoft's SMTP .Net assembly supports an unlimited number of body parts. The text of the body part. One of the BodyPartFormat values specifying the format of the body part. Thrown when a duplicate body part format is detected. See remarks.

Creates a BodyPart object using specified values and adds it to the BodyPartCollection.

The FreeSMTP.Net assembly supports a maximum of one plain text body part and one HTML body part. The retail version of Quiksoft's SMTP .Net assembly supports an unlimited number of body parts. The text of the body part. One of the BodyPartFormat values specifying the format of the body part. ne of the BodyPartEncoding values specifying the encoding method to use on the body part. Thrown when a duplicate body part format is detected. See remarks.

Adds a BodyPart object to the BodyPartCollection.

The FreeSMTP.Net assembly supports a maximum of one plain text body part and one HTML body part. The retail version of Quiksoft's SMTP .Net assembly supports an unlimited number of body parts. A reference to the BodyPart object to add to the collection. Thrown when a duplicate body part format is detected. See remarks.

The exception that is thrown when a protocol error is returned from the SMTP server.

Initializes a new instance of the SMTPProtocolException class with a specified error message.

The error message string.

Initializes a new instance of the SMTPProtocolException class with a specified error message and a reference to the inner exception that is the cause of this exception.

The error message string. The inner exception reference.

The exception that is thrown when there is a socket connection error.

Initializes a new instance of the FreeSMTPConnectionException class with a specified error message.

The error message string.

Initializes a new instance of the FreeSMTPConnectionException class with a specified error message and a reference to the inner exception that is the cause of this exception.

The error message string. The inner exception reference.

The exception that is thrown when there is an error related to the file system.

Initializes a new instance of the SMTPFileIOException class with a specified error message.

The error message string.

Initializes a new instance of the SMTPFileIOException class with a specified error message and a reference to the inner exception that is the cause of this exception.

The error message string. The inner exception reference.

The exception that is thrown when an invalid or unsupported option is used.

Initializes a new instance of the SMTPFileIOException class with a specified error message.

The error message string.

Initializes a new instance of the LimitationException class with a specified error message and a reference to the inner exception that is the cause of this exception.

The error message string. The inner exception reference.

Summary description for ValidateL.