Návod: Vytvoření prvního doplňku VSTO pro Outlook

  • Článek

V tomto názorném postupu se dozvíte, jak vytvořit doplněk VSTO pro aplikace Microsoft Office Outlook. Funkce, které vytvoříte v tomto typu řešení, jsou dostupné pro samotnou aplikaci bez ohledu na to, kterou položku Aplikace Outlook je otevřená. Další informace najdete v tématu Přehled vývoje řešení pro Office (VSTO).

Platí pro: Informace v tomto tématu platí pro projekty doplňků VSTO pro Outlook. Další informace naleznete v tématu Funkce dostupné aplikace Office lication a typu projektu.

Poznámka:

Zajímá vás vývoj řešení, která rozšiřují prostředí Office napříč několika platformami? Podívejte se na nový model doplňků pro Office. Doplňky pro Office mají v porovnání s doplňky a řešeními VSTO malé nároky a můžete je vytvářet pomocí téměř jakékoli webové programovací technologie, jako je HTML5, JavaScript, CSS3 a XML.

Tento návod znázorňuje následující úlohy:

  • Vytvoření projektu doplňku VSTO aplikace Outlook pro Outlook

  • Psaní kódu, který používá objektový model Aplikace Outlook k přidání textu do předmětu a textu nové e-mailové zprávy

  • Sestavení a spuštění projektu, který ho otestuje.

  • Vyčištění dokončeného projektu tak, aby se doplněk VSTO přestal automaticky spouštět na vývojovém počítači.

    Poznámka:

    Váš počítač může v následujících pokynech zobrazovat odlišné názvy nebo umístění některých prvků uživatelského rozhraní sady Visual Studio. Tyto prvky jsou určeny edicí sady Visual Studio a použitým nastavením. Další informace naleznete v tématu Přizpůsobení integrovaného vývojového prostředí (IDE).

Požadavky

K dokončení tohoto návodu budete potřebovat následující komponenty:

Vytvoření projektu

Vytvoření nového projektu Outlooku v sadě Visual Studio

  1. Spusťte Visual Studio.

  2. V nabídce Soubor přejděte na příkaz Nový a klepněte na tlačítko Projekt.

  3. V podokně šablon rozbalte Visual C# nebo Visual Basic a potom rozbalte Office/SharePoint.

  4. V rozbaleném uzlu Office nebo SharePointu vyberte uzel Doplňky Pro Office.

  5. V seznamu šablon projektů zvolte projekt doplňku Outlook VSTO.

  6. Do pole Název zadejte FirstOutlookAddIn.

  7. Klikněte na OK.

    Visual Studio vytvoří projekt FirstOutlookAddIn a otevře soubor kódu ThisAddIn v editoru.

Napsání kódu, který přidá text do každé nové e-mailové zprávy

Dále přidejte kód do souboru kódu ThisAddIn. Nový kód používá objektový model Aplikace Outlook k přidání textu do každé nové e-mailové zprávy. Ve výchozím nastavení soubor kódu ThisAddIn obsahuje následující vygenerovaný kód:

  • Částečná definice ThisAddIn třídy. Tato třída poskytuje vstupní bod pro váš kód a poskytuje přístup k objektovému modelu Aplikace Outlook. Další informace naleznete v tématu Program VSTO Doplňky. Zbývající část ThisAddIn třídy je definována ve skrytém souboru kódu, který byste neměli upravovat.

  • Obslužné ThisAddIn_Startup rutiny událostí a ThisAddIn_Shutdown obslužné rutiny událostí. Tyto obslužné rutiny událostí se volají, když Outlook načte a uvolní doplněk VSTO. Pomocí těchto obslužných rutin událostí inicializujete doplněk VSTO při jeho načtení a vyčistíte prostředky používané doplňkem VSTO při jeho uvolnění. Další informace naleznete v tématu Události v projektech Office.

Přidání textu do předmětu a textu každé nové e-mailové zprávy

  1. V souboru kódu ThisAddIn deklarujte pole pojmenované inspectors ve ThisAddIn třídě. Pole inspectors udržuje odkaz na kolekci oken inspektoru v aktuální instanci Outlooku. Tento odkaz brání uvolňování paměti, která obsahuje obslužnou rutinu události události NewInspector .

    Outlook.Inspectors inspectors;

  2. Nahraďte metodu ThisAddIn_Startup následujícím kódem. Tento kód připojí obslužnou rutinu NewInspector události k události.

    private void ThisAddIn_Startup(object sender, System.EventArgs e)
{
    inspectors = this.Application.Inspectors;
    inspectors.NewInspector +=
    new Microsoft.Office.Interop.Outlook.InspectorsEvents_NewInspectorEventHandler(Inspectors_NewInspector);
}

  3. Do souboru kódu ThisAddIn přidejte do ThisAddIn třídy následující kód. Tento kód definuje obslužnou rutinu NewInspector události pro událost.

    Když uživatel vytvoří novou e-mailovou zprávu, tato obslužná rutina události přidá text do řádku předmětu a textu zprávy.

    void Inspectors_NewInspector(Microsoft.Office.Interop.Outlook.Inspector Inspector)
{
    Outlook.MailItem mailItem = Inspector.CurrentItem as Outlook.MailItem;
    if (mailItem != null)
    {
        if (mailItem.EntryID == null)
        {
            mailItem.Subject = "This text was added by using code";
            mailItem.Body = "This text was added by using code";
        }

    }
}

    Pokud chcete upravit každou novou e-mailovou zprávu, předchozí příklady kódu používají následující objekty:

  • Pole Application ThisAddIn třídy. Pole Application vrátí Application objekt, který představuje aktuální instanci aplikace Outlook.

  • Parametr Inspector obslužné rutiny události pro NewInspector událost. Parametr Inspector je Inspector objekt, který představuje okno inspektoru nové poštovní zprávy. Další informace najdete v tématu Řešení outlooku.

Testování projektu

Při sestavování a spuštění projektu ověřte, že se text zobrazí v řádku předmětu a textu nové e-mailové zprávy.

Otestování projektu

  1. Stisknutím klávesy F5 sestavte a spusťte projekt.

    Při sestavení projektu se kód zkompiluje do sestavení, které je součástí výstupní složky sestavení projektu. Visual Studio také vytvoří sadu položek registru, které outlooku umožňují zjišťovat a načítat doplňky VSTO a konfiguruje nastavení zabezpečení na vývojovém počítači, aby bylo možné doplněk VSTO spustit. Další informace najdete v přehledu procesu sestavení řešení Office.

  2. V Outlooku vytvořte novou e-mailovou zprávu.

  3. Ověřte, že se do řádku předmětu i textu zprávy přidá následující text.

    Tento text byl přidán pomocí kódu.

  4. Zavřete aplikaci Outlook.

Vyčištění projektu

Po dokončení vývoje projektu odeberte z vývojového počítače sestavení doplňku VSTO, položky registru a nastavení zabezpečení. Jinak se doplněk VSTO spustí při každém otevření Outlooku na vývojovém počítači.

Vyčištění projektu

  1. V sadě Visual Studio v nabídce Sestavení klepněte na tlačítko Vyčistit řešení.

Další kroky

Teď, když jste vytvořili základní doplněk VSTO pro Outlook, můžete se dozvědět více o tom, jak vyvíjet doplňky VSTO z těchto témat:

  • Obecné programovací úlohy, které můžete provádět pomocí doplňků VSTO pro Outlook. Další informace naleznete v tématu Program VSTO Doplňky.

  • Pomocí objektového modelu Aplikace Outlook. Další informace najdete v tématu Řešení outlooku.

  • Přizpůsobení uživatelského rozhraní Outlooku, například přidáním vlastní karty na pás karet nebo vytvořením vlastního podokna úloh Další informace najdete v tématu Přizpůsobení uživatelského rozhraní Office.

  • Vytváření a ladění doplňků VSTO pro Outlook Další informace najdete v tématu Sestavení řešení Office.

  • Nasazení doplňků VSTO pro Outlook Další informace najdete v tématu Nasazení řešení Office.

Související obsah