Návod: Vytvoření prvního přizpůsobení na úrovni dokumentu pro Excel

Článek
05/16/2015

Tento úvodní návod ukazuje, jak vytvořit vlastní úroveň dokument pro aplikaci Microsoft Office Excel.Funkce, které vytvoříte v řešení tohoto typu jsou k dispozici pouze při otevření určitého sešitu.Nelze použít úroveň dokument přizpůsobení změny celou aplikaci, například zobrazení novou kartu pásu karet při otevření sešitu.

Platí pro: Informace v tomto tématu se vztahují na projekty na úrovni dokumentu v Excelu 2013 a v Excelu 2010. Další informace najdete v tématu Dostupné funkce podle aplikací systému Office a typů projektu.

Tento návod ilustruje následující úkoly:

Vytvoření projektu aplikace Excel sešitu.
Přidání textu do listu, který je umístěn v návrháři Visual Studio.
Psaní kódu, který používá model objektu aplikace Excel přidat text vlastní list, když je otevřen.
Vytvoření a spuštění projektu pro.
Čištění dokončeného projektu z vývojového počítače odebrat sestavení nepotřebné soubory a nastavení zabezpečení.

[!POZNÁMKA]

Na vašem počítači se můžou v následujících pokynech zobrazovat jiné názvy nebo umístění některých prvků uživatelského rozhraní Visual Studia. Tyto prvky jsou určeny edicí sady Visual Studio a použitým nastavením. Další informace najdete v tématu Přizpůsobení nastavení pro vývoj v sadě Visual Studio.

Požadavky

Chcete-li dokončit tento návod, potřebujete následující komponenty:

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

Vytváření projektu

Vytvořit nový sešit aplikace Excel projekt v aplikaci Visual Studio

Spusťte nástroj Visual Studio.
V nabídce File (Soubor) přejděte na příkaz New (Nový) a klepněte na příkaz Project (Projekt).
Rozbalte v podokně šablony Visual C# nebo jazyka Visual Basica potom rozbalte Office/SharePoint.
V rámci rozšířeného Office/SharePoint uzel, vyberte Doplňky sady Office uzlu.
Vyberte v seznamu šablon projektu Sešit aplikace Excel 2010 nebo 2013 sešit aplikace Excel.
V název zadejte FirstWorkbookCustomization.
Klikněte na tlačítko OK.

Visual Studio Tools for Office Project Průvodce otevře.
Vyberte vytvořit nový dokumenta na OK.
- Visual Studiovytvoří FirstWorkbookCustomization projektu a přidá tyto soubory do projektu.
- FirstWorkbookCustomizationXLSX - představuje sešit aplikace Excel v projektu.Obsahuje všechny listy a grafy.
- List1 (soubor .vb pro soubor .cs pro jazyk Visual C# nebo Visual Basic) - list, který poskytuje návrhovou plochu a kód pro první list sešitu.Další informace naleznete v tématu Hostitelská položka Worksheet.
- List2 (soubor .vb pro soubor .cs pro jazyk Visual C# nebo Visual Basic) - list, který poskytuje návrhovou plochu a kód pro druhý list v sešitu.
- List3 (soubor .vb pro soubor .cs pro jazyk Visual C# nebo Visual Basic) - list, který poskytuje návrhovou plochu a kód pro třetí list v sešitu.
- ThisWorkbook (soubor .vb pro jazyk Visual Basic) nebo soubor .cs pro jazyk Visual C# - obsahuje návrhové plochy a kód pro vlastní nastavení na úrovni sešitu.Další informace naleznete v tématu Hostitelská položka Workbook.
Soubor kódu List1 je automaticky otevřen v návrháři.

Zavřete a znovu otevřete v Návrháři listy

Pokud úmyslně nebo neúmyslně zavřete sešit nebo list v Návrháři při vývoji projektu, můžete jej znovu otevřít.

Zavřete a znovu otevřete list v Návrháři

Sešit zavřete klepnutím Zavřít tlačítko (X) v okně návrháře.
V Průzkumníku, klepněte pravým tlačítkem myši List1 kód souboru a klepněte na Návrhář zobrazení.

-nebo-

V Průzkumníku, poklepejte List1 soubor kódu.

Přidání textu do listu v Návrháři

Navrhnout uživatelské rozhraní (UI) vašeho vlastního nastavení úpravou listu, který je otevřen v návrháři.Můžete například přidat text do buňky použít ve vzorcích nebo přidat ovládací prvky aplikace Excel.Další informace o použití návrháře viz Projekty pro systém Office v prostředí Visual Studio.

Přidání textu do listu pomocí návrháře

Na listu, který je otevřen v návrháři vyberte buňku A1a potom zadejte následující text.

Tento text byl přidán pomocí návrháře.

Upozornění
Pokud přidáte tento řádek textu do buňky A2, bude přepsán jiným kódem v tomto příkladu.

Přidání textu do listu programově

Dále přidejte kód do souboru kódu List1.Nový kód používá model objektu aplikace Excel do sešitu přidat druhý řádek textu.Ve výchozím nastavení obsahuje následující kód generovaný kód souboru List1:

Částečnou definici Sheet1 třídy, která představuje programovací model listu a poskytuje přístup k objektovému modelu aplikace Excel.Další informace Hostitelská položka Worksheet a Přehled modelu objektů aplikace Word.Zbytek Sheet1 třída je definována v souboru skrytý kód, který byste neměli měnit.
Sheet1_Startup a Sheet1_Shutdown obslužné rutiny událostí.Tyto obslužné rutiny události se nazývají Excel načte a uvolní vlastní.Tyto obslužné rutiny událostí pomocí vlastní inicializace, když je načten a k vyčištění prostředků používaných přizpůsobením je uvolněn.Další informace naleznete v tématu Události v projektech pro systém Office.

Druhý řádek textu přidat do listu pomocí kódu

V Průzkumníku, klepněte pravým tlačítkem List1a klepněte na tlačítko Zobrazení kódu.

V aplikaci Visual Studio otevře soubor kódu.

Nahradit Sheet1_Startup obslužnou rutinu následujícím kódem.Při otevření List1 tento kód přidá druhý řádek textu na listu.

Private Sub Sheet1_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
    Dim nr As Microsoft.Office.Tools.Excel.NamedRange = _
        Me.Controls.AddNamedRange(Me.Range("A2"), "NamedRange1")
    nr.Value2 = "This text was added by using code" 
End Sub

private void Sheet1_Startup(object sender, System.EventArgs e)
{
    Microsoft.Office.Tools.Excel.NamedRange nr =
        this.Controls.AddNamedRange(this.Range["A2"], "NamedRange1");
    nr.Value2 = "This text was added by using code";
}

Testování projektu

Testování sešitu

Stiskněte klávesu F5 k vytvoření a spuštění projektu.

Při sestavení projektu kód je zkompilován do sestavení, který je přidružen k sešitu.Výstupní složku sestavení pro projekt Visual Studio vloží kopii sešitu a sestavení a nakonfiguruje nastavení zabezpečení na vývojovém počítači povolit vlastní nastavení spuštění.Další informace naleznete v tématu Sestavování řešení pro systém Office.
V sešitu ověřte, naleznete v následujícím textu.

Tento text byl přidán pomocí návrháře.

Tento text byl přidán pomocí kódu.
Zavřete sešit.

Čištění projektu

Po dokončení vývoje projektu byste měli odebrat soubory výstupní složku sestavení a nastavení zabezpečení vytvořené v procesu sestavení.

Vyčistit dokončeného projektu na vývojovém počítači

V aplikaci Visual Studio na sestavení nabídky, klepněte na Čisté řešení.

Další kroky

Nyní, když jste vytvořili základní úroveň dokument přizpůsobení pro Excel, můžete dozvědět více o vývoji vlastního nastavení z těchto témat:

Obecné programovací úkoly, které můžete provádět úpravy na úrovni dokumentu: Programování přizpůsobení na úrovni dokumentu.
Programovací úlohy, které jsou specifické pro vlastní úroveň dokument pro aplikaci Excel: Řešení pro aplikaci Excel.
Použití objektového modelu aplikace Excel: Přehled modelu objektů aplikace Excel.
Přizpůsobení uživatelského rozhraní aplikace Excel, například pomocí přidání vlastní kartu na pásu karet nebo vytvořením vlastní akce podokno: Přizpůsobení uživatelského rozhraní systému Office.
Pomocí rozšířené objekty aplikace Excel poskytuje nástroje pro vývoj Office v sadě Visual Studio provádět úkoly, které nejsou možné pomocí objektového modelu aplikace Excel (například hostování spravovaných ovládacích prvků na dokumenty a vázáním ovládacích prvků aplikace Excel data pomocí model vázání dat model Windows Forms): Automatizace v aplikaci Excel s použitím rozšířených objektů.
Vytváření a ladění přizpůsobení úroveň dokument pro aplikaci Excel: Sestavování řešení pro systém Office.
Nasazení vlastní úroveň dokument pro aplikaci Excel: Nasazení řešení Office.