Skapa och ange innehåll i e‑postmeddelanden

Skapa nytt e‑postmeddelande

MailMessage‑klassen representerar ett e‑postmeddelande och låter utvecklare skapa nya e‑postmeddelanden. Grundläggande e‑postegenskaper som From, To, Subject och body kan enkelt bifogas till det nyskapade meddelandet. På samma sätt kan vi spara meddelandet i olika format som EML, MSG och MHTML.

• Skapa en instans av klassen MailMessage.
• Ställ in e‑postmeddelandets egenskaper.
• Spara e‑postmeddelandet i olika format.

Följande kodexempel visar hur du skapar ett nytt e‑postmeddelande med olika egenskaper.

Specificera flera mottagare

MailMessage representerar ett e‑postmeddelande. Instanser av MailMessage‑klassen används för att konstruera e‑postmeddelanden som överförs till en SMTP‑server med SmtpClient‑klassen. Detta avsnitt demonstrerar hur man specificerar mer än en e‑postadress. E‑postadresser kan specificeras med MailMessage‑klassen. De e‑postadresser som används i MailMessage‑klassen är:

• To – Mottagaradresser kan specificeras i ‘Till’-fältet. Mottagarna i ‘Till’-fältet är den primära målgruppen för meddelandet. Det kan finnas mer än en mottagaradress.
• Cc – CC står för "carbon copy" eller "courtesy copy" och låter dig lägga till e‑postmottagare som behöver se e‑posten men som inte nödvändigtvis förväntas agera på den. Chefer, till exempel, eller medlemmar i ditt team som behöver vara medvetna om en konversation. Med Aspose.Email kan CC‑adresser specificeras i din kod. På så sätt kan automatiserade e‑postmeddelanden, eller alla e‑post till en specifik adress, kopieras till relevant personal.
• Bcc – Bcc, blind carbon copy, låter dig skicka ett e‑postmeddelande till en mottagare som är dold för andra mottagare. Medan en CC visas i e‑postinformationen för huvudmottagarna, visas en Bcc inte. Det är avsett för dold avisering. 

För att specificera flera e‑postadresser i ett e‑postmeddelande, följ dessa steg:

1. Skapa en instans av klassen MailMessage.
2. Ange Från‑ och flera Till‑, Cc‑ och Bcc‑adresser med hjälp av MailMessage‑instansen.
3. Skapa en instans av klassen SmtpClient och skicka e‑posten med hjälp av Send‑metoden.

Kodexemplet nedan visar hur flera Till‑, CC‑ och BCC‑adresser kan specificeras.

Ändra e‑postadresser till ett vänligt namn

Programmeringsexemplen nedan visar hur man ändrar e‑postadresser till vänliga namn i ett e‑postmeddelande. Ett vänligt namn är ett namn som är mer mänskligt än e‑postadressen, till exempel John Smith istället för [e-mail]. När du skickar ett e‑postmeddelande kan vi associera ett vänligt namn med en e‑postadress i MailMessage‑klassens konstruktor.

För att ändra e‑postadresser till vänliga namn i ett e‑postmeddelande, följ dessa steg:

• Skapa en instans av MailMessage‑klassen och specificera e‑postadresser i Till‑ och Från‑fälten tillsammans med vänliga namn.
• Specificera Cc‑ och Bcc‑e‑postadresser tillsammans med vänliga namn genom att anropa MailMessage‑klassens konstruktor i MailMessage‑instansen.
• Skapa en instans av klassen SmtpClient och skicka e‑posten med hjälp av Send‑metoden.

Följande kodsnutt visar hur du visar namn för e‑postadresser.

Ange e‑postkropp

MailMessage‑klassen representerar ett e‑postmeddelande. Instanser av MailMessage‑klassen används för att konstruera e‑postmeddelanden som överförs till en SMTP‑server för leverans med SmtpClient‑klassen. Ett e‑post‑body kan specificeras med MailMessage‑klassen. Ett e‑postmeddelande kan ha flera bodies. Det finns två typer av e‑postbodies i MailMessage‑klassen:

• HTML‑kropp
• Textkropp

Förutom HtmlBody och TextBody har Aspose.Email ytterligare två skrivskyddade egenskaper relaterade till e‑postens body:

• IsBodyText: anger om body är text.
• IsBodyHtml: anger om body är HTML eller vanlig text.

Denna artikel visar hur man definierar klartext‑ eller HTML‑kroppstext, anger alternativ text och kodar e‑postkroppen.

Ange HTML‑kropp

HtmlBody används för att specificera HTML‑innehållet i ett meddelandes body. HtmlBody måste omges av -taggar. Följande kodsnutt visar hur du sätter HTML‑body.

Ange alternativ text

Använd AlternateView‑klassen för att specificera kopior av ett e‑postmeddelande i olika format. Till exempel, om du skickar ett meddelande i HTML kan du även vilja tillhandahålla en vanlig text‑version för mottagare som använder e‑postläsare som inte kan visa HTML‑innehåll. Denna klass har två egenskaper, LinkedResources och BaseUri, som används för att lösa URL:er inom e‑postens innehåll.

• LinkedResources är en samling av LinkedResources‑objekt. När de renderas matchas URL:er i e‑postens innehåll först mot URL:erna i Content Link för varje LinkedResources‑objekt i samlingen, och löses.
• BaseUri används av e‑postläsaren för att lösa relativa URL:er i kroppen, och även för att lösa relativa Content Link‑URL:er i samlingen LinkedResources.

Följande kodsnutt visar hur du anger alternativ text.

MailMessage‑funktioner

Den MailMessage klass representerar innehållet i ett e‑postmeddelande. Instanser av MailMessage klass används för att konstruera ett e‑postmeddelande som överförs till en SMTP‑server för leverans med hjälp av SmtpClient klass. Denna artikel visar hur man använder MailMessage klass nytta funktioner för att styra följande e‑postfunktioner:

• Date and time - Genom MailMessage klass Date‑egenskap vi får eller sätter ett e‑postmeddelandes datum och tid.
• Meddelandeprioritet – MailPriority klass specificerar prioriteringsnivåer för att skicka ett e‑postmeddelande. Den kan vara låg, normal eller hög. Prioritet påverkar överföringshastigheten och leveransen.
• Meddelandekänslighet – MailSensitivity klass specificerar fem nivåer av känslighet.
• Leveransavisering – Leveransaviseringar låter avsändaren veta att e‑postmeddelandet har levererats till mottagarens inkorg.

Som standard är datumet det faktiska datum då meddelandet skickades, och tiden är den tid det skickades, enligt Microsoft Outlook. Dock läggs den faktiska e‑postleveranstiden till av SMTP‑servern själv i e‑posthuvudet. Till exempel nedan ett vanligt e‑posthuvud, där Date sätts i fältet Date.

Kodsnutten nedan illustrerar hur var och en av funktionerna som diskuterats ovan kan användas.

Begära en mottagningsbekräftelse

Programmeringsexemplen nedan visar hur du kan begära ett läskvitto. Det MailMessage klass DeliveryNotificationOptions Enumerationsegenskapen beskriver leveransavisalternativen för ett e‑postmeddelande. För att begära ett läskvitto efter att ha skickat ett e‑postmeddelande, följ dessa steg:

1. Skapa en instans av MailMessage klass.
2. Ange avsändare, mottagare och HTML‑kropp för e‑posten i MailMessage instans.
3. Specificera DeliveryNotificationOptions i andra MailMessage instanser.
4. Skapa en instans av SmtpClient klass och skicka e‑posten med Send‑metoden.

Begäran om läskvitto kanske inte alltid beaktas därför att:

• En e‑postklient kanske inte implementerar den funktionen.
• Slutanvändaren kan ha inaktiverat den funktionen.
• Slutanvändaren kan välja att inte skicka någon.

Följande kodsnutt visar hur du begär en läskvitto.

Ställ in e‑posthuvuden

E‑posthuvuden representerar en internetstandard och RFC definierar huvudfält som inkluderas i internet‑e‑postmeddelanden. Ett e‑posthuvud kan specificeras med MailMessage‑klassen. Vanliga huvudtyper definieras i HeaderType‑klassen. Det är en förseglad klass som fungerar som en vanlig uppräkning.

Vanligtvis innehåller ett e‑posthuvud dessa fält:

• To: Mottagaradresser kan specificeras i To‑fältet. Mottagarna i To‑fältet är meddelandets primära målgrupp. Det kan finnas mer än en mottagaradress.
• From: Detta fält visar avsändarens e‑postadress.
• Cc: Tillåter användare att skicka ett meddelande som en "Carbon Copy" eller "Courtesy Copy". Det innebär att mottagaren inte förväntas svara eller agera. Vanligtvis blir överordnad personal informerad via CC.
• Bcc: Står för Blind Carbon Copy, avser praxis att skicka ett meddelande till flera mottagare på ett sätt där mottagarna inte ser hela mottagarlistan. Det är avsett för dold notifikation.
• ReplyTo: Detta huvudfält är avsett att ange var avsändaren vill att svar ska skickas.
• Subject: Titel, rubrik, ämne. Används ofta som trådadvisare för meddelanden som svarar på eller kommenterar andra meddelanden.
• Date: Detta huvud anger ett datum (och tid). Vanligtvis är detta datumet då meddelandet skapades och skickades.
• XMailer: Information om avsändarens klientprogramvara. Exempel: X-Mailer: Aspose.Email XMailer används av e‑postklienter. Olika e‑postklienter har olika XMailer‑värden. Microsoft Outlooks XMailer‑värde är Microsoft Office Outlook, Build 11.0.5510. Det ignoreras av mottagaren eller e‑postläsaren.

Vanligtvis ser ett e‑posthuvud ut ungefär så här:

 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

För att anpassa ett e‑posthuvud, följ dessa steg:

• Skapa en instans av MailMessage klass.
• Ange To, From, CC, Bcc, ReplyTo, Subject, Date & XMailer med en instans av MailMessage.
• Skapa en instans av MimeHeader klass och specificera hemligt huvud.
• Lägg till det hemliga huvudet i MailMessage instans.

Följande kodexempel visar hur du ställer in e‑posthuvuden.

Ovanstående kodexempel producerar ett e‑posthuvud i följande format. Detta kan observeras genom att öppna den resulterande filen "MsgHeaders.msg" i Microsoft Outlook och sedan visa egenskaperna.

 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

Infoga huvud på specifik plats

Den Lägg till metod för HeadersCollection klass infogar huvudet i slutet av samlingen. Ibland kan det dock vara nödvändigt att infoga ett huvud på en specifik plats. I sådant fall, Lägg till metoden kommer inte att hjälpa. För att uppnå detta, använd Insert metod för HeadersCollection. Om samlingen innehåller headers med samma namn, kommer detta header att infogas innan andra headers med samma namn. Följande kodsnutt visar hur du infogar header på en specifik plats.

Lägga till anpassade huvud i e‑post

Programmeringsexemplen nedan demonstrerar hur man specificerar en anpassad header i ett e‑postmeddelande. En e‑postheader kan specificeras med MailMessage klass. För att specificera en anpassad header i ett e‑postmeddelande, följ dessa steg:

1. Skapa en instans av MailMessage klass.
2. Specificera to-, from- och subject‑värdena med hjälp av MailMessage‑instansen.
3. Lägg till den hemliga headern i MailMessage instans.
4. Skapa en instans av klassen SmtpClient och skicka e‑posten med hjälp av Send‑metoden.

Följande kodsnutt visar hur du lägger till anpassade huvud i e‑post.