Message operations

// create Graph client instance, connect, log in
// ...

// get top page of messages from 'Inbox'
GraphMessageCollection messages = client.GetMessageList(GraphFolderId.Inbox);

// show info about them
foreach (GraphMessageInfo info in messages)
{
    Console.WriteLine("From: {0}", info.From);
    Console.WriteLine("To: {0}", info.To);
    Console.WriteLine("Subject: {0}", info.Subject);
}

// create Graph client instance, connect, log in
// ...

// list all messages in 'Inbox' using paging functionality
int offset = 0;
int pageSize = 1000;
while (true)
{
    // get next page
    GraphMessageCollection messages = client.GetMessageList(
        GraphFolderId.Inbox,
        new GraphPageView(offset, pageSize));

    // show info about messages
    foreach (GraphMessageInfo m in messages)
    {
        Console.WriteLine("[{0}] ({1}) {2}", m.ReceivedDate, m.From, m.Subject);
    }

    // break if there are no more messages
    if (messages.Count == 0)
        break;

    // set next offset
    offset += messages.Count;
}

// final offset corresponds to total number of messages listed
Console.WriteLine("Total messages: {0}", offset);

// create Graph client instance, connect, log in
// ...

// construct message ID
GraphMessageId id = new GraphMessageId(messageIdString);

// retrieve envelope of the message
GraphMessageInfo message = client.GetMessageInfo(id, GraphMessageFields.Envelope);

// show some info about the message
Console.WriteLine("Subject: {0}", message.Subject);
Console.WriteLine("From: {0}", message.From);
Console.WriteLine("To: {0}", message.To);

// create Graph client instance, connect, log in
// ...

// get a message
MailMessage message = client.GetMailMessage(messageId);

// show some info about the message
Console.WriteLine("Subject: {0}", message.Subject);
Console.WriteLine("From: {0}", message.From);
Console.WriteLine("To: {0}", message.To);
foreach (Attachment item in message.Attachments)
{
    Console.WriteLine(" * {0} <{1}>", item.DisplayName, item.ContentType);
}

// create Graph client instance, connect, log in
// ...

// download a message to a file in MIME format
client.GetMessage(messageId, @"C:\data\message.eml");

// create Graph client instance, connect, log in
// ...

using (Stream writer = File.Create(@"C:\data\message.eml"))
{
    // download a message to a stream in MIME format
    client.GetMessage(messageId, writer);
}

// create Graph client instance, connect, log in
// ...

// load a mail message
MailMessage mail = new MailMessage();
mail.Load(@"C:\data\message.eml");

// upload the mail to 'Drafts' folder
GraphMessageInfo message = client.StoreMessage(GraphFolderId.Drafts, mail);

// keep its ID for later use if needed
var messageId = message.Id;

// create Graph client instance, connect, log in
// ...

// prepare updates of a message
var updateSet = new GraphMessageData();
updateSet.Flag = GraphFlag.CreateFlagged(
    startDateTime: DateTime.Today,
    dueDateTime: DateTime.Today.AddDays(1));
updateSet.Categories = new GraphCategoryCollection("Project A", "Project B");
updateSet.Subject = "Updated subject";
updateSet.SetBodyHtml("Updated <b>body</b>.");
updateSet.Importance = GraphImportance.High;
updateSet.IsRead = false;

// apply updates
client.UpdateMessage(messageId, updateSet);

// create Graph client instance, connect, log in
// ...

DateTime yesterday = DateTime.Today.AddDays(-1);

// find top page of messages that arrived to 'Inbox' yesterday
var items = client.Search(GraphFolderId.Inbox,
                          GraphMessageSearchParameter.Arrived(yesterday));

// move all of them to 'Archive' folder
foreach (GraphMessageInfo item in items)
{
    client.MoveMessage(item.Id, GraphFolderId.Archive);
}

// create Graph client instance, connect, log in
// ...

// hard-delete desired message (do not move it to 'Deletions' folder)
client.DeleteMessage(messageId, permanent: true);

// create Graph client instance, connect, log in
// ...

// prepare attachment metadata
var meta = new GraphAddAttachmentOptions()
{
    Name = "image.jpg",
    ContentType = MediaTypeNames.Image.Jpeg
};

// add an attachment to the existing message
var attInfo = client.AddAttachment(messageId, @"C:\data\image.jpg", meta);

// show some info about the attachment
Console.WriteLine("Added attachment {0} ({1}B).", attInfo.Name, attInfo.Size);

// get info about message attachments
var info = client.GetMessageInfo(messageId, GraphMessageFields.AttachmentInfo);

// iterate through all message attachments
foreach (var att in info.Attachments)
{
    // filter image attachments
    if (att.ContentType.StartsWith("image/", StringComparison.OrdinalIgnoreCase))
    {
        // download it
        var attachment = client.GetAttachment(att.Id);

        // save it
        attachment.Save(@"C:\data\images\" + attachment.FileName);
    }
}

// get Envelope info of a message with desired Exchange ID (graphMessageId)
var message = client.GetMessageInfo(graphMessageId, GraphMessageFields.Envelope);

// read Message-ID (MIME header) from the message info
var mimeMessageId = message.MessageId;

// search for messages with desired Message-ID MIME header
// the header is represented by 'internetMessageId' in Microsoft Graph API
// specify null folder to search anywhere in the mailbox
var messages = client.Search(folderId: null, new GraphMessageSearchQuery()
{
    Fields = GraphMessageFields.Id,
    RawFilter = $"internetMessageId eq '{mimeMessageId}'"
});

Console.WriteLine("Messages with Message-ID '{0}':", mimeMessageId);
foreach (GraphMessageInfo info in messages)
{
    Console.WriteLine(info.Id);
}

// create Graph client instance, connect, log in
// ...

// prepare options
GraphMessageInfoOptions options = new GraphMessageInfoOptions
{
    // request basic info and body
    Fields = GraphMessageFields.Envelope | GraphMessageFields.Body,

    // request HTML body
    PreferredBodyType = GraphBodyContentType.Html
};

// get the message info from the server
GraphMessageInfo messageInfo = client.GetMessageInfo(messageId, options);

// show preview of the message body (it has a value regardless PreferredBodyType)
Console.WriteLine("Body preview: {0}", messageInfo.BodyPreview);

// you can rely on BodyHtml having a value
Console.WriteLine("HTML body: {0}", messageInfo.BodyHtml);

// BodyText will be null in this case
//Console.WriteLine("Text body: {0}", messageInfo.BodyText);

// create Graph client instance, connect, log in
// ...

// get message envelope and attachment info
GraphMessageInfo message = client.GetMessageInfo(messageId,
    GraphMessageFields.Envelope | GraphMessageFields.AttachmentInfo);

// show some info about the message
Console.WriteLine("Subject: {0}", message.Subject);
Console.WriteLine("From: {0}", message.From);
Console.WriteLine("To: {0}", message.To);
if (message.HasAttachments)
{
    Console.WriteLine("Message has attachment(s).");
}