SmtpMail.AddAttachment Method


Attaches a file attachment to the email message.

[Visual Basic]
Public Sub AddAttachment( _
    fileName As String _
) As Attachment

Public Sub AddAttachment( _
    fileName As String, _
    content() As Byte _
) As Attachment
[C#]
public Attachment AddAttachment(
    string fileName
);

public Attachment AddAttachment(
    string fileName,
    byte[] content
);
[C++]
public: Attachment^ AddAttachment(
    String^ fileName
);

public: Attachment^ AddAttachment(
    String^ fileName,
    array<unsigned char>^ content,
);
[JScript]
public function AddAttachment( 
    fileName : String
) : Attachment;

public function AddAttachment( 
    fileName : String,
    content : Byte[]
) : Attachment;

Parameters

fileName
A full file name or URL.
content
The binary data of the file.

Return Value

The Attachment class instance.

Remarks

To attach embedded images or inline images, 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 Exception
        Console.WriteLine(exp.Message)
    End Try
End Sub


[C# - Email Attachment] using System; using System.Collections; using EASendMail; 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 (Exception ^exp) { Console::WriteLine(exp->Message); } }
[C++ - Email Attachment] using namespace System; using namespace System::Collections; using namespace EASendMail; 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 (Exception ^exp) { Console::WriteLine(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) { Console.WriteLine(exp.Message); } }

See Also

Attachment Class
SmtpMail.ImportHtmlBody Method
SmtpMail.ImportHtml Method

Online Examples

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