MailMessage.LoadMessage Method (Byte[])

MailMessageLoadMessage Method (Byte)

Loads the message from a byte array.

Namespace: MailBee.Mime
Assembly: MailBee.NET (in MailBee.NET.dll) Version: 12.5.0 build 687 for .NET 4.5

Syntax

public bool LoadMessage(
	byte[] rawData
)

Public Function LoadMessage ( 
	rawData As Byte()
) As Boolean

Parameters

rawData: Type: SystemByte
The byte array containing the MIME source of the message.

Return Value

Type: Boolean
true if the message was successfully loaded; otherwise, false.

Exceptions

Exception	Condition
MailBeeInvalidArgumentException	rawData is a null reference (Nothing in Visual Basic).
MailBeeDataParsingException	Outlook .MSG file is being loaded instead of MIME (.EML) and ThrowExceptions is true.

Remarks

The MIME source of the message is the contents of .EML file (which you can import with LoadMessage(String) method).

To get an existing message as a byte array, use GetMessageRawData method.

Note
This method can change the contents of the source byte array. This may only occur in extremely rare case when line endings in there are single CR characters rather than CRLF pairs (correct endings) or single LF characters (incorrect but widely used). In this case, MailBee normalizes the data by replacing single CRs with LFs (not changing the length of the array). If for some reason you want to preserve the source data intact, make a copy of the source array before passing it to this method. To avoid unnecessary memory consumption, you can first check if the message data indeed contains CR line endings, and make a copy of the data only in this rare case.

Note

This method can change the contents of the source byte array. This may only occur in extremely rare case when line endings in there are single CR characters rather than CRLF pairs (correct endings) or single LF characters (incorrect but widely used). In this case, MailBee normalizes the data by replacing single CRs with LFs (not changing the length of the array). If for some reason you want to preserve the source data intact, make a copy of the source array before passing it to this method. To avoid unnecessary memory consumption, you can first check if the message data indeed contains CR line endings, and make a copy of the data only in this rare case.

Examples

This sample loads the message from a byte array and displays the subject of the message. Reading from a stream is used for demonstration purposes only. In real-world apps, it's easier to use LoadMessage(String) method to load a message from a file.

Copy

// 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).
byte[] msgBytes = null;
using (BinaryReader br = new BinaryReader(File.OpenRead(@"C:\Docs\TestMail.eml")))
{
    FileInfo fi = new FileInfo(@"C:\Docs\TestMail.eml");
    msgBytes = br.ReadBytes((int)fi.Length);
}
MailMessage msg = new MailMessage();
msg.LoadMessage(msgBytes);
Console.WriteLine(msg.Subject);

' To use the code below, import these namespaces at the top of your code.
Imports System.IO
Imports MailBee
Imports MailBee.Mime

' The actual code (put it into a method of your class).
Dim msgBytes As Byte() = Nothing

Dim br As BinaryReader
Try
    br = New BinaryReader(File.OpenRead("C:\Docs\TestMail.eml"))
    Dim fi As New FileInfo("C:\Docs\TestMail.eml")
    msgBytes = br.ReadBytes(fi.Length)
Finally
    If Not br Is Nothing Then
        br.Close()
    End If
End Try

Dim msg As New MailMessage
msg.LoadMessage(msgBytes)
Console.WriteLine(msg.Subject)

Reference

MailMessage Class

LoadMessage Overload

MailBee.Mime Namespace

MailMessageGetMessageRawData