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

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:

• Edice Visual Studia, která zahrnuje nástroje Microsoft Office Developer Tools. Další informace najdete v tématu Konfigurace počítače pro vývoj řešení Office.

• Microsoft Outlook

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 .

   C#

   Outlook.Inspectors inspectors;
   

   VB

   Private WithEvents inspectors As Outlook.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.

   C#

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

   VB

   Private Sub ThisAddIn_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
       inspectors = Me.Application.Inspectors
   End Sub
   

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.

   C#

   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";
           }
   
       }
   }
   

   VB

   Private Sub inspectors_NewInspector(ByVal Inspector As Microsoft.Office.Interop.Outlook.Inspector) Handles inspectors.NewInspector
       Dim mailItem As Outlook.MailItem = TryCast(Inspector.CurrentItem, Outlook.MailItem)
       If Not (mailItem Is Nothing) Then
           If mailItem.EntryID Is Nothing Then
               mailItem.Subject = "This text was added by using code"
               mailItem.Body = "This text was added by using code"
           End If
       End If
   End Sub
   

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

• Pole ApplicationThisAddIn 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

• Programové doplňky VSTO
• Řešení Outlooku
• Přizpůsobení uživatelského rozhraní Office
• Vytváření řešení Pro systém Office
• Nasazení řešení Office
• Přehled šablon projektů Office