Procedura: salvare documenti

Articolo
04/28/2010

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 Progetti a livello di applicazione Versione Microsoft Office Word 2003 Word 2007 Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione.

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
Progetti a livello di applicazione

Versione Microsoft Office

Word 2003
Word 2007

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

Esistono molti modi per salvare i documenti di Microsoft Office Word. È possibile salvare un documento senza modificarne il nome oppure con un nome nuovo.

Salvataggio di un documento senza modificarne il nome

Per salvare il documento associato a una personalizzazione a livello di documento

Chiamare il metodo Save della classe Microsoft.Office.Tools.Word.Document. Per utilizzare questo esempio di codice, eseguirlo dalla classe ThisDocument nel progetto.
```
Me.Save()
```
```
this.Save();
```

Per salvare il documento attivo

Chiamare il metodo _Document.Save del documento attivo. Per utilizzare questo esempio di codice, eseguirlo dalla classe ThisDocument o ThisAddIn nel progetto.
```
Me.Application.ActiveDocument.Save()
```
```
this.Application.ActiveDocument.Save();
```

Se non si è certi che il documento da salvare sia il documento attivo, è possibile farvi riferimento utilizzandone il nome.

Per salvare un documento specificato mediante il nome

Utilizzare il nome del documento come argomento per l'insieme Documents. Per utilizzare questo esempio di codice, eseguirlo dalla classe ThisDocument o ThisAddIn nel progetto.
```
Me.Application.Documents("C:\Test\NewDocument.doc").Save()
```
```
object fileName = @"C:\Test\NewDocument.doc"; 
this.Application.Documents.get_Item(ref fileName).Save(); 
```

Salvataggio di un documento con un nuovo nome

Utilizzare il metodo SaveAs per salvare un documento con un nuovo nome. È possibile utilizzare questo metodo dell'elemento host Microsoft.Office.Tools.Word.Document in un progetto Word a livello di documento o di un oggetto nativo Microsoft.Office.Interop.Word.Document in qualsiasi progetto Word. Questo metodo richiede che si specifichi il nuovo nome di file, mentre gli altri argomenti sono facoltativi.

Nota:
Se si visualizza la finestra di dialogo SaveAs all'interno del gestore eventi DocumentBeforeSave di ThisDocument e si imposta il parametro Cancel su false, l'applicazione potrebbe essere chiusa in modo imprevisto. Se si imposta il parametro Cancel su true, un messaggio di errore indicherà che è stata disattivata la funzione di salvataggio automatico.

Per salvare il documento associato a una personalizzazione a livello di documento con un nuovo nome

Chiamare il metodo SaveAs della classe Microsoft.Office.Tools.Word.Document, utilizzando un nome file e un percorso completo. Se nella stessa cartella è già presente un file con lo stesso nome, tale file verrà sovrascritto automaticamente. Per utilizzare questo esempio di codice, eseguirlo dalla classe ThisDocument nel progetto.

Nota:
Se la directory di destinazione non esiste o si verificano altri problemi durante il salvataggio di un file, il metodo SaveAs genera un'eccezione. È opportuno utilizzare un blocco try…catch per racchiudere il metodo SaveAs o all'interno di un metodo chiamante.

Me.SaveAs("C:\Test\NewDocument.doc")

object fileName = @"C:\Test\NewDocument.doc"; 

this.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);

Per salvare un documento nativo con un nuovo nome

Chiamare il metodo SaveAs dell'oggetto Microsoft.Office.Interop.Word.Document che si desidera salvare, utilizzando un nome file e un percorso completo. Se nella stessa cartella è già presente un file con lo stesso nome, tale file verrà sovrascritto automaticamente.

Nell'esempio di codice riportato di seguito viene salvato il documento attivo con un nuovo nome. Per utilizzare questo esempio di codice, eseguirlo dalla classe ThisDocument o ThisAddIn nel progetto.

Nota:
Se la directory di destinazione non esiste o si verificano altri problemi durante il salvataggio di un file, il metodo SaveAs genera un'eccezione. È opportuno utilizzare un blocco try…catch per racchiudere il metodo SaveAs o all'interno di un metodo chiamante.

Me.Application.ActiveDocument.SaveAs("C:\Test\NewDocument.doc")

object fileName = @"C:\Test\NewDocument.doc";

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);

Compilazione del codice

Di seguito sono indicati i requisiti di questo esempio di codice:

Per salvare un documento con il nome, è necessario che sull'unità C sia presente un documento denominato NewDocument.doc in una directory denominata Test.
Per salvare un documento con un nuovo nome, è necessario che sull'unità C sia presente una directory denominata Test.