Partilhar via

Salvar documentos de forma programática

  • Artigo

Existem várias maneiras de salvar documentos do Microsoft Office Word. Você pode salvar um documento sem alterar o nome do documento ou pode salvar um documento com um novo nome.

Aplica-se a: as informações neste tópico se aplicam a projetos no nível de documento e projetos de suplemento VSTO para Word. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e pelo tipo de projeto.

Salvar um documento sem alterar o nome

Para salvar o documento associado a uma personalização no nível do documento

  1. Chame o método Save da classe Document. Para usar este exemplo de código, execute-o a partir da classe ThisDocument em seu projeto.

    this.Save();

Para salvar o documento ativo

  1. Chame o método Save para o documento ativo. Para usar este exemplo de código, execute-o a partir da classe ThisDocument ou ThisAddIn em seu projeto.

    this.Application.ActiveDocument.Save();

    Se você não tiver certeza se o documento que deseja salvar é o documento ativo, poderá referir-se a ele pelo nome.

Para salvar um documento especificado por nome

  1. Use o nome do documento como um argumento para a coleção Documents. Para usar este exemplo de código, execute-o a partir da classe ThisDocument ou ThisAddIn em seu projeto.

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

Salvar um documento com um novo nome

Use o método SaveAs para salvar um documento com um novo nome. Você pode usar esse método do item host Document em um projeto do Word no nível do documento ou de um objeto nativo Document em qualquer projeto do Word. Esse método requer que você especifique o novo nome do arquivo, mas outros argumentos são opcionais.

Observação

Se você exibir a caixa de diálogo SaveAs dentro do manipulador de eventos DocumentBeforeSave de ThisDocument e definir o parâmetro Cancel como falso, o aplicativo poderá ser encerrado inesperadamente. Se você definir o parâmetro Cancel como verdadeiro, uma mensagem de erro será exibida indicando que o salvamento automático foi desabilitado.

Para salvar o documento associado a uma personalização no nível do documento com um novo nome

  1. Chame o método SaveAs da classe ThisDocument em seu projeto, usando um caminho e um nome de arquivo totalmente qualificados. Se um arquivo com esse nome já existir nessa pasta, ele será substituído silenciosamente. Para usar esse exemplo de código, execute-o na classe ThisDocument.

    Observação

    O método SaveAs lançará uma exceção se um diretório de destino não existir ou se houver outros problemas ao salvar um arquivo. É prática recomendada usar um bloco try...catch em torno do método SaveAs ou dentro de um método de chamada.

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

Para salvar um documento nativo com um novo nome

  1. Chame o método SaveAs do Document que você deseja salvar, usando um caminho e um nome de arquivo totalmente qualificados. Se um arquivo com esse nome já existir nessa pasta, ele será substituído silenciosamente.

    O exemplo de código a seguir salva o documento ativo com um novo nome. Para usar este exemplo de código, execute-o a partir da classe ThisDocument ou ThisAddIn em seu projeto.

    Observação

    O método SaveAs lançará uma exceção se um diretório de destino não existir ou se houver outros problemas ao salvar um arquivo. É prática recomendada usar um bloco try...catch em torno do método SaveAs ou dentro de um método de chamada.

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

Compilar o código

Este exemplo de código exige o seguinte:

  • Para salvar um documento por nome, um documento chamado NewDocument.doc deve existir em um diretório chamado Test na unidade C.

  • Para salvar um documento com um novo nome, um diretório chamado Test deve existir na unidade C.

Conteúdo relacionado