Condividi tramite


Cenni preliminari sul controllo Runtime Storage

Aggiornamento: novembre 2007

Si applica a

Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati.

Tipo di progetto

  • Progetti a livello di documento

Versione Microsoft Office

  • Microsoft Office 2003

Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione.

Il controllo Runtime Storage è un controllo ActiveX incorporato in un documento o in una cartella di lavoro facente parte di una personalizzazione a livello di documento per Microsoft Office 2003. Contiene le seguenti informazioni richieste dal runtime Visual Studio Tools per Office per l'esecuzione della personalizzazione:

  • Manifesto di applicazione.

  • Zero o più oggetti dati memorizzati nella cache.

Il controllo Runtime Storage viene incorporato nel documento quando si compila il progetto. Non è visibile nel documento in fase di esecuzione.

Nota:

Le personalizzazioni a livello di documento per Microsoft Office System 2007 non utilizzano il controllo Runtime Storage. Il runtime Visual Studio Tools per Office archivia piuttosto le informazioni come web part XML personalizzate incorporate nei documenti.

Manifesto dell'applicazione

Nel manifesto dell'applicazione sono memorizzate le informazioni necessarie all'esecuzione delle estensioni di codice gestito. Il manifesto dell'applicazione fa riferimento a un manifesto di distribuzione nel server, che contiene il più recente percorso dell'assembly, oppure direttamente all'assembly di personalizzazione. Per ulteriori informazioni, vedere la classe Manifesti dell'applicazione e di distribuzione nelle soluzioni di Office.

Dati memorizzati nella cache

È possibile memorizzare nella cache un oggetto dati del documento utilizzando l'attributo CachedAttribute quando si dichiara tale oggetto. Utilizzando la cache si riduce il numero di percorsi di andata e ritorno al server e si rende possibile l'interazione con i dati non in linea. Per ulteriori informazioni, vedere°Cenni preliminari sui dati nelle personalizzazioni a livello di documento e Memorizzazione di dati nella cache.

Eliminazione o copia del controllo Runtime Storage

L'utente finale può eliminare o copiare il controllo Runtime Storage. Negli esempi seguenti vengono illustrate le modalità con cui il runtime Visual Studio Tools per Office rileva e corregge queste circostanze.

L'utente finale utilizza il comando Seleziona tutto e preme Elimina

Il controllo Runtime Storage viene eliminato. Tuttavia, il controllo chiama il runtime Visual Studio Tools per Office con informazioni che stanno per essere eliminate. Il runtime aggiunge una nuova istanza al documento, viene associato al nuovo sink di eventi e fornisce informazioni persistenti.

L'utente finale utilizza il comando Seleziona tutto, quindi Copia e Incolla nello stesso documento

In questo caso vi sono due controlli della memoria di runtime. Tuttavia, il runtime verifica se vi sono più istanze del controllo, nel qual caso vengono eliminate le istanze supplementari.

L'utente finale utilizza il comando Seleziona tutto, quindi Copia e Incolla in un documento diverso con estensioni di codice gestito

Esistono due controlli della memoria di runtime che dichiarano di contenere le informazioni primarie memorizzate per il documento. Tuttavia in fase di progettazione viene creato un identificatore univoco (GUID) per il controllo al momento dell'aggiunta nel documento. Questo GUID viene inoltre incorporato nella proprietà di documento personalizzato _AssemblyLocation. Qualsiasi controllo Runtime Storage contenuto nel documento deve anch'esso avere questo GUID. Se in fase di caricamento viene rilevato un altro controllo Runtime Storage e il GUID non corrisponde a quello memorizzato nel documento, il controllo viene eliminato dal documento

L'utente finale utilizza il comando Seleziona tutto, quindi Copia e Incolla in un nuovo documento vuoto

È disponibile un documento nuovo con un controllo Runtime Storage inutilizzato. Senza la personalizzazione corretta all'interno del documento, il controllo non esegue alcuna operazione, ma occupa comunque spazio nel documento.

Vedere anche

Concetti

Accesso ai dati dei documenti sul server

Memorizzazione di dati nella cache

Riferimenti

Manifesti dell'applicazione per le soluzioni Office (System 2003)

Altre risorse

Architettura di soluzioni Visual Studio Tools per Office