Then include “send_email.js” in default.html and add two input (button) HTML tags and one span HTML tag in default.html like this:
EASendMail is a SMTP component which supports all operations of SMTP/ESMTP protocols (RFC 821, RFC 822, RFC 2554). It also supports Exchange Web Service (EWS) and WebDAV protocols. Before you can use the following example codes, you should download the EASendMail Installer and install it on your machine at first.
Install from NuGet
You can also install the run-time assembly by NuGet. Run the following command in the NuGet Package Manager Console:
If you install it by NuGet, no sample projects are installed, only .NET assembly is installed.
To use EASendMail SMTP Component in your Windows Store App/UWP project, the first step is “Add reference
of EASendMail to your project”. Please create/open your project with Visual Studio,
then select menu ->
Add Reference ->
EASendMailRT.winmd from local disk, click
OK, the reference will
be added to your project, and you can start to use EASendMail SMTP
Component in your project.
After compiling your project, a copy of EASendMailRT.winmd will be generated by compiler
in same folder of your application executable file. Packing all the
in the folder to installer is ok. As EASendMailRT.winmd is a pure Windows 8/10 Runtime Component, it doesn’t
require “Regsvr32” (self-register) to register the dll.
|File||.NET Framework Version|
|windows8.winmd\EASendMailRT.winmd||Built with .NET Framework 4.5
It requires Windows Store App Runtime.
|windows81.winmd\EASendMailRT.winmd||Built with .NET Framework 4.5
It requires Windows Store App 8.1 Runtime.
|windows10.winmd\EASendMailRT.winmd||Built with .NET Framework 4.6
It requires Windows 10 UWP.
Now add the following codes to the send_email.js and change
Password to corresponding value and compile your project.
If you set everything right, click the button, you can get “email was sent successfully”. If you get “failed to send email with the following error:”, then please have a look at the following section.
When you execute above example code, if it threw an exception about “Networking connection” or “No such host”, it is likely that your SMTP server address is not correct. If it threw an exception about “5xx Relay denied”, it is likely that you did not set user authentication. Another common error is “5xx Must issue a STARTTLS command first” or “No supported authentication marshal found!”, that is because your SMTP server requires user authentication under SSL connection. You can set the SSL connection to solve this problem. You can learn more detail in Troubleshooting section.
Because each email account provider has different server address, so you should query your SMTP server address from your email account provider. To prevent spreading email from the server, most SMTP servers also require user authentication. User name is your email address or your email address without domain part, it depends on your email provider setting.
When you execute above example code, if you get error about “Networking connection” or “No such host”, it is likely that your SMTP server address is not correct. If you get an error like “5xx Relay denied”, it is likely that you did not set user authentication. Another common error is “5xx Must issue a STARTTLS command first” or “No supported authentication marshal found!”, that is because your SMTP server requires user authentication under SSL connection. You can set the SSL connection to solve this problem.
Finally, if you have already set your account in your email client such as Outlook or Window Mail, you can query your SMTP server address, user in your email client. For example, you can choose menu -> “Tools” - > - “Accounts” - > “Your email account” - > “Properties” - > “Servers” in Outlook express or Windows Mail to get your SMTP server, user. Using EASendMail to send email does not require you have email client installed on your machine or MAPI, however you can query your exist email accounts in your email client.
Mail Address Syntax in EASendMail SMTP Component:
// For single email address (From, ReplyTo, ReturnPath), the syntax can be: // ["][display name]["]<email address> // For example: "Tester, T" <firstname.lastname@example.org> Tester <email@example.com> <firstname.lastname@example.org> email@example.com // For mulitple email address (To, CC, Bcc), the syntax can be: // [single email],[single email]... // (,;\r\n) can be used to separate multiple email addresses. // For example: "Tester, T" <firstname.lastname@example.org>, Tester2 <email@example.com>, <firstname.lastname@example.org>, email@example.com
To better understand the email address syntax, please refer to the following codes.
// From is a MailAddress class. // The syntax is like this: "firstname.lastname@example.org" or "Tester<email@example.com>" oMail.from = new EASendMailRT.MailAddress( "Tester", "firstname.lastname@example.org" ); oMail.from = new EASendMailRT.MailAddress( "Tester<email@example.com>"); oMail.from = new EASendMailRT.MailAddress( "firstname.lastname@example.org" ); // To, Cc and Bcc is a AddressCollection class, // Multiple addresses are separated with (,;) // The syntax is like this: "email@example.com, firstname.lastname@example.org" // The example code without implicit converting oMail.to = new EASendMailRT.AddressCollection( "email@example.com, firstname.lastname@example.org" ); oMail.to = new EASendMailRT.AddressCollection( "Test1<email@example.com>, Test2<firstname.lastname@example.org>"); // You can add more recipient by Add method oMail.to.add( new EASendMailRT.MailAddress( "tester", "email@example.com")); // You can also add carbon copy (CC) or blind carbon copy (BCC) in the email. oMail.cc.add( new EASendMailRT.MailAddress( "CC recipient", "firstname.lastname@example.org")); oMail.bcc.add( new EASendMailRT.MailAddress( "Bcc recipient", "email@example.com"));
From, Reply-To, Sender and Return-Path are common email headers in email message. You should always set From property at first, it is a MUST to identify the email sender. The following table lists the header and corresponding properties:
This property indicates the original email sender. This is what you see as the “FROM” in most mail clients.
This property indicates the reply address. Basically, when the user clicks “reply” in mail client, the Reply-To value should be used as the recpient address of the replied email. If you don’t set this property, the Reply address is same as From address.
This property indicates the who submit/send the email. When the user received the email, the email client displays: From: “sender address” on behalf of “from address”. If you don’t set this property, the Sender address is same as From address. Sender property is common used by mail listing provider. This property also takes effect to DKIM/DomainKeys signature, if Sender is different with From address, then you should sign DKIM/DomainKeys based on Sender domain instead of From address domain.
This property indicates the delivery notification report address. If you don’t set this property, the Return-Path address is same as From address. This property also takes effect to SPF record, if Return-Path is different with From address, then remote SMTP server checkes SPF record of Return-Path instead of From address.
The following example codes demonstrate how to specify From, Reply-To, Sender and Return-Path in Email. With the following example codes:
firstname.lastname@example.org behalf of
oMail.from = "email@example.com"; oMail.replyTo = new EASendMailRT.MailAddress( "replyto@@emailarchitect.net" ); oMail.sender = "firstname.lastname@example.org"; oMail.returnPath = "email@example.com";
If you want to set Higher or Lower priority to your email, you can use Priority prority
// Set high priority oMail.priority = EASendMailRT.MailPriority.high;
When you send email in above simple C# project, if it threw an exception, please have a look at the following tips:
This error means DNS server cannot resolve SMTP server, you should check if you input correct server address. If your server address is correct, you should check if your DNS server setting is correct.
This error means there is a problem with networking connection to SMTP server. You can use Windows built-in Telnet command to detect the networking connection.
Notice: in Windows 2008/Windows 8 or later version,
Telnet Client is not installed
by default, you should enable this command in
Control Panel ->
Turn Windows feature on or off -> have
Telnet Client checked.
Under DOS command prompt, input “telnet [serveraddress] [port]”:
telnet mail.emailarchitect.net 25 press enter.
If the networking connection to your SMTP server is good, it should return a message
220 .... If it returns
Could not open connection to ..., that means the
networking connection to SMTP server is bad, or outbound 25 port is blocked by anti-virus
software, firewall or ISP. Please have a look at the following screenshot:
25 port is the default SMTP server port to receive email. However, some ISP block outbound 25 port to prevent user to send email directly to other SMTP server. Therefore, many email providers also provide an alternative port 587 to receive email from such users. 465 port is the common port used to receive email over implicit SSL connection. If you use telnet to test 465 port, it doesn’t return the “220...”, because it requires SSL hand shake. But if the connection is ok, telnet returns a flash cursor.
This error means SMTP server blocks your IP address or email content. You can try to set user/password in your codes to do user authentication and try it again. If email client set user authentication, most SMTP servers do not check client source IP address in black list.
TThis error means user authentication is failed, you should check whether you input correct user/password. Password is always case-sensitive.
For anti-spam policy, most SMTP servers do not accept the email to outbound domain without user authentication. You should set user/password in the codes and try it again.
This error means SMTP server requires SSL/TLS connection. You should enable SSL/TLS connection like this:
// If your smtp server requires TLS connection, please add this line oServer.connectType = EASendMailRT.SmtpConnectType.connectSSLAuto;
This error means SMTP server doesn’t support user authentication or it requires user authentication over SSL/TLS connection. You can try to remove user/password in your codes and try it again.
If SMTP server returns an error, it usually returns description about this error. Some descriptions also include a HTTP link, you can go to this linked web page to learn more detail. You can also use the following codes to generate a log file to learn all SMTP session between client and server.
// add this line here to generate log file oSmtp.logFileName = "ms-appdata:///local/smtp.txt"; oSmtp.sendMail(oServer, oMail);
If you have any comments or questions about above example codes, please click here to add your comments.