Sdílet prostřednictvím

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

  • Článek

V tomto úvodním návodu se dozvíte, jak vytvořit doplněk na úrovni aplikace pro systém Microsoft Office Excelu. Funkce, které vytvoříte v tomto typu řešení, jsou k dispozici pro samotnou aplikaci bez ohledu na to, které sešity jsou otevřené.

Platí pro: Informace v tomto tématu platí pro projekty doplňků VSTO pro Excel. 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 Excel pro Excel

  • Psaní kódu, který používá objektový model Aplikace Excel k přidání textu do sešitu při uložení

  • 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 doplňku Excel VSTO 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ů vyberte doplněk Excelu 2010 nebo doplněk Excelu 2013.

  6. Do pole Název zadejte FirstExcelAddIn.

  7. Klikněte na OK.

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

Napsání kódu pro přidání textu do uloženého sešitu

Dále přidejte kód do souboru kódu ThisAddIn. Nový kód používá objektový model Aplikace Excel k vložení často používaného textu do prvního řádku aktivního listu. Aktivní list je list, který je otevřený, když uživatel sešit uloží. 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 Excel. 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ž Excel 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 při jeho uvolnění. Další informace naleznete v tématu Události v projektech Office.

Přidání řádku textu do uloženého sešitu

  1. Do souboru kódu ThisAddIn přidejte do ThisAddIn třídy následující kód. Nový kód definuje obslužnou rutinu WorkbookBeforeSave události pro událost, která se vyvolá při uložení sešitu.

    Když uživatel uloží sešit, obslužná rutina události přidá na začátek aktivního listu nový text.

    void Application_WorkbookBeforeSave(Microsoft.Office.Interop.Excel.Workbook Wb, bool SaveAsUI, ref bool Cancel)
{
    Excel.Worksheet activeWorksheet = ((Excel.Worksheet)Application.ActiveSheet);
    Excel.Range firstRow = activeWorksheet.get_Range("A1");
    firstRow.EntireRow.Insert(Excel.XlInsertShiftDirection.xlShiftDown);
    Excel.Range newFirstRow = activeWorksheet.get_Range("A1");
    newFirstRow.Value2 = "This text was added by using code";
}

  2. Pokud používáte jazyk C#, přidejte do ThisAddIn_Startup obslužné rutiny události následující požadovaný kód. Tento kód slouží k připojení Application_WorkbookBeforeSave obslužné rutiny WorkbookBeforeSave události k události.

    this.Application.WorkbookBeforeSave += new Microsoft.Office.Interop.Excel.AppEvents_WorkbookBeforeSaveEventHandler(Application_WorkbookBeforeSave);

    Chcete-li upravit sešit při uložení, 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 Excel.

  • Parametr Wb obslužné rutiny události pro WorkbookBeforeSave událost. Parametr Wb je Workbook objekt, který představuje uložený sešit. Další informace naleznete v tématu Přehled objektového modelu aplikace Excel.

Testování projektu

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é Excelu umožňují vyhledat a načíst doplněk VSTO, a nakonfiguruje nastavení zabezpečení na vývojovém počítači tak, aby bylo možné doplněk VSTO spustit. Další informace najdete v tématu Sestavení řešení Office.

  2. V Excelu sešit uložte.

  3. Ověřte, že se do sešitu přidal následující text.

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

  4. Zavřete Excel.

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 bude dál spouštět při každém otevření Excelu na vývojovém počítači.

Vyčištění dokončeného projektu na vývojovém počítači

  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 Excel, 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 v doplňkech VSTO: Programové doplňky VSTO.

  • Programovací úlohy specifické pro doplňky VSTO v Excelu: Řešení Excelu

  • Použití objektového modelu Aplikace Excel: Přehled objektového modelu aplikace Excel.

  • Přizpůsobení uživatelského rozhraní Excelu, například přidáním vlastní karty na pás karet nebo vytvořením vlastního podokna úloh: Přizpůsobení uživatelského rozhraní Office

  • Vytváření a ladění doplňků VSTO pro Excel: Vytváření řešení Office

  • Nasazení doplňků VSTO pro Excel: Nasazení řešení Office

Související obsah