Čtení a vytváření položek Outlooku

Tento článek se zaměřuje na práci s různými prvky Outlooku, včetně kalendáře, kontaktů, úkolů, deníku, poznámek a distribučních seznamů. V Aspose.Email pro .NET jsou tyto prvky reprezentovány následujícími třídami: MapiCalendar, MapiContact, MapiTask, MapiJournal, MapiNote a MapiDistributionList. Tyto třídy slouží jako obal pro třídu MapiMessage, aby usnadnily zpracování dat položek z vlastností MAPI a poskytly intuitivnější rozhraní pro přístup a manipulaci s daty položek.

C# .NET API pro provádění úkolů souvisejících s e-mailem

Pro programovou práci s položkami Outlooku v C# budeme používat Aspose.Email pro .NET, pokročilou knihovnu, která vám umožní snadno spravovat e-maily, kontakty, schůzky, úkoly a další položky Outlooku. Mezi klíčové vlastnosti knihovny patří čtení a zápis e-mailů v různých formátech, správa schůzek a úkolů, práce s kontakty, integrace s Exchange Serverem a provádění pokročilých e-mailových operací. V tomto blogovém příspěvku ukážeme, jak ji používat pro interakci s položkami Outlooku v aplikacích .NET. Praktické příklady a ukázky kódu jsou poskytovány, aby vám pomohly pochopit a implementovat funkce Aspose.Email pro .NET hladce ve vašich projektech C#.

Pro využití síly API je možné buď stáhnout jeho DLL, nebo jej nainstalovat z NuGet pomocí následujícího příkazu:

PM> Install-Package Aspose.Email

Obecný přístup

Obecný přístup k práci s položkami Outlooku zahrnuje načtení MapiMesage, převod na konkrétní třídu položky Outlooku (například MapiContact nebo MapiCalendar) a poté přístup nebo manipulaci s jejími vlastnostmi. Tento přístup usnadňuje práci s vlastnostmi MAPI a poskytuje jasný způsob, jak spravovat různé typy položek Outlooku. Na druhé straně se vždy můžete vrátit k objektu MapiMessage jednoduše zavoláním metody GetUnderlyingMessage na jakémkoli objektu položky.

Manipulace s položkami kalendáře

Položky kalendáře Outlooku jsou reprezentovány třídou MapiCalendar. Tato třída poskytuje vlastnosti a metody pro vytváření, manipulaci a správu položek kalendáře, jako jsou schůzky, schůzky a události v rámci kalendáře Outlooku. Uživatelé mohou tuto třídu používat k snadnému vytváření, modifikaci a interakci s položkami kalendáře programově ve svých aplikacích .NET. V následujících odstavcích se dozvíte, jak vytvářet a číst položky kalendáře.

Čtení položek kalendáře

Následující ukázka kódu demonstruje, jak načíst soubor .msg jako objekt MapiMessage. Poté zkontroluje, zda je načtená zpráva typu Kalendář pomocí vlastnosti SupportedType. Pokud je skutečně položkou kalendáře, kód převede zprávu na objekt MapiCalendar a pokračuje ve výstupu podrobností o položce kalendáře.

Následují kroky kód:

  1. Načtěte soubor jako objekt MapiMessage pomocí metody Load.
  2. Zkontrolujte, zda je načtená zpráva typu Kalendář.
  3. Pokud je to položka kalendáře, převeděte zprávu na objekt MapiCalendar.
  4. Vypište umístění, předmět, datum začátku a datum ukončení položky kalendáře.

Vytváření položky kalendáře

Chcete-li vytvořit novou položku kalendáře a uložit ji v různých formátech, použijte následující ukázku kódu poskytnutou společností Aspose.Email:

  1. Vytvořte novou položku kalendáře MapiCalendar s konkrétními detaily, jako jsou umístění, předmět, popis, čas začátku a čas ukončení.
  2. Zavolejte metodu Save na objektu kalendáře s parametry určujícími název výstupního souboru a možnosti ukládání. Položka kalendáře je uložena jako soubor ICS (iCalendar) s příponou “.ics” pomocí MapiCalendarSaveOptions.DefaultIcs.
  3. Podobně je metoda Save znovu volána na objektu kalendáře pro uložení položky kalendáře jako souboru MSG (zpráva Outlook) s příponou “.msg” pomocí MapiCalendarSaveOptions.DefaultMsg.

Manipulace s položkami kontaktů

Aspose.Email nabízí třídu MapiContact, která se používá pro práci s položkami kontaktů Microsoft Outlook. Umožňuje vývojářům vytvářet, číst, aktualizovat a manipulovat s kontakty Outlooku v různých formátech, jako jsou MSG a VCF. Tato třída poskytuje vlastnosti a metody pro nastavení a získání informací o kontaktu, včetně jména, e-mailové adresy, telefonních čísel, pracovního titulu, společnosti a dalších kontaktních údajů.

Níže uvedené ukázky kódu demonstrují, jak používat třídu MapiContact při vytváření a čtení kontaktů.

Čtení položek kontaktů

Proces čtení položky kontaktu zahrnuje načtení zprávy kontaktu z souboru MAPI a zobrazení podrobností o kontaktu:

  1. Načtěte MapiMessage ze souboru pomocí MapiMessage.Load.
  2. Zkontrolujte, zda je podporovaný typ MapiMessage kontaktem.
  3. Pokud je to kontakt, převedete MapiMessage na objekt MapiContact.
  4. Zobrazte jméno, e-mail a podrobnosti o společnosti kontaktu.

Vytváření položky kontaktu

Vytvořme nový kontakt pomocí třídy MapiContact, nastavme různé vlastnosti, jako je jméno, e-mailová adresa a informace o společnosti, a poté uložme podrobnosti kontaktu do formátů VCARD a MSG.

Proces zahrnuje následující kroky:

  1. Vytvořte nový objekt MapiContact a inicializujte jeho vlastnosti, včetně jména, e-mailové adresy a informací o společnosti.
  2. Uložte podrobnosti kontaktu do formátu VCARD pomocí metody Save s parametrem ContactSaveFormat.VCard.
  3. Uložte podrobnosti kontaktu do formátu MSG pomocí metody Save s parametrem ContactSaveFormat.Msg.

Manipulace s položkami úkolů

Aspose.Email poskytuje řešení pro efektivní správu úkolů Outlooku. Třída MapiTask je vynikající volba pro vytváření a čtení úkolů bez problémů. Podívejme se, jak tato třída funguje v kódu.

Čtení položek úkolů

Pro přístup a manipulaci s položkami úkolů načtěte jednu ze souboru pomocí MapiMessage.Load. Pomocí několika řádků kódu můžete získat důležité podrobnosti o úkolu, jako je předmět, stav a procento dokončení.

  1. Načtěte úkol ze souboru pomocí MapiMessage.Load.
  2. Zkontrolujte, zda je načtená zpráva typu MapiItemType Task.
  3. Pokud je zpráva úkolem, převedete ji na typ MapiTask.
  4. Zobrazte podrobnosti o úkolu tím, že vytisknete předmět, stav a procento dokončení.

Vytváření položky úkolu

Následující ukázka kódu demonstruje, jak vytvořit položku úkolu, nastavit její vlastnosti, jako je název, popis, datum začátku a splatnosti, procento dokončení a stav, a uložit ji jako soubor MSG:

  1. Vytvořte nový objekt úkolu pomocí třídy MapiTask se specifikovanými detaily, jako je název, popis, datum začátku, datum ukončení, procento dokončení a stav.
  2. Nastavte vlastnost PercentComplete úkolu a vlastnost Status.
  3. Uložte vytvořený úkol do souboru MSG pomocí metody Save s parametrem TaskSaveFormat.Msg jako parametrem formátu.

Správa položek deníku

Položka deníku Outlooku je reprezentována třídou MapiJournal. Následující pokyny vás provedou, jak vytvořit a číst položku deníku.

Čtení položky MapiJournal

Chcete-li přečíst položku MapiJournal, můžete načíst zprávu deníku pomocí metody MapiMessage.Load. Po ověření, že podporovaný typ je deník, můžete získat a zobrazit podrobnosti o deníku, jako je jeho předmět, stav dokumentu, čas začátku a čas ukončení.

  1. Načtěte zprávu MAPI ze souboru.
  2. Zkontrolujte, zda je podporovaný typ načtené zprávy položkou deníku.
  3. Pokud je zpráva typu deník, převedete ji na objekt MapiJournal.
  4. Vypište podrobnosti deníku včetně předmětu, stavu, času začátku a času ukončení.

Vytváření položky MapiJournal

Nyní vytvoříme zápis do deníku a zahrneme podrobnosti. Záznam bude také obsahovat krátký popis schůzky. Tento kód demonstruje, jak vytvořit a uložit MapiJournal.

  1. Definujte nový zápis do deníku pomocí třídy MapiJournal se specifickými detaily, jako je název, popis, popis schůzky a shrnutí diskuze.
  2. Nastavte čas začátku a konce.
  3. Určete společnost a kategorizujte zápis.
  4. Uložte vytvořený zápis do deníku do souboru pomocí metody Save.

Správa položek poznámek

Aspose.Email nabízí třídu MapiNote, která reprezentuje poznámku Outlooku. Poskytuje řešení pro efektivní vytváření a získávání informací o poznámkách. Podívejme se, jak to funguje.

Čtení položky poznámky

Pro přístup a zobrazení podrobností poznámky načtěte zprávu poznámky pomocí metody MapiMessage.Load a získejte objekt poznámky. Poté můžete přistupovat a zobrazit konkrétní podrobnosti, jako je předmět, tělo a barva poznámky pro další zpracování.

  1. Načtěte MapiMessage ze souboru.
  2. Pokud je načtená zpráva typu poznámka, převedete MapiMessage na objekt MapiNote.
  3. Vytiskněte předmět, tělo a barvu převedeného objektu MapiNote.

Vytváření položky poznámky

Vytvoření nové poznámky je snadno dosaženo definováním vlastností předmětu, těla a barvy poznámky v novém objektu MapiNote. Jakmile je poznámka nakonfigurována, může být uložena jako zpráva pomocí metody Save s určeným formátem souboru pro budoucí odkazy a správu.

  1. Vytvořte nový objekt MapiNote s předmětem, tělem a barvou.
  2. Uložte poznámku do souboru msg voláním metody Save.

Správa distribučních seznamů

Pro vytvoření a čtení distribučního seznamu Outlooku budeme používat třídu MapiDistributionList. Následující ukázky kódu s kroky vám pomohou pochopit, jak tuto funkčnost implementovat do projektu.

Čtení distribučního seznamu

Chcete-li přečíst položku distribučního seznamu, začněte jej načtením ze souboru pomocí metody MapiMessage.Load. Pokud je načtená položka typu DistList, můžete poté zobrazit její podrobnosti, jako je název a informace o členech.

  1. Načtěte distribuční seznam ze souboru.
  2. Zkontrolujte, zda je načtená zpráva typu distribuční seznam (DistList).
  3. Převeďte zprávu na objekt MapiDistributionList.
  4. Zobrazte název distribučního seznamu a členy.

Vytváření distribučního seznamu

Pro vytvoření nového distribučního seznamu použijte prostor jmen Aspose.Email.Mapi. Přidejte členy, přičemž určete jejich jména a e-mailové adresy. Můžete uložit distribuční seznam ve formátu VCF nebo MSG pro budoucí použití.

  1. Vytvořte nový distribuční seznam pomocí třídy MapiDistributionList.
  2. Přidejte členy do distribučního seznamu spolu s jejich e-mailovými adresami.
  3. Uložte distribuční seznam do formátu VCF pomocí metody Save.
  4. Uložte distribuční seznam do formátu MSG stejnou metodou Save.

Závěr

V tomto blogovém příspěvku jsme prozkoumali způsoby čtení a vytváření položek Outlooku, jako jsou kalendáře, kontakty, úkoly, zápisy do deníku, poznámky a distribuční seznamy programově v C#. Pro kódování jsme použili Aspose.Email pro .NET, komplexní knihovnu, která usnadňuje práci s úkoly souvisejícími s e-mailem, včetně manipulace s různými prvky Outlooku. Využitím tříd poskytovaných knihovnou můžete snadno vytvářet, číst a manipulovat s těmito prvky. Tento příspěvek pokryl základní příklady každého prvku a poskytl základ pro složitější operace, které můžete potřebovat ve svých aplikacích. Intuitivní ukázky kódu vám pomohou vyhodnotit možnosti knihovny a pochopit, jak implementovat její funkce ve vašem projektu.

Neváhejte využít naše veřejné zdroje:

  • API reference nabízí podrobné informace o třídách a metodách.
  • Dokumentace poskytuje komplexní průvodce s příklady.
  • Podpora fóra umožňuje uživatelům žádat o pomoc a diskutovat o problémech.
  • Blog obsahuje aktualizace, tutoriály a osvědčené postupy.

Viz také