blob: f55eadd2fb4ce6de9add4c8067089b97cbecb3c4 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
|
using System;
using System.Collections.Generic;
using System.Linq;
using System.Net.Mail;
using System.Text;
namespace SendGridMail
{
/// <summary>
/// Represents the additional functionality to add SendGrid specific mail headers
/// </summary>
public interface IHeader
{
/// <summary>
/// This adds a substitution value to be used during the mail merge. Substitutions
/// will happen in order added, so calls to this should match calls to addTo in the mail message.
/// </summary>
/// <param name="tag">string to be replaced in the message</param>
/// <param name="substitutions">substitutions to be made, one per recipient</param>
void AddSubVal(String tag, IEnumerable<String> substitutions);
/// <summary>
/// This adds parameters and values that will be bassed back through SendGrid's
/// Event API if an event notification is triggered by this email.
/// </summary>
/// <param name="identifiers">parameter value pairs to be passed back on event notification</param>
void AddUniqueIdentifier(IDictionary<String, String> identifiers);
/// <summary>
/// This sets the category for this email. Statistics are stored on a per category
/// basis, so this can be useful for tracking on a per group basis.
/// </summary>
/// <param name="category">categories applied to the message</param>
void SetCategory(String category);
/// <summary>
/// Shortcut method for enabling a filter.
/// </summary>
/// <param name="filter">The name of the filter to enable</param>
void Enable(String filter);
/// <summary>
/// Shortcut method for disabling a filter.
/// </summary>
/// <param name="filter">The name of the filter to disable</param>
void Disable(String filter);
/// <summary>
/// Allows you to specify a filter setting. You can find a list of filters and settings here:
/// http://docs.sendgrid.com/documentation/api/web-api/filtersettings/
/// </summary>
/// <param name="filter">The name of the filter to set</param>
/// <param name="settings">The multipart name of the parameter being set</param>
/// <param name="value">The value that the settings name will be assigning</param>
void AddFilterSetting(String filter, IEnumerable<String> settings, String value);
/// <summary>
/// Attaches the SendGrid headers to the MIME.
/// </summary>
/// <param name="mime">the MIME to which we are attaching</param>
void AddHeader(MailMessage mime);
/// <summary>
/// Converts the filter settings into a JSON string.
/// </summary>
/// <returns>String representation of the SendGrid headers</returns>
String AsJson();
}
}
|
