Procedura: salvare documenti

Articolo
08/11/2011

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

Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di documento e di applicazione per Word 2007 e Word 2010. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office.

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()
```
```
this.Application.Documents[@"C:\Test\NewDocument.doc"].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 disabilitata 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 ThisDocument nel progetto 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.

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.