Condividi tramite

Modello di progetto Modello di Word

  • Articolo

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

  • Word 2007

  • Word 2003

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

Sul modello di progetto Modello di Word in Visual Basic e Visual C# si fondano le soluzioni basate su modelli nuovi o esistenti di Microsoft Office Word. Sono disponibili diversi modelli di progetto per i modelli di Word 2003 e Word 2007. Nei modelli di progetto vengono aggiunti automaticamente i riferimenti all'assembly, i file e il codice generato necessari, da utilizzare come punto di partenza per la creazione della soluzione.

Non è possibile utilizzare come componenti aggiuntivi globali i modelli di Word che fanno riferimento a estensioni di codice gestito. L'assembly non viene chiamato se il modello viene caricato dalla directory di avvio di Word. Per ulteriori informazioni, vedere la classe Limitazioni dei modelli globali e dei componenti aggiuntivi di Excel (file xla).

Se si apre un modello per modificarlo all'esterno di Visual Studio una volta che la soluzione è stata compilata, il codice verrà eseguito nel modello, in maniera analoga a quanto avviene per la creazione di un nuovo documento da un modello. A seconda del codice, il modello può subire modifiche al momento dell'apertura, prima che inizi la modifica. Per impedire l'esecuzione del codice, tenere premuto il tasto MAIUSC durante l'apertura del modello.

Nota:

Per impostazione predefinita, alcuni dei file e dei riferimenti inclusi nell'elenco seguente sono nascosti. Per visualizzarli, fare clic su Mostra tutti i file sulla barra degli strumenti Esplora soluzioni. Vi sono inoltre alcuni file e riferimenti comuni a molti modelli di progetto di Visual Studio non inclusi nell'elenco.

File

In Visual Studio Tools per Office vengono generati i seguenti file visibili nei progetti modello di Word 2003 e Word 2007:

  • Nome documento: rappresenta il modello di Word in un progetto. Contiene l'area di progettazione del documento e il file di codice.

  • ThisDocument (file VB per Visual Basic o file CS per Visual C#): documento che fornisce l'area di progettazione e il file di codice. Per ulteriori informazioni, vedere la classe Elemento host documento.

Nota:

Non è possibile aggiungere ulteriori classi al file di codice di un documento, di una cartella di lavoro o di un foglio di lavoro. È necessario aggiungere nuovi file al progetto per poter contenere le classi che si intende scrivere.

In Visual Studio Tools per Office, nella compilazione di un progetto modello di Word 2007 viene inoltre generato il file aggiuntivo seguente:

File nascosti

In Visual Studio Tools per Office vengono generati diversi file nascosti. Non modificare manualmente questi file; essi sono rigenerati quando vengono apportate modifiche al progetto e non conservano le modifiche manuali.

In Visual Studio Tools per Office vengono generati i file nascosti seguenti:

  • ThisDocument.Designer.xml - Rappresentazione dichiarativa di sola lettura degli oggetti programmabili nella cartella di lavoro.

  • ThisDocument.Designer (con estensione VB o CS) - File di codice di sola lettura che fornisce implementazioni delle funzioni di supporto per gli oggetti contenuti nel documento, incluso il codice per creare correttamente istanze degli oggetti.

  • Nome documento.Designer.xml - Rappresentazione dichiarativa di sola lettura degli oggetti programmabili come i controlli personalizzati, che per impostazione predefinita non fanno parte di Visual Studio Tools per Office. Il file viene generato in caso di aggiunta di un controllo personalizzato al documento.

  • Nome documento.Designer (con estensione VB o CS) - File di codice di sola lettura che fornisce implementazioni delle funzioni di supporto per controlli personalizzati. Il file viene generato in caso di aggiunta di un controllo personalizzato al documento.

Codice del modello

I gestori eventi riportati di seguito sono inclusi nei file di codice del modello di progetto. Per ulteriori informazioni, vedere Eventi di progetti Visual Studio Tools per Office.

ThisDocument_Startup

ThisDocument_Startup gestisce l'evento Document.Startup. L'evento viene generato dopo l'esecuzione della soluzione e di tutto il codice di inizializzazione incluso nell'assembly. Utilizzare questo gestore eventi per eseguire il codice di inizializzazione della soluzione.

ThisDocument_Shutdown

ThisDocument_Shutdown gestisce l'evento Document.Shutdown. L'evento viene generato quando il dominio dell'applicazione in cui il codice è caricato sta per essere scaricato.

Riferimenti

In Visual Studio Tools per Office viene creato automaticamente un insieme di riferimenti ad assembly nei progetti modello di Word. Nei riferimenti sono inclusi gli assembly seguenti:

Vedere anche

Attività

Procedura: creare progetti Visual Studio Tools per Office

Concetti

Cenni preliminari sugli assembly nelle soluzioni Office

Cenni preliminari sul modello a oggetti di Word

Altre risorse

Gestione di soluzioni, progetti e file

Modelli di progetto di Office