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 Workbook .

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, consulte 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 salvar a pasta de trabalho. 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. OBSERVAÇÃO: quando o Excel salva uma pasta de trabalho em um dos formatos CSV ou texto, que são especificados usando o parâmetro FileFormat , ele usa a página de código que corresponde ao idioma da localidade do sistema em uso no computador atual. Essa configuração do sistema está disponível na guia Painel de Controle>Region eLocal de Idioma > em Local atual.
TextVisualLayout	Opcional	Variant	Ignorado por todos os idiomas no Microsoft Excel. OBSERVAÇÃO: quando o Excel salva uma pasta de trabalho em um dos formatos CSV ou texto, que são especificados usando o parâmetro FileFormat , ele salva esses formatos no layout 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 um aplicativo abre o arquivo, cada execução de caracteres LTR ou RTL é renderizada na direção correta de acordo com os intervalos de valor de caractere dentro da página de código (a menos que um aplicativo projetado para exibir o layout de memória exato do arquivo, como um depurador ou editor, seja usado para abrir o arquivo).
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.

• Senha forte: Y6dh!et5
• Senha fraca: House27

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.