Salvare documenti a livello di codice
Esistono diversi modi per salvare i documenti di Microsoft Office Word. È possibile salvare un documento senza modificare il nome del documento oppure salvare un documento con un nuovo nome.
Si applica a: le informazioni contenute in questo argomento si applicano ai progetti a livello di documento e ai progetti di componente aggiuntivo VSTO per Word. Per altre informazioni, vedere Funzionalità disponibili per app Office lication e tipo di progetto.
Salvare un documento senza modificare il nome
Per salvare il documento associato a una personalizzazione a livello di documento
Chiamare il metodo Save della classe Document . Per usare questo esempio di codice, eseguirlo dalla classe
ThisDocument
nel progetto.
Per salvare il documento attivo
Chiamare il Save metodo per il documento attivo. Per usare questo esempio di codice, eseguirlo dalla classe
ThisDocument
oThisAddIn
nel progetto.Se non si è certi che il documento che si desidera salvare sia il documento attivo, è possibile farvi riferimento in base al nome.
Per salvare un documento specificato in base al nome
Utilizzare il nome del documento come argomento per l'insieme Documents . Per usare questo esempio di codice, eseguirlo dalla classe
ThisDocument
oThisAddIn
nel progetto.
Salvare un documento con un nuovo nome
Utilizzare il SaveAs
metodo per salvare un documento con un nuovo nome. È possibile utilizzare questo metodo dell'elemento Document host in un progetto Word a livello di documento o di un oggetto nativo Document in qualsiasi progetto di Word. Questo metodo richiede di specificare il nuovo nome file, ma altri argomenti sono facoltativi.
Nota
Se viene visualizzata la finestra di dialogo SaveAs all'interno del gestore eventi DocumentBeforeSave di ThisDocument
e si imposta il parametro Cancel su false, l'applicazione potrebbe uscire in modo imprevisto. Se si imposta il parametro Cancel su true, viene visualizzato un messaggio di errore che indica che il salvataggio automatico è stato disabilitato.
Per salvare il documento associato a una personalizzazione a livello di documento con un nuovo nome
Chiamare il
SaveAs
metodo dellaThisDocument
classe nel progetto usando un percorso completo e un nome di file. Se un file con quel nome già esiste in quella cartella, viene sovrascritto senza avvisare. Per usare questo esempio di codice, eseguirlo dalla classeThisDocument
.Nota
Il
SaveAs
metodo genera un'eccezione se una directory di destinazione non esiste o se sono presenti altri problemi durante il salvataggio di un file. È consigliabile usare untry...catch
blocco intorno alSaveAs
metodo o all'interno di un metodo chiamante.
Per salvare un documento nativo con un nuovo nome
Chiamare il SaveAs metodo dell'oggetto Document che si desidera salvare usando un percorso completo e un nome di file. Se un file con quel nome già esiste in quella cartella, viene sovrascritto senza avvisare.
Nell'esempio di codice seguente il documento attivo viene salvato con un nuovo nome. Per usare questo esempio di codice, eseguirlo dalla classe
ThisDocument
oThisAddIn
nel progetto.Nota
Il SaveAs metodo genera un'eccezione se una directory di destinazione non esiste o se sono presenti altri problemi durante il salvataggio di un file. È buona norma usare un tentativo... blocco catch intorno al SaveAs metodo o all'interno di un metodo chiamante.
object fileName = @"C:\Test\NewDocument.docx"; this.Application.ActiveDocument.SaveAs(ref fileName, ref missing, ref missing, ref missing, ref missing, ref missing, ref missing, ref missing, ref missing, ref missing, ref missing, ref missing, ref missing, ref missing, ref missing, ref missing);
Compilare il codice
Questo esempio di codice presenta i requisiti seguenti:
Per salvare un documento in base al nome, un documento denominato NewDocument.doc deve esistere in una directory denominata Test on drive C.
Per salvare un documento con un nuovo nome, è necessario che nell'unità C esista una directory denominata Test .