iPdfWriter.Mail 1.0.1

What is iPdfWriter.Mail?

iPdfWriter.Mail, extends iPdfWriter, contains extension methods to send by mail PdfInput instances as well as OutputResult.

I hope it helps someone. 😏

Usage

Samples

Sample 1 - Shows the use of synchronous mail by SendMail action

var doc = new PdfInput
{
    AutoUpdateChanges = true,
    Input = "~/Resources/Sample-01/file-sample.pdf"
};

// report title
doc.Replace(new ReplaceText(
    new WithTextObject
    {
        Text = "#TITLE#",
        NewText = "Lorem ipsum",
        Offset = PointF.Empty,
        Style = StylesHelper.Sample01.TextStylesTable["ReportTitle"],
        ReplaceOptions = ReplaceTextOptions.AccordingToMargins
    }))
    // bar-chart image
    .Replace(new ReplaceText(
        new WithImageObject
        {
            Text = "#BAR-CHART#",
            Offset = PointF.Empty,
            Style = StylesHelper.Sample01.ImagesStylesTable["Default"],
            ReplaceOptions = ReplaceTextOptions.Default,
            Image = PdfImage.FromFile("~Resources/Sample-01/Images/bar-chart.png")
        }))
    // image
    .Replace(new ReplaceText(
        new WithImageObject
        {
            Text = "#IMAGE1#",
            Offset = PointF.Empty,
            Style = StylesHelper.Sample01.ImagesStylesTable["Center"],
            ReplaceOptions = ReplaceTextOptions.AccordingToMargins,
            Image = PdfImage.FromFile("~/Resources/Sample-01/Images/image-1.jpg")
        }));

var pdfCreationResult = doc.CreateResult();
if (!pdfCreationResult.Success)
{
    return;
}

var sendResult = pdfCreationResult.Result.Action(new SendMail
{
    FromAddress = " >> WRITE HERE EMAIL ADDRESS OF THE SENDER << ",
    FromDisplayName = " >> WRITE HERE THE NAME TO DISPLAY << ",
    AttachedFilename = "Sample-01", // OutputResult file name
    Settings = new SmtpMailSettings
    {
        Credential = new SmtpCredential
        {
            Port = 465,
            UseSsl = true,
            Host = SmtpMail.GmailSmtpHost, // YOU CAN ALSO USE: SmtpMail.MailtrapSmtpHost OR SmtpMail.EtherealSmtpHost, for more information, please see Sample02 and Sample03 
            Email = " >> WRITE HERE YOUR EMAIL << ",
            UserName = " >> WRITE HERE YOUR USERNAME << ",
            Password = " >> WRITE HERE YOUR PASSWORD << "
        },
        Templates = new TemplateSettings
        {
            IsBodyHtml = true,
            BodyTemplate = "Hey!!!",
            SubjectTemplate = "test pdf file"
        },
        Recipients = new RecipientsSettings
        {
            ToAddresses = new[] { " >> WRITE HERE EMAIL ADDRESS OF THE RECIPIENT << " }
        },
        Attachments = new[]
        {
            "~/Resources/Sample-01/Images/bar-chart.png",
            "~/Resources/Sample-01/Images/image-1.jpg"
        }
    }
});

if (!sendResult.Success)
{
    // Handle error(s)
}

Sample 2 - Shows the use of asynchronous mail by SendMailAsync action

var doc = new PdfInput
{
    AutoUpdateChanges = true,
    Input = "~/Resources/Sample-01/file-sample.pdf"
};

// report title
doc.Replace(new ReplaceText(
    new WithTextObject
    {
        Text = "#TITLE#",
        NewText = "Lorem ipsum",
        Offset = PointF.Empty,
        Style = StylesHelper.Sample01.TextStylesTable["ReportTitle"],
        ReplaceOptions = ReplaceTextOptions.AccordingToMargins
    }))
    // bar-chart image
    .Replace(new ReplaceText(
        new WithImageObject
        {
            Text = "#BAR-CHART#",
            Offset = PointF.Empty,
            Style = StylesHelper.Sample01.ImagesStylesTable["Default"],
            ReplaceOptions = ReplaceTextOptions.Default,
            Image = PdfImage.FromFile("~Resources/Sample-01/Images/bar-chart.png")
        }))
    // image
    .Replace(new ReplaceText(
        new WithImageObject
        {
            Text = "#IMAGE1#",
            Offset = PointF.Empty,
            Style = StylesHelper.Sample01.ImagesStylesTable["Center"],
            ReplaceOptions = ReplaceTextOptions.AccordingToMargins,
            Image = PdfImage.FromFile("~/Resources/Sample-01/Images/image-1.jpg")
        }));

var pdfCreationResult = await doc.CreateResultAsync();
if (!pdfCreationResult.Success)
{
    return;
}

var sendResult = await pdfCreationResult.Result.Action(new SendMailAsync
{
    FromAddress = " >> WRITE HERE EMAIL ADDRESS OF THE SENDER << ",
    FromDisplayName = " >> WRITE HERE THE NAME TO DISPLAY << ",
    AttachedFilename = "Sample-01", // OutputResult file name
    Settings = new SmtpMailSettings
    {
        Credential = new SmtpCredential
        {
            Port = 465,
            UseSsl = true,
            Host = SmtpMail.GmailSmtpHost, // YOU CAN ALSO USE: SmtpMail.MailtrapSmtpHost OR SmtpMail.EtherealSmtpHost, for more information, please see Sample02 and Sample03 
            Email = " >> WRITE HERE YOUR EMAIL << ",
            UserName = " >> WRITE HERE YOUR USERNAME << ",
            Password = " >> WRITE HERE YOUR PASSWORD << "
        },
        Templates = new TemplateSettings
        {
            IsBodyHtml = true,
            BodyTemplate = "Hey!!!",
            SubjectTemplate = "test pdf file"
        },
        Recipients = new RecipientsSettings
        {
            ToAddresses = new[] { " >> WRITE HERE EMAIL ADDRESS OF THE RECIPIENT << " }
        },
        Attachments = new[]
        {
            "~/Resources/Sample-01/Images/bar-chart.png",
            "~/Resources/Sample-01/Images/image-1.jpg"
        }
    }
});

if (!sendResult.Success)
{
    // Handle error(s)
}

Documentation

• Please see next link documentation.

Changes

For more information, please visit the next link CHANGELOG