Attachment Class


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

System.Object
    EASendMail.MimePart
        EASendMail.Attachment

[Visual Basic]
Public Class Attachment
[C#]
public class Attachment
[C++]
public ref class Attachment
[JScript]
public class Attachment

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Public Constructors

Attachment Constructor Initializes a new instance of the Attachment class.

Public Properties

ContentID Gets or sets the Content-ID of the embedded attachment.
Name Gets or sets the name of the attachment.

Public Methods

Load Loads the attachment from a file or remote web site.

Remarks

It is not recommended to construct Attachment class instance directly. To add an attachment to email, please use SmtpMail.AddAttachment method, this method returns an Attachment class instance, ContentID and Name of the Attachment instance can be changed then.
To attach embedded images or pictures, SmtpMail.ImportHtmlBody and SmtpMail.ImportHtml methods are strongly recommended.

Example

[Visual Basic, C#, C++, JScript.NET] To get the full samples of EASendMail, please refer to Samples section.

[VB - Email Attachment]
Imports EASendMail

Public Sub AttachFile()
    Try
        Dim oMail As SmtpMail = New SmtpMail("TryIt")
        Dim oAttachment As Attachment = oMail.AddAttachment( "c:\test.gif" )
        
        'adds attachment from remote host
        'Dim oAttachment As Attachment = oMail.AddAttachment( "http://www.adminsystem.com/test.gif" )
        
        'changes attachment name to another name
        'oAttachment.Name = "mytest.gif"
        
        'specifies the attachment as an embedded picture
        'Dim contentID As String = "test001@host"
        'oAttachment.ContentID = contentID
        'oMail.HtmlBody = "<html><body>this is a <img src=""cid:" & contentID & """> embedded picture.</body></html>"
        
        'save as an eml file, you can use outlook express to open and check it.
        oMail.SaveAs( "c:\test.eml", True )
        
    Catch exp As System.Exception
        MessageBox.Show(exp.Message)
    End Try
End Sub

[C# - Email Attachment]
using System;
using System.Collections;
using EASendMail;

public void AttachFile()
{
    try
    {	  
        SmtpMail oMail = new SmtpMail("TryIt");
        Attachment oAttachment = oMail.AddAttachment( "c:\\test.gif" );
        
        //adds attachment from remote website
        //Attachment oAttachment = oMail.AddAttachment( "http://www.adminsystem.com/test.gif" );
        
        //changes attachment name to another name
        //oAttachment.Name = "mytest.gif";
        
        //specifies the attachment as an embedded picture
        //string contentID = "test001@host";
        //oAttachment.ContentID = contentID;
        //oMail.HtmlBody = "<html><body>this is a <img src=\"cid:" + contentID + "\"> embedded picture.</body></html>";
        
        //save as an eml file, you can use outlook express to open and check it.
        oMail.SaveAs( "c:\\test.eml", true );   
    }
    catch( System.Exception exp )
    {
        MessageBox.Show( exp.Message );           
    }
}

[C++ - Email Attachment]
using namespace System;
using namespace System::Collections;
using namespace EASendMail; 

System::Void AttachFile()
{
    try
    {
        SmtpMail ^oMail = gcnew SmtpMail("TryIt");
        Attachment ^oAttachment = oMail->AddAttachment( "c:\\test.gif" );
        
        //adds attachment from remote website
        //Attachment ^oAttachment = oMail->AddAttachment( "http://www.adminsystem.com/test.gif" );
        
        //changes attachment name to another name
        //oAttachment->Name = "mytest.gif";
        
        //specifies the attachment as an embedded picture
        //String^ contentID = "test001@host";
        //oAttachment->ContentID = contentID;
        //oMail->HtmlBody = String::Format( "<html><body>this is a <img src=\"cid:{0}\"> embedded picture.</body></html>",
            contentID );
        
        //save as an eml file, you can use outlook express to open and check it.
        oMail->SaveAs( "c:\\test.eml", true );
    }
    catch( System::Exception ^exp )
    {
        MessageBox::Show( exp->Message );            
    }
}

[JScript - Email Attachment]
public function AttachFile()
{  
    try
    {   
        var oMail:SmtpMail =  new SmtpMail("TryIt");
         Attachment oAttachment = oMail.AddAttachment( "c:\\test.gif" );
        
        //adds attachment from remote website 
        //Attachment oAttachment = oMail.AddAttachment( "http://www.adminsystem.com/test.gif" );
        
        //changes attachment name to another name
        //oAttachment.Name = "mytest.gif";
        
        //specifies the attachment as an embedded picture
        //var contentID : String = "test001@host";
        //oAttachment.ContentID = contentID;
        //oMail.HtmlBody = "<html><body>this is a <img src=\"cid:" + contentID + "\"> embedded picture.</body></html>";
        
        //save as an eml file, you can use outlook express to open and check it.
        oMail.SaveAs( "c:\\test.eml" );        
    }
    catch( exp:System.Exception )
    {
        MesageBox.Show( exp.Message );           
    }   
    
}

See Also

SmtpMail.AddAttachment Method
SmtpMail.ImportHtmlBody Method
SmtpMail.ImportHtml Method

Online Examples

C# - Send Email with Attachment
C# - Send HTML Email with Embedded Images
VB - Send Email with Attachment
VB - Send HTML Email with Embedded Images
C++/CLI - Send Email with Attachment
C++/CLI - Send HTML Email with Embedded Images