AttachmentCollection.Add Method (Stream, String, String, String, HeaderCollection, NewAttachmentOptions, MailTransferEncoding)

Adds the attachment from a stream.

public bool Add(
   Stream stream,
   string targetFilename,
   string contentID,
   string contentType,
   HeaderCollection customHeaders,
   NewAttachmentOptions options,
   MailTransferEncoding mailEnc
);

Parameters

stream: The data stream from which to read the binary content of the attachment.
targetFilename: The filename under which to add the attachment into the collection.
contentID: The content identifier (CID) of the attachment (for inline attachments), or empty string if the attachment is not inline.
contentType: The content type of the attachment, or a null reference (Nothing in Visual Basic) to let MailBee detect the content type automatically.
customHeaders: The collection of the headers which should be included into the header section in additon to the standard attachment headers. If a null reference (Nothing in Visual Basic), no custom headers will be added.
options: The options which affect how the attachment is added.
mailEnc: The mail encoding to use when placing the attachment data into the message.

Return Value

true if the attachment was successfully added to the collection; otherwise, false.

Remarks

The targetFilename parameter allows the developer to override the filename under which the attachment will be added to the collection. This is useful if the attachment is being added from a temporary file such as ETQB4914.TMP under meaningful name such as report.doc.

Exceptions

Exception Type	Condition
MailBeeInvalidArgumentException	stream or targetFilename is a null reference (Nothing in Visual Basic).
MailBeeStreamException	An error occurred and ThrowExceptions is true.

Example

This sample opens a file stream, reads the file into the stream, adds the attachment from the stream, and saves the message to disk.

Note In real-world apps, it's easier to use Add overload to add an attachment from a file.

[C#]
// To use the code below, import these namespaces at the top of your code.
using System.IO;
using MailBee;
using MailBee.Mime;

// The actual code (put it into a method of your class)

// Open the file as stream for reading.
using (FileStream fs = new FileStream(@"C:\Docs\1.gif", FileMode.Open))
{
    // Create new MailMessage object.
    MailMessage msg = new MailMessage();

    // Set plain text body of the message.
    msg.BodyPlainText = "Hello, World!";

    // Add the attachment to the message.
    msg.Attachments.Add(fs, "pic1.gif", "<12s4a8a8778c$5664i1b1$ir671781@tlffmdqjobxj>", "image/gif", null, NewAttachmentOptions.None, MailTransferEncoding.Base64);

    // Save message to disk.
    msg.SaveMessage(@"C:\SavedMessage.eml");
}