Sdílet prostřednictvím

Hostitelská položka sešitu

  • Článek

Hostitelská Workbook položka je typ, který rozšiřuje typ z primárního Workbook sestavení zprostředkovatele komunikace pro Excel. Položka Workbook hostitele poskytuje všechny stejné vlastnosti, metody a události jako Workbook objekt, ale také poskytuje další funkce.

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

V projektech na úrovni dokumentu existuje výchozí Workbook hostitelská položka, která představuje sešit v projektu. V projektech doplňků VSTO můžete vygenerovat Workbook hostitelské položky za běhu.

Principy položky hostitele sešitu v projektech na úrovni dokumentu

Pokud chcete získat přístup k sešitu v projektu, použijte ThisWorkbook třídu. Třída ThisWorkbook poskytuje přístup členům Workbook položky hostitele k provádění základních úloh v přizpůsobení, jako je spuštění kódu při otevření nebo zavření sešitu. Další informace naleznete v tématu Program přizpůsobení na úrovni dokumentu.

Třída ThisWorkbook poskytuje umístění, ve kterém můžete začít psát kód v projektu. Vzhledem k tomu, že třída poskytuje všechny stejné vlastnosti, metody a události jako Workbook objekt v primárním sestavení vzájemné spolupráce pro Excel, můžete také použít ThisWorkbook pro přístup k objektového modelu Aplikace Excel. Další informace naleznete v tématu Přehled objektového modelu aplikace Excel.

Poklikejte na položku projektu ThisWorkbook v Průzkumník řešení zobrazte návrháře sešitu a zobrazte vlastnosti a události sešitu v okně Vlastnosti.

Omezení položky hostitele sešitu v projektech na úrovni dokumentu

Projekt na úrovni dokumentu může obsahovat pouze jednu Workbook položku hostitele (to znamená ThisWorkbook třídu). V době návrhu nelze do projektu přidávat nové Workbook hostitelské položky a nemůžete vytvářet nové Workbook položky hostitele za běhu z přizpůsobení na úrovni dokumentu.

Pokud vytvoříte nový excelový sešit za běhu, bude to typ Workbook. Protože se nejedná o položku hostitele, nemůže obsahovat žádné ovládací prvky hostitele ani ovládací prvky model Windows Forms. Další informace o vytváření sešitů za běhu najdete v tématu Postupy: Vytváření nových sešitů prostřednictvím kódu programu.

Položka Workbook hostitele nefunguje jako kontejner pro ovládací prvky hostitele. Proto nelze do sešitu přidat žádné viditelné ovládací prvky, ale můžete přidat součásti, jako DataSetje například , aby je mohly sdílet všechny listy. V projektu na úrovni dokumentu najdete komponenty dostupné pro sešit na kartě Komponenta, Karta Data a Všechna model Windows Forms na panelu nástrojů.

Poznámka:

Nástroje pro vývoj pro Office v sadě Visual Studio nepodporují sdílené sešity.

Principy položek hostitele sešitu v projektech doplňků VSTO

V projektech doplňků VSTO můžete vygenerovat Workbook položku hostitele za běhu pro libovolný sešit otevřený v Excelu. K vygenerování Workbook položky hostitele použijte metodu GetVstoObject . Další informace naleznete v tématu Rozšíření wordových dokumentů a excelových sešitů v doplňkech VSTO za běhu.

Související obsah