Sdílet prostřednictvím

Ukládaní dat do mezipaměti

  • Č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 těchto aplikacích: Excel 2013 a Excel 2010; Word 2013 a Word 2010. Další informace najdete v tématu Dostupné funkce podle aplikací systému 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 dokumentech 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 Přehled vlastních čá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 a návody k vývoji pro systém Office.

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 Postupy: Ukládání dat do mezipaměti v dokumentu chráněném 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 dokumentech na serveru.

Viz také

Úkoly

Postupy: Ukládání dat do mezipaměti pro použití v režimu offline nebo na serveru

Postupy: Ukládání zdroje dat v dokumentu systému Office do mezipaměti prostřednictvím kódu programu

Postupy: Ukládání dat do mezipaměti v dokumentu chráněném heslem

Návod: Vytvoření vztahu seznam-podrobnosti s použitím datové sady v mezipaměti