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.