- C# API för e-posttrådsimplementering
- Vad är e-posttrådning?
- Skapa e-posttrådar
- E-posttrådskompatibilitet med IMAP
- Få e-posttrådar med hjälp av THREAD Capability
- Få e-posttrådar med X-GM-EXT-1 Extension
Oavsett om du är en enskild e-postanvändare eller ett stort företag, kan din inkorg överflöda av meddelanden. Det är ofta utmanande att hålla koll på konversationer och deras hantering kan snabbt bli en svår uppgift. Det är där trådning kommer till undsättning, vilket gör att vi kan organisera och följa diskussioner utan ansträngning.
I den här artikeln kommer vi att utforska grunderna för e-posttrådning och tillhandahålla en omfattande guide om hur du använder ImapClient i C# .NET för att enkelt hantera trådade konversationer.
C# API för e-posttrådsimplementering
Ett enkelt sätt att implementera Email Threading i din applikation är att använda Aspose.Email for .NET. Det är ett mångsidigt bibliotek som ger utvecklare möjlighet att effektivt hantera e-postmeddelanden, inklusive skapande, manipulation, analys, konvertering och hantering av bilagor, kalendrar och kontakter i sina .NET-applikationer. För att skaffa API:t kan du ladda ner dess DLL eller installera den från NuGet med följande kommando:
PM> Install-Package Aspose.Email
Vad är e-posttrådning?
E-posttrådning är en teknik som organiserar hierarkiskt alla spridda svar och vidarebefordrar över din inkorg och presenterar dem i en sammanhängande vy. Denna metod är särskilt värdefull när man hanterar långa e-postutbyten som involverar flera deltagare. Hela processen är baserad på användningen av rubriker för att bestämma ämnes- och referensrelationen och ordningen. Huvudhuvudena som används för gängning är:
- “Message-ID”, en unik identifierare för varje e-postmeddelande
In-Reply-To
,Meddelande-ID
för e-postmeddelandet som detta meddelande är ett svar på- “Referenser”, en lista med “Meddelande-ID” för alla tidigare meddelanden i konversationen
Skapa e-posttrådar
En av funktionerna som tillhandahålls av vårt kraftfulla Aspose.Email-bibliotek för att skapa och manipulera e-postmeddelanden är trådning med ImapClient.
ImapClient är en klass som låter dig ansluta till en IMAP-server och utföra olika operationer på din brevlåda. Du kan använda den för att lista, hämta, söka, flytta eller ta bort meddelanden. Det gör det också möjligt att lägga till meddelanden och bygga en trädstruktur som representerar en konversation. Tänk till exempel på följande e-posttråd:
- A: Hej, hur mår du?
- B: Jag mår bra, tack. Och du?
- A: Jag är också bra. Har du några planer för helgen?
- C: Hej, jag går med i den här konversationen.
- B: Välkommen, C. Vi pratade precis om helgen.
- C: Åh, jag förstår. Nåväl, jag ska hälsa på mina föräldrar.
Trädstrukturen i denna tråd skulle se ut så här:
A
└─B
├─A
└─C
├─B
└─C
Varje nod i trädet motsvarar ett meddelande, och varje kant motsvarar ett svar. Rotnoden är det första meddelandet i tråden och bladnoderna är de sista meddelandena.
E-posttrådskompatibilitet med IMAP
I grund och botten stöder IMAP-protokollet THREAD-kapaciteten som definieras i RFC-5256 och som förstås av de flesta e-postservrar. Men om du arbetar med Gmail finns det ett annat IMAP-tillägg som tillhandahålls av Gmail och beskrivs som X-GM-EXT-1.
Aspose.Email har följande egenskaper för att kontrollera vilka tillägg som är tillgängliga för den aktuella IMAP-servern:
- GmExt1Supported: checks whether Gmail X-GM-EXT-1 extension is supported
- ThreadSupported: checks whether THREAD extension is supported
- ThreadAlgorithms: gets supported THREAD algorithms
Metoden GetMessageThreads i ImapClient returnerar en samling objekt MessageThreadResult, som representerar information om ett meddelande och dess relation till andra meddelanden i trädstrukturen.
Få e-posttrådar med hjälp av THREAD Capability
Följande C#-kodexempel visar hur man använder e-posttrådningsfunktioner med THREAD-kapacitet på IMAP-servern.
using (ImapClient client = new ImapClient("imap.domain.com", 993, "username", "password", SecurityOptions.SSLImplicit))
{
client.SelectFolder(ImapFolderInfo.InBox);
// få en lista med meddelanden som vi grupperar efter konversation
var messages = client.ListMessages();
// se till att IMAP-servern stöder THREAD-kapacitet
if (client.ThreadSupported)
{
foreach (var conversationId in messages
// den här frågan får bara ett unikt konversations-ID för vårt exempel
.Select(message => message.ConversationId)
.Where(conversationId => !string.IsNullOrEmpty(conversationId)).Distinct())
{
// skapa de nödvändiga sökvillkoren för en tråd
var conditions = new ThreadSearchConditions
{
Algorithm = client.ThreadAlgorithms[0],
UseUId = true
};
// få resultat
List<MessageThreadResult> conversation = client.GetMessageThreads(conditions);
// skriv ut e-postkonversationen på hierarkiskt sätt
PrintConversaton(string.Empty, conversation, messages);
Console.WriteLine(new string('-', 20));
}
}
}
///<summary>
/// Skriver ut e-postkonversationen på hierarkiskt sätt
///</summary>
public static void PrintConversaton(string indent, List<MessageThreadResult> conversation, List<ImapMessageInfo> messages)
{
foreach (var thread in conversation)
{
Console.WriteLine("{0} ({1}) {2}", indent, thread.UniqueId,
messages.Find(x => x.UniqueId == thread.UniqueId).Subject);
if (thread.ChildMessages.Count != 0)
{
PrintConversaton(indent += "-", thread.ChildMessages, messages);
}
}
}
Få e-posttrådar med X-GM-EXT-1 Extension
C#-kodexemplen nedan visar hur man hämtar e-posttrådarna via IMAP från Gmail-servern.
using (ImapClient client = new ImapClient("imap.gmail.com", 993, "username", "password", SecurityOptions.SSLImplicit))
{
client.SelectFolder(ImapFolderInfo.InBox);
// få en lista med meddelanden som vi grupperar efter konversation
var messages = client.ListMessages();
// se till att IMAP-servern stöder X-GM-EXT-1-tillägget
if (client.GmExt1Supported)
{
foreach (var conversationId in messages
// den här frågan får bara ett unikt konversations-ID för vårt exempel
.Select(message => message.ConversationId)
.Where(conversationId => !string.IsNullOrEmpty(conversationId)).Distinct())
{
// skapa de nödvändiga sökvillkoren för en tråd
var conditions = new XGMThreadSearchConditions
{
ConversationId = conversationId,
UseUId = true
};
// få resultat
List<MessageThreadResult> conversation = client.GetMessageThreads(conditions);
// skriv ut e-postkonversationen på hierarkiskt sätt
PrintConversaton(string.Empty, conversation, messages);
Console.WriteLine(new string('-', 20));
}
}
}
///<summary>
/// Skriver ut e-postkonversationen på hierarkiskt sätt
///</summary>
public static void PrintConversaton(string indent, List<MessageThreadResult> conversation, List<ImapMessageInfo> messages)
{
foreach (var thread in conversation)
{
Console.WriteLine("{0} ({1}) {2}", indent, thread.UniqueId,
messages.Find(x => x.UniqueId == thread.UniqueId).Subject);
if (thread.ChildMessages.Count != 0)
{
PrintConversaton(indent += "-", thread.ChildMessages, messages);
}
}
}
Slutsats
Sammanfattningsvis har du nu ett oumbärligt verktyg för att effektivt hantera överflödet av dina inkorgsmeddelanden. Artikeln gav dig kunskapen om fördelarna med e-posttråden, dess användning och andra användbara tips om dess implementering. Genom att utnyttja funktionerna hos ImapClient i C# .NET kan utvecklare enkelt implementera e-posttrådar med Aspose.Email-biblioteket. Med sina omfattande funktioner och stöd för olika e-postuppgifter, förenklar Aspose.Email processen att bygga e-posttrådar, organisera meddelanden hierarkiskt och presentera dem i en sammanhängande bild. Dessutom kan du utforska hur du arbetar med flera andra e-postfilformat och lära dig mer om API:t med hjälp av dokumentation. I händelse av oklarheter är du välkommen att kontakta oss på vårt gratis supportforum.