Sdílet prostřednictvím

Ukládání dat

  • Článek

Datové objekty v dokumentu úroveň přizpůsobení můžete mezipaměti, aby byla data přístupná offline nebo bez otevření aplikace Microsoft Office Word nebo Microsoft Office Excel.Do mezipaměti objektu, objekt musí mít typ dat, který splňuje určité požadavky.Mnoho běžných datových typů v rozhraní.NET Framework splňují tyto požadavky, včetně String, DataSet, a DataTable.

Platí pro: Informace v tomto tématu se vztahují na projekty na úrovni dokumentu v následujících aplikacích: Excel 2013 a Excel 2010, Word 2013 a Word 2010. Další informace naleznete v tématu Funkce aplikace Office a typ projektu.

Přidání objektu do mezipaměti data dvěma způsoby:

Po přidání objektu do mezipaměti data můžete přistupovat a upravit data v mezipaměti bez spuštění aplikace Word nebo Excel.Další informace naleznete v tématu Přístup k datům v dokumenty na serveru.

Požadavky pro datové objekty v mezipaměti

Do mezipaměti data objektu ve vašem řešení, objekt musí splňovat tyto požadavky:

  • Být zápisu veřejné pole nebo vlastnosti položky hostitel, jako ThisDocument nebo ThisWorkbook třídy.

  • Být ostatní parametrizované vlastnost nebo indexovací člen.

Kromě toho musí být serializovatelný podle data objektu XmlSerializer znamená typ objektu třídy musí mít tyto vlastnosti:

  • Být veřejným typem.

  • Máte veřejný konstruktor bez parametrů.

  • Nelze spustit kód, který vyžaduje další oprávnění.

  • Vystavit pouze pro čtení a zápis veřejné vlastnosti (ostatní vlastnosti budou ignorována).

  • Nelze vystavit Vícerozměrná pole (vnořených polí jsou přijímány).

  • Z polí a vlastnosti nevrací rozhraní.

  • Neimplementuje IDictionary Pokud kolekce.

Pokud mezipaměti datový objekt Visual Studio Tools for Office runtime serializuje do řetězce XML uložené v objektu vlastní část XML v dokumentu.Další informace naleznete v tématu Vlastní přehled částí XML.

Omezení velikosti mezipaměti dat

Existují určitá omezení pro celkové množství dat, které lze přidat do mezipaměti data v dokumentu a velikost všech jednotlivých objektů v mezipaměti data.Pokud tato omezení překročí, může aplikace neočekávaně ukončit při ukládání dat do mezipaměti data.

Aby tyto limity, postupujte podle těchto pokynů:

  • Nepřidávejte do mezipaměti data libovolného objektu, který je větší než 10 MB.

  • Nepřidávejte celkem více než 100 MB mezipaměti dat v jednom dokumentu.

Jsou přibližné hodnoty.Přesné limity závisí na několika faktorech včetně dostupné paměti RAM a počet spuštěných procesů.

Ovládání chování mezipaměti objektů

Můžete získat větší kontrolu nad chování objektu v mezipaměti, můžete implementovat ICachedType rozhraní typu objektu v mezipaměti.Pokud chcete řídit, jak je uživatel upozorněn při změně objektu například můžete implementovat toto rozhraní.Příklady kódu, které ukazují, jak implementovat ICachedType, najdete ControlCollection třídy v dynamické ovládací prvky Ukázka aplikace Excel a Word dynamické ovládací prvky vzorku v Ukázky vývoje Office a návody.

Trvalý změny dat v mezipaměti v dokumenty chráněné heslem

Pokud ukládáte do mezipaměti datové objekty v dokumentu, který je chráněn heslem, nebudou uloženy změny dat v mezipaměti.Změny můžete uložit data v mezipaměti přepsáním dvě metody.Přepsat tyto metody dočasně odebrat ochranu při uložení dokumentu a potom znovu ochranu po uložení je operace dokončena.

Další informace naleznete v tématu Jak: Data v mezipaměti v dokumentu chráněného heslem.

Zabránění ztrátě dat při přidávání hodnoty Null do mezipaměti Data

Při přidání objektů do mezipaměti data všech objektů v mezipaměti musí být inicializována na hodnotu než-null hodnota před uložení a zavření dokumentu.Pokud má libovolný objekt v mezipaměti null hodnotu po uložení a zavření dokumentu Visual Studio Tools for Office runtime automaticky odebere všechny objekty v mezipaměti z mezipaměti data.

Pokud přidáte objekt s null mezipaměť dat pomocí hodnoty CachedAttribute atribut v době návrhu můžete použít ServerDocument třída inicializovat data uložená v mezipaměti objektů před otevřením dokumentu.To je užitečné, pokud chcete inicializovat data uložená v mezipaměti na serveru bez aplikace Word nebo Excel nainstalována před otevřením dokumentu koncovým uživatelem.Další informace naleznete v tématu Přístup k datům v dokumenty na serveru.

Viz také

Úkoly

Jak: Data v mezipaměti pro použití Offline nebo na serveru

Jak: programově mezipaměti zdroj dat v dokumentu sady Office

Jak: Data v mezipaměti v dokumentu chráněného heslem

Názorný postup: Vytváření vztahu seznam–podrobnosti použití mezipaměti objektu Dataset.