|
|
|
|
|
|
Using aspNetEmail in Visual
Studio .NET [C#]
|
|
Summary
The following article will describe how to use aspNetEmail from
Visual Studio .NET using C#. This brief tutorial assumes you
have IIS installed locally on your machine, and have downloaded and
installed aspNetEmail from www.aspNetEmail.com
Instructions
Using Visual Studio .NET (VS.NET ) We will create a single
webform (emailtest.aspx) and send out an email.
Creating the Project Using the following instructions,
create a c# project on local server.
1. Launch Visual Studio .NET
2. From the main menu, select the File | New |
Project command.
3. The New Project dialog box appears. Under Project
Types, Select Visual C# Projects. Under Templates,
select ASP.NET Web Application. In the Location
textbox, enter http://localhost/aspNetEmailTest
Setting the Reference to aspNetEmail. There are two
ways to set a reference in
VS.NET. Because aspNetEmail is installed in the GAC (Global Assembly Cache)
you can set a reference to the GAC copy, or you can upload
aspNetEmail to the project and set a reference to the uploaded copy. We
will upload a copy, and set a reference to the uploaded copy.
This method will promote XCOPY deployment, considered a best practice by
Microsoft. (A comment about licensing: Please be sure you are
compliant with your licenses. Check http://www.aspNetEmail.com/licen.aspx
for more information.)
1. In the Solution Explorer, right-click the project name,
aspNetEmailTest, and select the Add | Add Existing Item
command.
2. The Add Existing Item dialog box appears. Under
Files of Type, select All Files(*.*).
Navigate to the
aspNetEmail install directory. By default, this directory is
C:\Program Files\AdvancedIntellect\aspNetEmail. Double-click the
aspNetEmail.dll. The Add Existing Item dialog box
closes, and the aspNetEmail.dll was uploaded to the root directory
of your project.
3. In the Solution Explorer, right-click the project name
aspNetEmailTest and select Add Reference. The Add
Reference dialog box appears. Click the Browse button.
The Select Component dialog box appears. Double-click the
aspNetEmail.dll file. The Select Component dialog box
closes. Click OK. The Add Reference dialog box closes,
and a reference is set to aspNetEmail.
Create a Test Page. Now that we have a reference set,
let's create a test page to check aspNetEmail.
1. In the Solution Explorer, right-click the project name
aspNetEmail test, and select Add | Add Webform. The Add
New Item dialog box appears. In the Name textbox, enter,
emailtest.aspx.
2. In the Solution Explorer, right-click
emailtest.aspx, and select View Code.
3. Under the Page_Load function, replace the line
// Put user code to initialize the page here
With the following code.
aspNetEmail.EmailMessage msg = new
aspNetEmail.EmailMessage(); msg.Server =
"Mail.mycompany.com"; msg.FromAddress =
"me@mycompany.com"; msg.To =
"You@yourcompany.com"; msg.Subject = "Test Email"; msg.Body
="This is a test email."; if ( msg.Send()
) { Response.Write( "Message
Sent."); } else { Response.Write ("The following error
occurred: " + msg.LastException().Message); }
You will need to replace the following properties with values
that will work with your system:
msg.Server = "Mail.mycompany.com"; msg.FromAddress =
"me@mycompany.com"; msg.To = "You@yourcompany.com";
Testing The Page Lets compile and test the page.
1. In the Solution Explorer, right-click the project name,
aspNetEmailTest, and select Build. The project will be
compiled.
2. In the Solution Explorer, right-click
emailtest.aspx and select View in Browser.
3. Check your email to verify the email was sent to the 'To'
address found on the line of code:
msg.To = "You@yourcompany.com";
Summary
That's all there is to using aspNetEmail from Visual Studio .NET.
In these few simple steps you were able to create a project, set a
reference to aspNetEmail, and send a sample email.
For more questions or comments, feel free to write support@aspNetEmail.com
|