Condividi tramite

Salvare documenti a livello di codice

  • Articolo

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

  1. Chiamare il metodo Save della classe Document . Per usare questo esempio di codice, eseguirlo dalla classe ThisDocument nel progetto.

    this.Save();

Per salvare il documento attivo

  1. Chiamare il Save metodo per il documento attivo. Per usare questo esempio di codice, eseguirlo dalla classe ThisDocument o ThisAddIn nel progetto.

    this.Application.ActiveDocument.Save();

    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

  1. Utilizzare il nome del documento come argomento per l'insieme Documents . Per usare questo esempio di codice, eseguirlo dalla classe ThisDocument o ThisAddIn nel progetto.

    this.Application.Documents[@"C:\Test\NewDocument.docx"].Save();

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

  1. Chiamare il SaveAs metodo della ThisDocument 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 classe ThisDocument .

    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 un try...catch blocco intorno al SaveAs metodo o all'interno di un metodo chiamante.

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

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

  1. 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 o ThisAddIn 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 .

Contenuto correlato