https://github.com/iowacomputergurus/netcore.utilities.email

Email utility methods for processing messages, used by both the ICG SMTP & SendGrid utilities
https://github.com/iowacomputergurus/netcore.utilities.email

Last synced: 6 months ago
JSON representation

Email utility methods for processing messages, used by both the ICG SMTP & SendGrid utilities

• Host: GitHub
• URL: https://github.com/iowacomputergurus/netcore.utilities.email
• Owner: IowaComputerGurus
• License: mit
• Created: 2021-02-08T01:28:55.000Z (almost 5 years ago)
• Default Branch: develop
• Last Pushed: 2025-07-07T04:51:47.000Z (7 months ago)
• Last Synced: 2025-07-07T05:37:30.146Z (7 months ago)
• Language: C#
• Size: 178 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

          
# NetCore.Utilities.Email ![](https://img.shields.io/github/license/iowacomputergurus/netcore.utilities.email.svg)

![Build Status](https://github.com/IowaComputerGurus/netcore.utilities.email/actions/workflows/ci-build.yml/badge.svg)

![](https://img.shields.io/nuget/v/icg.netcore.utilities.email.svg) ![](https://img.shields.io/nuget/dt/icg.netcore.utilities.email.svg)

This is a base library to provide utilities for working with email in .NET 6.  This project is used by more concrete implementations such as NetCore.Utilities.Email.Smtp.

## Breaking Changes (Version 7.0)

Starting with version 7.0, all `IEmailService` methods have been converted to asynchronous operations.

## Installation

Standard installation via NuGet Package Manager

``` powershell

Install-Package ICG.NetCore.Utilities.Email

```

However, it should be noted this is typically added by association from other packages

## Setup

To setup the needed dependency injection items for this library, add the following line in your DI setup.

``` csharp

services.UseIcgNetCoreUtilitiesEmail();

```

You can then configure email templates inside of your applications configuration file.

``` json

{

  "EmailTemplateSettings": {

    "DefaultTemplatePath": "Template.html",

    "AdditionalTemplates": { "SpecialTemplate": "File.html" }

  }

}

```

You may configure as many additional templates as desired.  All paths are relative to the ContentRoot as identified in the IHostingEnvironment value for the currently running application.

## Usage

Inline code documentation is included for usage within the application.

## Template Tokens

The following tokens are utilized in the templating process

* \[SUBJECT\]

* \[PREVIEW\]

* \[CONTENT\]

## Related Projects

ICG has a number of other related projects as well

* [AspNetCore.Utilities](https://www.github.com/iowacomputergurus/aspnetcore.utilities)

* [NetCore.Utilities.Email.Smtp](https://www.github.com/iowacomputergurus/netcore.utilities.email.smtp)

* [NetCore.Utilities.Spreadsheet](https://www.github.com/iowacomputergurus/netcore.utilities.spreadsheet)

* [NetCore.Utilities.UnitTesting](https://www.github.com/iowacomputergurus/netcore.utilities.unittesting)