Método Workbook.SaveAs (Excel)

Salva alterações feitas na pasta de trabalho em um arquivo diferente.

Observação

Interessado em desenvolver soluções que ampliem a experiência do Office em várias plataformas? Confira o novo modelo de Suplementos do Office. Os suplementos do Office ocupam um pequeno espaço em comparação com os suplementos e as soluções do VSTO, e você pode criá-los usando quase qualquer tecnologia de programação da Web, como o HTML5, JavaScript, CSS3 e XML.

Sintaxe

expressão. SaveAs (FileName, FileFormat, Password, WriteResPassword, ReadOnlyRecommended, CreateBackup, AccessMode, ConflictResolution, AddToMru, TextCodepage, TextVisualLayout, Local)

expressão Uma variável que representa um objeto de Livro .

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
FileName	Opcional	Variant	Uma cadeia de caracteres que indica o nome do arquivo a ser salvo. Você pode incluir um caminho completo; se não fizer isso, o Microsoft Excel salvará o arquivo na pasta atual.
FileFormat	Opcional	Variant	O formato do arquivo a ser usado quando você salvar o arquivo. Para obter uma lista de opções válidas, veja a enumeração XlFileFormat . Para um arquivo existente, o formato padrão será o último formato de arquivo especificado; para um novo arquivo, o padrão será o formato da versão do Excel usada.
Password	Opcional	Variant	Uma cadeia de caracteres que diferencia maiúsculas de minúsculas (até 15 caracteres) que indica a senha de proteção a ser dada ao arquivo.
WriteResPassword	Opcional	Variant	Uma cadeia de caracteres que indica a senha de reserva de gravação para este arquivo. Se um arquivo for salvo com a senha e se a senha não for fornecida quando o arquivo for aberto, o arquivo será aberto como somente leitura.
ReadOnlyRecommended	Opcional	Variant	True para exibir uma mensagem quando o arquivo for aberto, recomendando que o arquivo seja aberto como somente leitura.
CreateBackup	Opcional	Variant	True para criar um arquivo de backup.
AccessMode	Opcional	XlSaveAsAccessMode	O modo de acesso para a pasta de trabalho.
ConflictResolution	Opcional	XlSaveConflictResolution	Um valor XlSaveConflictResolution que determina como o método resolve um conflito ao guardar o livro. Se eu definir como xlUserResolution, a caixa de diálogo de resolução de conflito será exibida. Se você definir como xlLocalSessionChanges, as alterações do usuário local serão automaticamente aceitas. Se definido como xlOtherSessionChanges, as alterações de outras sessões serão automaticamente aceitas em vez das alterações do usuário local. Se esse argumento for omitido, a caixa de diálogo de resolução de conflito será exibida.
AddToMru	Opcional	Variant	True para adicionar esta pasta de trabalho à lista de arquivos usados recentemente. O valor padrão é False.
TextCodepage	Opcional	Variant	Ignorado por todos os idiomas no Microsoft Excel. NOTA: quando o Excel guarda um livro num dos formatos CSV ou de texto, que são especificados através do parâmetro FileFormat , utiliza a página de código que corresponde ao idioma da região do sistema em utilização no computador atual. Esta definição de sistema está disponível no separador Painel de Controle>Região eLocalização do Idioma > em Localização atual.
TextVisualLayout	Opcional	Variant	Ignorado por todos os idiomas no Microsoft Excel. NOTA: quando o Excel guarda um livro num dos formatos CSV ou de texto, que são especificados através do parâmetro FileFormat , guarda estes formatos no esquema lógico. Se o texto da esquerda para a direita (LTR) é inserido dentro do texto da direita para a esquerda (RTL) no arquivo ou vice-versa, o layout lógico salva o conteúdo do arquivo na ordem de leitura correta para todos os idiomas no arquivo sem se preocupar com a direção. Quando uma aplicação abre o ficheiro, cada execução de carateres LTR ou RTL é composta na direção correta de acordo com os intervalos de valores de carateres na página de código (a menos que seja utilizada uma aplicação concebida para apresentar o esquema de memória exato do ficheiro, como um depurador ou editor, para abrir o ficheiro).
Local	Opcional	Variant	True salva arquivos no idioma do Microsoft Excel (incluindo as configurações do painel de controle). False (padrão) salva arquivos no idioma do Visual Basic for Applications (VBA) (que normalmente será Inglês (Estados Unidos), a menos que o projeto VBA de onde Workbooks.Open é executado seja um antigo projeto internacionalizado do VBA XL5/95).

Comentários

Use strong passwords that combine uppercase and lowercase letters, numbers, and symbols. As enhas fracas não combinam esses elementos.

• Palavra-passe segura: Y6dh!et5
• Palavra-passe fraca: Casa27

Use uma senha fraca para que você possa lembrá-la sem precisar escrevê-la.

Exemplo

Este exemplo cria uma nova pasta de trabalho, solicita um nome de arquivo do usuário e então salva a pasta de trabalho.

Set NewBook = Workbooks.Add 
Do 
    fName = Application.GetSaveAsFilename 
Loop Until fName <> False 
NewBook.SaveAs Filename:=fName

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.