Difference between revisions of "TSmtpCli"

From Overbyte
Jump to navigation Jump to search
 
(44 intermediate revisions by 2 users not shown)
Line 3: Line 3:
 
== Overview ==
 
== Overview ==
  
* '''unit''' SmtpProt
+
* '''unit''' [[OverbyteIcsSmtpProt.pas | OverbyteIcsSmtpProt.pas]]
* '''inheritance''' TCustomSmtpCli->TSmtpCli
+
* '''inheritance''' TIcsWndControl -> TCustomSmtpClient -> TSmtpCli  
  
 
Component '''TSmtpCli''' implements client-side of the Simple Mail Transfer Protocol as specified in
 
Component '''TSmtpCli''' implements client-side of the Simple Mail Transfer Protocol as specified in
RFC [http://rfc.net/rfc2821.html 2821], and MIME message format according to RFC [http://rfc.net/rfc1521.html 1521] and [http://rfc.net/rfc2045.html 2045]. Currently supported SMTP Service Extensions for Authentication are
+
RFC [http://www.ietf.org/rfc/rfc2821.txt 2821], and MIME message format according to RFC [http://www.ietf.org/rfc/rfc1521.txt 1521] and [http://www.ietf.org/rfc/rfc2045.txt 2045]. Currently supported SMTP Service Extensions for Authentication are
AUTH LOGIN, AUTH PLAIN, AUTH CRAM-MD5 and AUTH CRAM-SHA1 (RFC [http://rfc.net/rfc2554.html 2554] as well as RFC [http://rfc.net/rfc1734.html 1734]).
+
AUTH LOGIN, AUTH PLAIN, AUTH CRAM-MD5 and AUTH CRAM-SHA1 (RFC [http://www.ietf.org/rfc/rfc2554.txt 2554] as well as RFC [http://www.ietf.org/rfc/rfc1734.txt 1734]).
The TSmtpCli is working [[Asynchronous_Paradigm | '''non-blocking''']], a synchronously working counterpart is also available, see [[TSyncSmtpCli | TSyncSmtpCli]].
+
The TSmtpCli methods are [[Asynchronous_Paradigm | '''non-blocking''']], a synchronously working counterpart is also available, see [[TSyncSmtpCli | TSyncSmtpCli]].
 +
 
 +
[[What's_new_in_TSmtpCli_V7 | What's new in TSmtpCli V7?]]
  
 
== Properties ==
 
== Properties ==
  
 
{|
 
{|
| valign="top" width="140" | [[TSmtpCli.AuthType | AuthType]] |||| Authentication methode to be used with method [[TSmtpCli.Auth | '''Auth''']]
+
| valign="top" width="140" | [[TSmtpCli.Allow8BitChars | Allow8BitChars ]] |||| If set to FALSE enables internal encoding of header lines and MailMessage text
 +
|-
 +
| valign="top" | [[TSmtpCli.AuthType | AuthType]] |||| Authentication type to be used with method [[TSmtpCli.Auth | '''Auth''']]
 +
|-
 +
| valign="top" | [[TSmtpCli.AuthTypesSupported | AuthTypesSupported]] |||| A list of authentication types supported by the server available after SMTP command [[TSmtpCli.Ehlo | '''EHLO''']] returned
 
|-
 
|-
| valign="top" | [[TSmtpCli.AuthTypesSupported | AuthTypesSupported]] |||| A list of authentication methods supported by the server available after SMTP command [[TSmtpCli.Ehlo | '''EHLO''']] returned
+
| valign="top" | [[TSmtpCli.CharSet | CharSet]] |||| [http://www.iana.org/assignments/character-sets Character set] of the mail message, default value is the preferred MIME name of current system charset
 
|-
 
|-
| valign="top" | [[TSmtpCli.CharSet | CharSet]] |||| The Character set, default value iso-8859-1
+
| valign="top" | [[TSmtpCli.CodePage | CodePage]] |||| The [http://msdn.microsoft.com/en-us/library/dd317756.aspx Windows code page identifier] mapped to value of property [[TSmtpCli.CharSet | CharSet]] (V7)
 
|-
 
|-
 
| valign="top" | [[TSmtpCli.ConfirmReceipt | ConfirmReceipt]] |||| Request confirmation of receipt
 
| valign="top" | [[TSmtpCli.ConfirmReceipt | ConfirmReceipt]] |||| Request confirmation of receipt
Line 25: Line 31:
 
|-
 
|-
 
| valign="top" | [[TSmtpCli.ContentType | ContentType]] |||| Either HTML or plain text (smtpHtml or smtpPlainText)
 
| valign="top" | [[TSmtpCli.ContentType | ContentType]] |||| Either HTML or plain text (smtpHtml or smtpPlainText)
 +
|-
 +
| valign="top" | [[TSmtpCli.ConvertToCharset | ConvertToCharset]] |||| Allow charset conversion (ignored by UNICODE compilers, new in V7)
 
|-
 
|-
 
| valign="top" | [[TWSocket | CtrlSocket]] |||| {{CtrlSocket}}
 
| valign="top" | [[TWSocket | CtrlSocket]] |||| {{CtrlSocket}}
 
|-
 
|-
| valign="top" | [[TSmtpCli.EmailFiles | EmailFiles]] |||| File attachments
+
| valign="top" | [[TSmtpCli.DefaultEncoding | DefaultEncoding]] |||| Default Transfer-Encoding
 +
|-
 +
| valign="top" | [[TSmtpCli.EmailFiles | EmailFiles]] |||| List of files to be attached
 
|-
 
|-
 
| valign="top" | [[TSmtpCli.ErrorMessage | ErrorMessage]] |||| Last SMTP error message
 
| valign="top" | [[TSmtpCli.ErrorMessage | ErrorMessage]] |||| Last SMTP error message
 
|-
 
|-
| valign="top" | [[TSmtpCli.FromName | FromName]] |||| E-mail address to be sent to the mail server with SMTP command [[TSmtpCli.MailTo | '''MAIL''']]
+
| valign="top" | [[TSmtpCli.FoldHeaders | FoldHeaders]] |||| Fold header lines if their length exceed the limit   
 +
|-
 +
| valign="top" | [[TSmtpCli.FromName | FromName]] |||| E-mail address sent to the mail server with SMTP command [[TSmtpCli.MailTo | '''MAIL''']]
 
|-
 
|-
 
| valign="top" | [[TSmtpCli.Handle | Handle]] |||| Handle of the hidden window used internally by the component
 
| valign="top" | [[TSmtpCli.Handle | Handle]] |||| Handle of the hidden window used internally by the component
Line 52: Line 64:
 
| valign="top" | [[TSmtpCli.HdrTo | HdrTo]] |||| Value of mail header line '''To'''
 
| valign="top" | [[TSmtpCli.HdrTo | HdrTo]] |||| Value of mail header line '''To'''
 
|-
 
|-
| valign="top" | [[TSmtpCli.Host | Host]] |||| Host name or IP Address of the SMTP server
+
| valign="top" | [[TSmtpCli.Host | Host]] |||| Host name or IP address of the SMTP server
 
|-
 
|-
 
| valign="top" | [[TSmtpCli.LastResponse | LastResponse]] |||| Last response from the mail server.
 
| valign="top" | [[TSmtpCli.LastResponse | LastResponse]] |||| Last response from the mail server.
 
|-
 
|-
| valign="top" | [[TSmtpCli.LocalAddr | LocalAddr]] ||||  
+
| valign="top" | [[TSmtpCli.LocalAddr | LocalAddr]] |||| Interface to be bound to the socket, defaults to "0.0.0.0" = any interface
 +
|-
 +
| valign="top" | [[TSmtpCli.MailMessage | MailMessage]] |||| The mail message text.
 
|-
 
|-
| valign="top" | [[TSmtpCli.MailMessage | MailMessage]] |||| The mail message.
+
| valign="top" | [[TSmtpCli.MaxMessageSize | MaxMessageSize]] |||| Indicates the maximum message size accepted by the server (V7)
 
|-
 
|-
 
| valign="top" | [[TSmtpCli.MessageID | MessageID]] |||| A unique ID created for each mail message, appears as mail header line (Message-ID)
 
| valign="top" | [[TSmtpCli.MessageID | MessageID]] |||| A unique ID created for each mail message, appears as mail header line (Message-ID)
 
|-
 
|-
| valign="top" | [[TSmtpCli.OwnHeaders | OwnHeaders]] |||| Set OwnHeaders to True in order to build your own, custom headers.
+
| valign="top" | [[TSmtpCli.MessageSize | MessageSize]] |||| Size of the e-mail (V7)
 +
|-
 +
| valign="top" | [[TSmtpCli.OwnHeaders | OwnHeaders]] |||| Set OwnHeaders to True in order to send your own, custom header lines.
 
|-
 
|-
 
| valign="top" | [[TSmtpCli.Password | Password]] |||| SMTP login password  
 
| valign="top" | [[TSmtpCli.Password | Password]] |||| SMTP login password  
Line 74: Line 90:
 
| valign="top" | [[TSmtpCli.ShareMode | ShareMode]] |||| ShareMode of the stream (file attachments).  
 
| valign="top" | [[TSmtpCli.ShareMode | ShareMode]] |||| ShareMode of the stream (file attachments).  
 
|-
 
|-
| valign="top" | [[TSmtpCli.SignOn | SignOn]] |||| Parameter sent with the SMTP commands [[TSmtpCli.Helo | '''HELO''']] and [[TSmtpCli.Ehlo | '''EHLO''']]  
+
| valign="top" | [[TSmtpCli.SignOn | SignOn]] |||| Parameter sent with the SMTP commands [[TSmtpCli.Helo | '''HELO''']] and [[TSmtpCli.Ehlo | '''EHLO''']]
 +
|-
 +
| valign="top" | [[TSmtpCli.SizeSupported | SizeSupported]] |||| Indicates whether the server supports the RFC-1870 SIZE extension (V7) 
 
|-
 
|-
 
| valign="top" | [[TSmtpCli.State | State]] |||| Current component state
 
| valign="top" | [[TSmtpCli.State | State]] |||| Current component state
 
|-
 
|-
| valign="top" | [[TSmtpCli.Username | Username]] |||| SMTP login username  
+
| valign="top" | [[TSmtpCli.Username | Username]] |||| SMTP login username
 +
|-
 +
| valign="top" | [[TSmtpCli.WrapMessageText | WrapMessageText]] |||| Tries to insert line breaks in unencoded [[TSmtpCli.MailMessage | MailMessage]] text if line length exceed value of property WrapMsgMaxLineLen
 +
|-
 +
| valign="top" | [[TSmtpCli.WrapMsgMaxLineLen | WrapMsgMaxLineLen]] |||| MailMessage maximum line length (V7)
 
|}
 
|}
  
Line 86: Line 108:
 
| width="140" valign="top" | [[TSmtpCli.Abort | Abort]] |||| Cancels any transactions in progress, closes server connection.
 
| width="140" valign="top" | [[TSmtpCli.Abort | Abort]] |||| Cancels any transactions in progress, closes server connection.
 
|-  
 
|-  
| valign="top" | [[TSmtpCli.Auth | Auth]] |||| Sends SMTP command '''AUTH''' starting the authentication process.  
+
| valign="top" | [[TSmtpCli.Auth | Auth]] |||| Sends SMTP command '''AUTH''' starting the authentication process.
 +
|-
 +
| valign="top" | [[TSmtpCli.CalcMsgSize | CalcMsgSize]] |||| Calculates message size (V7)
 +
|-
 +
| valign="top" | [[TSmtpCli.CalcMsgSizeSync | CalcMsgSizeSync]] |||| Calculates message size synchronously (V7)
 
|-
 
|-
 
| valign="top" | [[TSmtpCli.Connect | Connect]] |||| Connects to the mail server.
 
| valign="top" | [[TSmtpCli.Connect | Connect]] |||| Connects to the mail server.
Line 105: Line 131:
 
|-
 
|-
 
| valign="top" | [[TSmtpCli.MailFrom | MailFrom]] |||| Sends SMTP command '''MAIL'''
 
| valign="top" | [[TSmtpCli.MailFrom | MailFrom]] |||| Sends SMTP command '''MAIL'''
 +
|-
 +
| valign="top" | [[TSmtpCli.MailFromSIZE | MailFromSIZE]] |||| Same as  [[TSmtpCli.MailFrom | MailFrom]] however appends the message size as argument (V7)
 
|-
 
|-
 
| valign="top" | [[TSmtpCli.Open | Open]] |||| Executes methods [[TSmtpCli.Connect | Connect]], [[TSmtpCli.Ehlo | Ehlo]], and [[TSmtpCli.Auth | Auth]] consecutively.
 
| valign="top" | [[TSmtpCli.Open | Open]] |||| Executes methods [[TSmtpCli.Connect | Connect]], [[TSmtpCli.Ehlo | Ehlo]], and [[TSmtpCli.Auth | Auth]] consecutively.
Line 126: Line 154:
  
 
{|
 
{|
| valign="top" width="140" | [[TSmtpCli.OnAfterFileOpen | OnAfterFileOpen]] |||| Align test
+
| valign="top" width="140" | [[TSmtpCli.OnAfterFileOpen | OnAfterFileOpen]] |||| Triggered after the attempt to open a file to be attached.
 +
|-
 +
| valign="top" | [[TSmtpCli.OnAttachContentType | OnAttachContentType]] |||| Triggered before the content-type header line of an attachment part header is formed.
 
|-
 
|-
| valign="top" | [[TSmtpCli.OnAttachContentType | OnAttachContentType]] ||||
+
| valign="top" | [[TSmtpCli.OnAttachHeader | OnAttachHeader]] |||| Triggered after all header lines of an attachment part header have been formed. 
 
|-
 
|-
| valign="top" | [[TSmtpCli.OnAttachHeader | OnAttachHeader]] ||||
+
| valign="top" | [[TSmtpCli.OnBeforeFileOpen | OnBeforeFileOpen]] |||| Triggered before the attempt to open a file to be attached.
 
|-
 
|-
| valign="top" | [[TSmtpCli.OnBeforeFileOpen | OnBeforeFileOpen]] ||||
+
| valign="top" | [[TSmtpCli.OnCommand | OnCommand]] |||| Triggered on every command that is sent.
 
|-
 
|-
| valign="top" | [[TSmtpCli.OnCommand | OnCommand]] ||||
+
| valign="top" | [[TSmtpCli.OnDisplay | OnDisplay]] |||| Triggered on every command/response. Useful for debugging purposes.
 
|-
 
|-
| valign="top" | [[TSmtpCli.OnDisplay | OnDisplay]] |||| Triggered for every command/response. Is very useful to output for debug-purposes.
+
| valign="top" | [[TSmtpCli.OnGetData | OnGetData]] |||| Triggered when the component requests next data line, useful for sending custom data.
 
|-
 
|-
| valign="top" | [[TSmtpCli.OnGetData | OnGetData]] ||||
+
| valign="top" | [[TSmtpCli.OnHeaderLine | OnHeaderLine]] |||| Triggered on each mail header line.
 
|-
 
|-
| valign="top" | [[TSmtpCli.OnHeaderLine | OnHeaderLine]] ||||
+
| valign="top" | [[TSmtpCli.OnMessageDataSent | OnMessageDataSent]] |||| Triggered whenever message data have been sent (V7).
 
|-
 
|-
| valign="top" | [[TSmtpCli.OnProcessHeader | OnProcessHeader]] ||||
+
| valign="top" | [[TSmtpCli.OnProcessHeader | OnProcessHeader]] |||| Triggered before the mail header lines are formed.
 
|-
 
|-
| valign="top" | [[TSmtpCli.OnRcptToError | OnRcptToError]] ||||
+
| valign="top" | [[TSmtpCli.OnRcptToError | OnRcptToError]] |||| Triggered when one of the recipients are i.e. rejected by server for some reason.
 
|-
 
|-
 
| valign="top" | [[TSmtpCli.OnRequestDone | OnRequestDone]] |||| Triggered when a request is completed.  
 
| valign="top" | [[TSmtpCli.OnRequestDone | OnRequestDone]] |||| Triggered when a request is completed.  
 
|-
 
|-
| valign="top" | [[TSmtpCli.OnResponse | OnResponse]] ||||
+
| valign="top" | [[TSmtpCli.OnResponse | OnResponse]] |||| Triggered on server's response.
 
|-
 
|-
| valign="top" | [[TSmtpCli.OnSessionClosed | OnSessionClosed]] ||||
+
| valign="top" | [[TSmtpCli.OnSessionClosed | OnSessionClosed]] |||| Triggered when the connection has been closed.
 
|-
 
|-
| valign="top" | [[TSmtpCli.OnSessionConnected | OnSessionConnected]] ||||
+
| valign="top" | [[TSmtpCli.OnSessionConnected | OnSessionConnected]] |||| Triggered when a connection has been established.
 
|}
 
|}
  
Line 158: Line 188:
  
 
[[TSmtpCli.FAQ.question | question]]
 
[[TSmtpCli.FAQ.question | question]]
 +
 +
== See also ==
 +
*[[What's_new_in_TSmtpCli_V7 | What's new in TSmtpCli V7]]
  
 
{{Components_Footer}}
 
{{Components_Footer}}

Latest revision as of 20:12, 17 January 2016

Main page -> ICS component reference -> TSmtpCli

Overview

Component TSmtpCli implements client-side of the Simple Mail Transfer Protocol as specified in RFC 2821, and MIME message format according to RFC 1521 and 2045. Currently supported SMTP Service Extensions for Authentication are AUTH LOGIN, AUTH PLAIN, AUTH CRAM-MD5 and AUTH CRAM-SHA1 (RFC 2554 as well as RFC 1734). The TSmtpCli methods are non-blocking, a synchronously working counterpart is also available, see TSyncSmtpCli.

What's new in TSmtpCli V7?

Properties

Allow8BitChars If set to FALSE enables internal encoding of header lines and MailMessage text
AuthType Authentication type to be used with method Auth
AuthTypesSupported A list of authentication types supported by the server available after SMTP command EHLO returned
CharSet Character set of the mail message, default value is the preferred MIME name of current system charset
CodePage The Windows code page identifier mapped to value of property CharSet (V7)
ConfirmReceipt Request confirmation of receipt
Connected Are we connected to the mail server?
ContentType Either HTML or plain text (smtpHtml or smtpPlainText)
ConvertToCharset Allow charset conversion (ignored by UNICODE compilers, new in V7)
CtrlSocket The underlying instance of TWSocket handles the connection and raw data exchange.
DefaultEncoding Default Transfer-Encoding
EmailFiles List of files to be attached
ErrorMessage Last SMTP error message
FoldHeaders Fold header lines if their length exceed the limit
FromName E-mail address sent to the mail server with SMTP command MAIL
Handle Handle of the hidden window used internally by the component
HdrCc Value of mail header line CC
HdrFrom Value of mail header line From
HdrPriority Mail priority (creates a custom mail header line).
HdrReplyTo Value of mail header line Reply-To
HdrReturnPath Value of mail header line Return-Path
HdrSender Value of mail header line Sender
HdrSubject Value of mail header line Subject
HdrTo Value of mail header line To
Host Host name or IP address of the SMTP server
LastResponse Last response from the mail server.
LocalAddr Interface to be bound to the socket, defaults to "0.0.0.0" = any interface
MailMessage The mail message text.
MaxMessageSize Indicates the maximum message size accepted by the server (V7)
MessageID A unique ID created for each mail message, appears as mail header line (Message-ID)
MessageSize Size of the e-mail (V7)
OwnHeaders Set OwnHeaders to True in order to send your own, custom header lines.
Password SMTP login password
Port Port number of the SMTP server, defaults to 25
RcptName E-mail address to be sent to the mail server with SMTP command RCPT
RequestType Current request type
ShareMode ShareMode of the stream (file attachments).
SignOn Parameter sent with the SMTP commands HELO and EHLO
SizeSupported Indicates whether the server supports the RFC-1870 SIZE extension (V7)
State Current component state
Username SMTP login username
WrapMessageText Tries to insert line breaks in unencoded MailMessage text if line length exceed value of property WrapMsgMaxLineLen
WrapMsgMaxLineLen MailMessage maximum line length (V7)

Methods

Abort Cancels any transactions in progress, closes server connection.
Auth Sends SMTP command AUTH starting the authentication process.
CalcMsgSize Calculates message size (V7)
CalcMsgSizeSync Calculates message size synchronously (V7)
Connect Connects to the mail server.
Create Constructor
Data Sends SMTP command DATA.
Destroy Destructor
Ehlo Sends SMTP command EHLO.
Helo Sends SMTP command HELO.
HighLevelAsync Execute multiple commands consecutively
Mail Executes methods MailFrom, RcptTo, and Data consecutively.
MailFrom Sends SMTP command MAIL
MailFromSIZE Same as MailFrom however appends the message size as argument (V7)
Open Executes methods Connect, Ehlo, and Auth consecutively.
Quit Sends SMTP command QUIT
RcptNameAdd Assigns recipients to the various recipient lists.
RcptTo Sends SMTP command RCPT, for each recipient in the lists.
Rset Sends SMTP command RSET.
ThreadAttach Attaches the component to current thread context.
ThreadDetach Detaches the component from current thread context.
Vrfy Sends SMTP command VRFY.

Events

OnAfterFileOpen Triggered after the attempt to open a file to be attached.
OnAttachContentType Triggered before the content-type header line of an attachment part header is formed.
OnAttachHeader Triggered after all header lines of an attachment part header have been formed.
OnBeforeFileOpen Triggered before the attempt to open a file to be attached.
OnCommand Triggered on every command that is sent.
OnDisplay Triggered on every command/response. Useful for debugging purposes.
OnGetData Triggered when the component requests next data line, useful for sending custom data.
OnHeaderLine Triggered on each mail header line.
OnMessageDataSent Triggered whenever message data have been sent (V7).
OnProcessHeader Triggered before the mail header lines are formed.
OnRcptToError Triggered when one of the recipients are i.e. rejected by server for some reason.
OnRequestDone Triggered when a request is completed.
OnResponse Triggered on server's response.
OnSessionClosed Triggered when the connection has been closed.
OnSessionConnected Triggered when a connection has been established.

How to

question

See also



ICS Components Reference