ListObject – ovládací prvek

Článek
05/16/2015

ListObject Je ovládací prvek seznam, který poskytuje události a mohou být vázány na data.Při přidání seznamu na listu, vytvoří aplikace Visual Studio ListObject ovládací prvek, který lze naprogramovat proti přímo, bez nutnosti procházet objektový model aplikace Microsoft Office Excel.

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

Vytváření ovládacího prvku

Projekty na úrovni dokumentu, můžete přidat ListObject ovládacích prvků do listu v době návrhu nebo za běhu.Projekty na úrovni aplikace, můžete přidat ListObject prvky listy pouze v době běhu.Další informace naleznete v tématu Postupy: Přidání ovládacích prvků ListObject do listů.

[!POZNÁMKA]

Standardně nejsou trvalé dynamicky vytvořený seznam objektů v listu jako hostitel při uzavření listu.Další informace naleznete v tématu Přidání ovládacích prvků do dokumentů Office za běhu.

Svázání dat s ovládacím prvkem

A ListObject ovládací prvek podporuje jednoduché i složité datové vazby.ListObject Může být vázán na zdroj dat pomocí DataSource a DataMember vlastnosti v době návrhu nebo SetDataBinding metoda v době běhu.

[!POZNÁMKA]

ListObject Je automaticky aktualizován, pokud je vázán na zdroj dat, jako DataTable, který vyvolává události při změně dat.Pokud svážete ListObject pro zdroj dat, který nevyvolává události při změně dat, musíte zavolat RefreshDataRow nebo RefreshDataRows metoda aktualizace ListObject.

Při přidání ListObject na buňku listu mapováním opakující se prvek schématu na danou buňku, aplikace Visual Studio automaticky mapuje ListObject chcete generované dataset.Nicméně ListObject není automaticky vázány na data.Můžete provést kroky vytvořit vazbu ListObject do objektu dataset v době návrhu nebo za běhu v projektu na úrovni dokumentu.Můžete programově vytvořit vazbu ListObject do objektu dataset v době běhu v doplňku úrovni aplikace.

Protože je odděleně od dat ListObject, měli přidat a odebrat data prostřednictvím vázaného objektu dataset a není přímo prostřednictvím ListObject.Pokud aktualizaci dat v datové vazby prostřednictvím mechanismus, ListObject ovládací prvek automaticky odráží změny.Další informace naleznete v tématu Vázání dat k ovládacím prvkům v řešeních pro systém Office.

Je možné rychle vyplnit ListObject ovládací prvek s vazbou ListObject zdroj dat.Pokud upravíte data v vázanými daty ListObject, změny jsou automaticky provedeny ve zdroji dat. stejně.Pokud chcete vyplnit ListObject a povolit uživateli změnit data v ListObject bez změny zdroje dat, můžete použít Disconnect metoda odpojit ListObject ze zdroje dat.Další informace naleznete v tématu Postupy: Vyplnění ovládacích prvků ListObject daty.

[!POZNÁMKA]

Datová vazba nepodporuje překrývající se ListObject prvky.

Zlepšení výkonu v objektu ListObject prvky

Čtení souboru XML do vázání dat ListObject ovládací prvek má tendenci být pomalejší, pokud nejprve navázat ovládací prvek a potom volat ReadXml vyplnit dataset.Zvýšení výkonu, volání ReadXml před ovládací prvek svázat.

Odpojení objektu ListObject ovládací prvky zdroje dat

Po vyplnění ListObject ovládací prvek s daty ve vázání ke zdroji dat, můžete jej odpojit tak, aby se změny dat v seznamu objekt zdroje dat neovlivní.Další informace naleznete v tématu Postupy: Vyplnění ovládacích prvků ListObject daty.

Obnovení sloupec a řádek objednávky.

Při vázání dat ListObject ovládací prvek, který byl přidán do dokumentu v době návrhu aplikace Visual Studio uchovává záznamy o pořadí řádků a sloupců při každém uložení sešitu.Pokud uživatel přejde ListObject sloupců nebo řádků při běhu, nové objednávky se zachová při příštím otevření sešitu a ListObject zdroj dat znovu sváže ovládací prvek.

Pokud chcete obnovit ListObject původní sloupec a řádek objednávky volejte ResetPersistedBindingInformation metoda.Tato metoda odstraní související sloupce vlastností vlastního dokumentu a zadané pořadí řádek ListObject.Volání této metody z Shutdown události sešitu, pokud nechcete zachovat pořadí sloupců a řádků ListObject.

Formátování

Formátování, které lze použít ListObject lze použít ListObject řízení.To zahrnuje styly ohraničení, písma a formát čísla.Koncovým uživatelům můžete změnit uspořádání sloupců v vázanými daty ListObject, a tyto změny budou trvalé dokument, pokud ListObject byla přidána do dokumentu v době návrhu.Při příštím otevření dokumentu objekt seznamu budou vázány na stejný zdroj dat, ale pořadí sloupců bude odrážet změny uživatelů.

Přidání a odebrání sloupců v době běhu

Nelze ručně přidat nebo odebrat sloupce v vázanými daty ListObject ovládacího prvku za běhu.Pokud koncový uživatel pokusí odstranit sloupec, budou okamžitě obnovena a budou odebrány všechny sloupce přidány.Proto je důležité napsat kód vysvětlit, proč jim nelze provádět tyto akce na uživatele ListObject vázaný na data.Visual Studio obsahuje několik událostí ListObject související datové vazby.Například můžete použít OriginalDataRestored události upozornit uživatele, kteří se pokusí odstranit data nelze odstranit a byl obnoven.

Přidávání a odebírání řádků v době běhu

Ručně přidat a odebrat řádky v vázanými daty ListObject ovládací prvek zdroje dat umožňuje přidání nových řádků a není určena jen pro čtení.Můžete psát kód proti události, jako BeforeAddDataBoundRow ověřit data.Další informace naleznete v tématu Postupy: Ověření dat při přidání nového řádku do ovládacího prvku ListObject.

Vztah seznam objekt zdroje dat někdy způsobí, že běžné chyby.Například lze namapovat sloupce, které chcete zobrazit v ListObject, takže pokud vynecháte sloupce, které mají omezení, například pole nemohou obsahovat hodnoty null jsou chyby vyvolána pokaždé, když je vytvořen řádek.Můžete napsat kód v obslužné rutině události pro přidání chybějící hodnoty ErrorAddDataBoundRow události.

Přejmenování objektu ListObject ovládacích prvků v aplikaci Excel

Aplikace Excel umožňuje uživatelům změnit název tabulky aplikace Excel v době běhu pomocí Návrh kartu.Nicméně ListObject ovládací prvek nepodporuje tuto funkci.Pokud se uživatel pokusí přejmenovat tabulku aplikace Excel, který odpovídá ListObject, název tabulky aplikace Excel se automaticky vrátí na původní název při uložení sešitu.

Události

Následující události jsou k dispozici ListObject řízení:

Viz také

Sdílet prostřednictvím