Skip to content
master
Switch branches/tags
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
src
 
 
 
 
 
 
 
 
 
 

readme.md

MinimalSendGrid

Minimal implementation of the SendGrid HTTP v3 API to send emails, compatible with .NET Platform Standard 1.0.

How to build

You can open the MinimalSendGrid.sln file in the root directory with Visual Studio 2015 Community Edition, and build directly from Visual Studio.

You can also build it with the command line, from the root directory:

dotnet restore
cd src\MinimalSendGrid
dotnet build

and optionally build the tester application:

cd ..\MinimalSendGrid.Tester
dotnet build

How to use

The very fist thing to do is to add a reference to MinimalSendGrid to your project, then add a using statement in your code.

using MinimalSendGrid;

Use the MessageBuilder class to create a message.

Message message = new MessageBuilder()
    .SetFrom("you@domain.ext")
    .AddTo("alice@another.domain.ext")
    .AddCc(new MessageEndPoint("bob", "bob@domain.ext"), "charly@domain.ext")
    .SetSubject("test subject")
    .AddBody("plain text test body")
    .Build();

Then instance an IMessageSender object, and send your message.

var sender = new HttpV3MessageSender("<YOUR_API_KEY_HERE>");
MessageSenderResult result = await sender.Send(message);
Console.WriteLine(result);

That's it, enjoy!

Remarks

In version 1.1.0 the API changed, causing a breaking change compared to version 1.0.1 and and lower. The MessageBuilder.SetBody method has been renamed to MessageBuilder.AddBody, since it is now possible to add several bodies, such as plain text and/or HTML.

The HttpV3MessageSender class is stateless, meaning that you can call the Send method several times in a row before awaiting for responses, however the Send method is not thread-safe. So, in multi-threading scenario, since you cannot lock around an await statement, it is better to instance a HttpV3MessageSender object per thread.

About

Minimal implementation of the SendGrid HTTP v3 API to send emails, compatible with .NET Standard 1.0

Resources

License

Releases

No releases published

Packages

No packages published

Languages