Dela via


Cachelagrade data i anpassade lösningar på dokumentnivå

Ett primärt mål med anpassningar på dokumentnivå är att separera data från vyn i Office-dokument. Data refererar till den information som lagras i dokumentet, inklusive siffror och text. Vyn refererar till användargränssnittet och objektmodellen för Microsoft Office Word och Microsoft Office Excel.

Visual Studio separerar data från vyn i anpassningar på dokumentnivå genom att göra så att data kan bäddas in som en dataö, även kallat datacachen. Du kan läsa eller ändra data direkt utan att starta Word eller Excel. Detta är användbart när du behöver ändra data i dokument på en server som inte har Microsoft Office installerat. Word och Excel är avsedda att användas i klientmiljöer. de är inte utformade för att köras på en server.

Gäller för: Informationen i det här avsnittet gäller för projekt på dokumentnivå för Excel och Word. Mer information finns i Funktioner som är tillgängliga efter Office-program och projekttyp.

Mer information om anpassningar på dokumentnivå finns i Översikt över utveckling av Office-lösningar (VSTO) och Arkitektur för anpassningar på dokumentnivå.

Förstå den cachelagrade dataprogrammeringsmodellen

Dataön kan innehålla alla objekt i din lösning som uppfyller vissa krav. Dessa objekt omfattar DataSet objekt, DataTable objekt och andra objekt som kan serialiseras av XmlSerializer klassen. Mer information finns i Cachedata.

För att visa de cachelagrade data kan du binda Windows Forms-kontroller och hosta kontroller i dokumentet till objekt på dataön. Databindningen mellan dataön och de databundna kontrollerna håller de två synkroniserade. Du kan också lägga till valideringskod till de data som är oberoende av kontrollerna. Mer information finns i Binda data till kontroller i Office-lösningar.

Värdkontroller är utökade versioner av inbyggda objekt i Excel- och Word-objektmodellerna. Till skillnad från de inbyggda objekten kan värdkontroller bindas direkt till hanterade dataobjekt. Mer information finns i Översikt över värdobjekt och värdkontroller och Windows Forms-kontroller i Office-dokument.

Få åtkomst till cachelagrade data på servern

Om du vill komma åt cachelagrade data i ett dokument kan du använda ServerDocument klassen . Den här klassen är en del av Visual Studio Tools for Office-körningen och kan användas på en server utan att köra Excel eller Word. När användaren öppnar dokumentet när du har ändrat cachelagrade data synkroniseras alla kontroller som är bundna till data automatiskt till ändringarna och användaren visas med uppdaterade data. Mer information finns i Åtkomst till data i dokument på servern.

Excel och Word behövs inte för att skriva till data på servern, bara för att visa dem på klienten. Excel och Word behöver inte ens installeras på servern. Detta ger bättre skalbarhet och möjlighet att utföra snabb batchbearbetning av dokument som innehåller dataöar.

Datacachelagring för offlineanvändning

Lagring av data i dataön möjliggör offlinescenarier. När en användare först öppnar ett dokument eller begär dokumentet från servern fylls dataön med de senaste data. Dataön cachelagras i dokumentet och är sedan tillgänglig offline. Användaren (och koden) kan ändra data, även om ingen live-anslutning är tillgänglig. När användaren återansluter kan ändringarna av data spridas tillbaka till en serverdatakälla.

Cachelagrade data och anpassade XML-delar jämfört

Anpassade XML-delar introducerades i Microsoft Office-systemet 2007 som ett sätt att lagra godtyckliga XML-delar i ett dokument. Även om anpassade XML-delar är användbara i många av samma scenarier som datacachen finns det vissa skillnader mellan dataön och anpassade XML-delar. Mer information om anpassade XML-delar finns i Översikt över anpassade XML-delar.

I följande tabell visas några av skillnaderna och likheterna.

Fråga/egenskap Datacache Anpassade XML-delar
Vilka Office-program kan använda dessa? Anpassningar på dokumentnivå för följande program:

- Excel
- Ord
Lösningar på dokumentnivå och programnivå för följande program:

- Excel
– PowerPoint
- Ord
Vilka typer av data kan du lagra? Alla offentliga objekt i anpassningssammansättningen som uppfyller vissa krav. Mer information finns i Cachedata. Alla XML-data.
Kan du komma åt data utan att starta Microsoft Office-program? Ja, med hjälp av klassen ServerDocument som tillhandahålls av Visual Studio Tools for Office-runtime. Ja, med hjälp av klasser i System.IO.Packaging namnområdet eller med hjälp av SDK för Open XML-format.