Vytváření a nastavení obsahu e‑mailů

Vytvořit novou e‑mailovou zprávu

Třída MailMessage představuje e‑mailovou zprávu a umožňuje vývojářům vytvářet nové e‑mailové zprávy. Základní vlastnosti e‑mailu jako From, To, Subject a body lze snadno nastavit u nově vytvořené zprávy. Podobně lze zprávu uložit do různých formátů, jako jsou EML, MSG a MHTML.

• Vytvořte instanci třídy MailMessage.
• Nastavte vlastnosti e‑mailové zprávy.
• Uložte e‑mailovou zprávu v různých formátech.

Níže uvedený úryvek kódu ukazuje, jak vytvořit nový e‑mail s různými vlastnostmi.

Specifikace více příjemců

MailMessage představuje e‑mailovou zprávu. Instance třídy MailMessage se používají k vytvoření e‑mailových zpráv, které jsou přenášeny na SMTP server pomocí třídy SmtpClient. Toto téma ukazuje, jak zadat více e‑mailových adres. E‑mailové adresy lze zadat pomocí třídy MailMessage. E‑mailové adresy používané v třídě MailMessage jsou:

• To – Adresy příjemců lze zadat v poli ‘To’. Příjemci v poli ‘To’ jsou hlavní publikum zprávy. Může být zadáno více než jedna adresa příjemce.
• Cc – CC (carbon copy, neboli "zdvořilá kopie") vám umožňuje přidat e‑mailové příjemce, kteří potřebují e‑mail vidět, ale nemusí na něj nutně reagovat. Například manažeři nebo členové vašeho týmu, kteří potřebují být informováni o konverzaci. S Aspose.Email lze CC adresy zadat v kódu. Tím lze automatické e‑maily nebo všechny e‑maily na konkrétní adresu kopírovat relevantním osobám.
• Bcc – Bcc (blind carbon copy) vám umožňuje poslat e‑mail příjemci, který je skrytý před ostatními příjemci. Zatímco CC se zobrazí v informacích o e‑mailu, které vidí hlavní příjemci, Bcc se nezobrazí. Slouží k skryté notifikaci. 

Pro specifikaci více e‑mailových adres v e‑mailové zprávě postupujte takto:

1. Vytvořte instanci třídy MailMessage.
2. Zadejte pole From a více adres pro To, Cc a Bcc pomocí instance MailMessage.
3. Vytvořte instanci třídy SmtpClient a odešlete e‑mail pomocí metody Send.

Níže uvedený ukázkový kód ukazuje, jak lze specifikovat více adres pro To, CC a BCC.

Změna e‑mailových adres na přátelské jméno

Následující programové příklady ukazují, jak změnit e‑mailové adresy na přátelské názvy v e‑mailové zprávě. Přátelský název je název, který je pro člověka srozumitelnější než e‑mailová adresa, např. John Smith místo [e-mail]. Při odesílání e‑mailu můžeme přidružit přátelský název k e‑mailové adrese v konstruktoru třídy MailMessage.

Pro změnu e‑mailových adres na přátelská jména v e‑mailové zprávě postupujte takto:

• Vytvořte instanci třídy MailMessage a zadejte e‑mailové adresy v polích To a From spolu s přátelskými jmény.
• Zadejte e‑mailové adresy Cc a Bcc spolu s přátelskými jmény voláním konstruktoru třídy MailMessage v instanci MailMessage.
• Vytvořte instanci třídy SmtpClient a odešlete e‑mail pomocí metody Send.

Následující úryvek kódu ukazuje, jak zobrazit jména pro e‑mailové adresy.

Nastavit tělo e‑mailu

Třída MailMessage představuje e‑mailovou zprávu. Instance třídy MailMessage se používají k vytvoření e‑mailových zpráv, které jsou přenášeny na SMTP server pro doručení pomocí třídy SmtpClient. Tělo e‑mailu lze specifikovat pomocí třídy MailMessage. E‑mail může mít více těles. Ve třídě MailMessage existují dva typy těles e‑mailu:

• HTML tělo
• Textové tělo

Kromě HtmlBody a TextBody má Aspose.Email ještě dvě další jen pro čtení vlastnosti související s tělem e‑mailu:

• IsBodyText: informuje uživatele, zda je tělo textové.
• IsBodyHtml: informuje uživatele, zda je tělo HTML nebo prostý text.

Tento článek ukazuje, jak definovat prostý text nebo HTML text těla, nastavit alternativní text a zakódovat tělo e‑mailu.

Nastavení HTML těla

HtmlBody se používá k určení HTML obsahu těla zprávy. HtmlBody musí být uzavřeno mezi značkami . Následující úryvek kódu vám ukazuje, jak nastavit HTML tělo.

Nastavení alternativního textu

Použijte třídu AlternateView k určení kopií e‑mailové zprávy v různých formátech. Například pokud odesíláte zprávu v HTML, můžete také poskytnout verzi v prostém textu pro příjemce, kteří používají čtečky e‑mailů, jež neumí zobrazovat HTML obsah. Tato třída má dvě vlastnosti, LinkedResources a BaseUri, které slouží k řešení URL uvnitř obsahu e‑mailu.

• LinkedResources je kolekce objektů LinkedResources. Při vykreslování jsou URL adresy v obsahu e‑mailu nejprve porovnány s URL v Content Link každého objektu LinkedResources v kolekci LinkedResources a vyřešeny.
• BaseUri používá čtečka e‑mailů k řešení relativních URL v těle zprávy a také k řešení relativních URL v Content Link ve sbírce LinkedResources.

Následující úrynek kódu ukazuje, jak nastavit alternativní text.

Vlastnosti MailMessage

The MailMessage třída představuje obsah e‑mailové zprávy. Instance třídy MailMessage třída se používá k vytvoření e‑mailové zprávy, která je odeslána na SMTP server k doručení pomocí SmtpClient třída. Tento článek ukazuje, jak použít MailMessage třída obsahuje užitečné funkce pro řízení následujících vlastností e‑mailu:

• Datum a čas – prostřednictvím MailMessage Vlastnost třídy Date získává nebo nastavuje datum a čas e‑mailu.
• Priorita zprávy –  MailPriority třída určuje úrovně priority pro odeslání e‑mailové zprávy. Může být nízká, normální nebo vysoká. Priorita ovlivňuje rychlost přenosu a doručení.
• Citlivost zprávy –  MailSensitivity třída určuje pět úrovní citlivosti.
• Oznámení o doručení – Oznámení o doručení informují odesílatele, že odeslaný e‑mail byl doručen do schránek příjemce.

Ve výchozím nastavení je datum skutečným datem, kdy byla zpráva odeslána, a čas je čas, kdy byla odeslána, jak zobrazuje Microsoft Outlook. Skutečný čas doručení e‑mailu však přidává samotný SMTP server v hlavičce zprávy. Například níže je běžná hlavička e‑mailu, kde pole Date nastavuje datum.

Níže uvedený úryvek kódu ilustruje, jak lze každou z výše popsaných funkcí použít.

Požadování doručenky

Níže uvedené programové ukázky ukazují, jak můžete požádat o potvrzení přečtení. MailMessage třída DeliveryNotificationOptions Vlastnost výčtu popisuje možnosti oznámení o doručení e‑mailu. Pro požádání o potvrzení přečtení po odeslání e‑mailu postupujte následovně:

1. Vytvořte instanci MailMessage třída.
2. Zadejte odesílatele, příjemce a HTML tělo e‑mailu v MailMessage instance.
3. Určete DeliveryNotificationOptions v jiných MailMessage instance.
4. Vytvořte instanci SmtpClient třída a odešlete e‑mail pomocí metody Send.

Požadavky na potvrzení přečtení nemusí být vždy vyhověny, protože:

• Poštovní klient nemusí tuto funkci implementovat.
• Koncový uživatel může mít tuto funkci vypnutou.
• Koncový uživatel se může rozhodnout jej neodeslat.

Následující úryvek kódu ukazuje, jak požádat o potvrzení přečtení.

Nastavení e‑mailových hlaviček

Hlavičky e‑mailu představují internetový standard a RFC definuje pole hlaviček, která jsou součástí internetových e‑mailových zpráv. Hlavičku e‑mailu lze specifikovat pomocí třídy MailMessage. Běžné typy hlaviček jsou definovány ve třídě HeaderType. Jedná se o finalní třídu fungující jako běžná enumerace.

Obvykle hlavička e‑mailu obsahuje následující pole:

• To: Adresy příjemců lze zadat do pole To. Příjemci v poli To jsou hlavní publikum zprávy. Může být uvedeno více než jedna adresa příjemce.
• From: Toto pole uvádí e‑mailovou adresu odesílatele zprávy.
• Cc: Umožňuje uživatelům poslat zprávu jako „Carbon Copy“ či „Courtesy Copy“. Příjemce není očekáván k odpovědi nebo akci. Obvykle jsou informováni nadřízení pomocí CC.
• Bcc: Zkratka pro Blind Carbon Copy, označuje praxi odesílání zprávy více příjemcům tak, že příjemci nevidí kompletní seznam ostatních příjemců. Slouží k skrytému oznámení.
• ReplyTo: Toto pole hlavičky určuje, kam má odesílatel směřovat odpovědi.
• Subject: Název, titulek, předmět. Často se používá jako indikátor vlákna pro zprávy odpovídající nebo komentující jiné zprávy.
• Date: Tato hlavička určuje datum (a čas). Obvykle se jedná o datum, kdy byla zpráva vytvořena a odeslána.
• XMailer: Informace o klientském softwaru odesílatele. Příklad: X-Mailer: Aspose.Email. XMailer je používán e‑mailovými klienty. Různí klienti mají různé hodnoty XMailer. Hodnota XMailer v MS Outlook je Microsoft Office Outlook, Build 11.0.5510. Příjemce nebo čtečka e‑mailu tuto hodnotu ignoruje.

Obvykle vypadá hlavička e‑mailu takto:

 Reply-To: [e-mail]

From: [e-mail]

To: [e-mail]

Subject: test mail

Date: 6 Mar 2006 8:2:2 +0800

X-Mailer: Aspose.Email

Pro úpravu hlavičky e‑mailu postupujte podle následujících kroků:

• Vytvořte instanci MailMessage třída.
• Zadejte To, From, CC, Bcc, ReplyTo, Subject, Date a XMailer pomocí instance MailMessage.
• Vytvořte instanci MimeHeader třídu a specifikujte tajnou hlavičku.
• Přidejte tajnou hlavičku do MailMessage instance.

Níže uvedený úryvek kódu ukazuje, jak nastavit hlavičky e‑mailu.

Výše uvedený úryvek kódu vytvoří hlavičku e‑mailu v následujícím formátu. To lze pozorovat otevřením výsledného souboru "MsgHeaders.msg" v Microsoft Outlook a následným zobrazením Vlastností.

 Reply-To: [e-mail]

From: [e-mail]

To: [e-mail]

CC: [e-mail]

BCC: [e-mail]

Subject: test mail

Date: 6 Mar 2006 8:2:2 +0800

X-Mailer: Aspose.Email

secret-header: mystery

Vložení hlavičky na konkrétní místo

The Add metoda HeadersCollection třída vloží hlavičku na konec kolekce. Někdy však může být nutné vložit hlavičku na konkrétní místo. V takovém případě Add metoda nebude užitečná. Pro dosažení tohoto použijte Insert metoda třídy HeadersCollection. Pokud kolekce obsahuje hlavičky se stejným názvem, tato hlavička bude vložena před ostatní hlavičky se stejným názvem. Následující úryvek kódu vám ukazuje, jak vložit hlavičku na konkrétní místo.

Přidávání vlastních hlaviček do e‑mailu

Následující programové příklady ukazují, jak specifikovat vlastní hlavičku v e‑mailové zprávě. E‑mailovou hlavičku lze zadat pomocí MailMessage třídy. Pro zadání vlastní hlavičky v e‑mailové zprávě postupujte podle těchto kroků:

1. Vytvořte instanci MailMessage třída.
2. Určete hodnoty to, from a subject pomocí instance MailMessage.
3. Přidejte tajnou hlavičku do MailMessage instance.
4. Vytvořte instanci třídy SmtpClient a odešlete e‑mail pomocí metody Send.

Následující úryvek kódu ukazuje, jak přidat vlastní hlavičky do e‑mailu.