Método Workbook.SaveAs (Excel)Workbook.SaveAs method (Excel)

Salva alterações feitas na pasta de trabalho em um arquivo diferente.Saves changes to the workbook in a different file.

Observação

Interessado em desenvolver soluções que ampliem a experiência do Office em várias plataformas?Interested in developing solutions that extend the Office experience across multiple platforms? Confira o novo modelo de Suplementos do Office.Check out the new Office Add-ins model. Os suplementos do Office têm um pequeno espaço comparado aos suplementos e soluções do VSTO, e você pode criá-los usando quase qualquer tecnologia de programação Web, como HTML5, JavaScript, CSS3 e XML.Office Add-ins have a small footprint compared to VSTO Add-ins and solutions, and you can build them by using almost any web programming technology, such as HTML5, JavaScript, CSS3, and XML.

SintaxeSyntax

expressão. SaveAs (Filename, __ FileFormat, password, WriteResPassword, ReadOnlyRecommended, CreateBackup, AccessMode, ConflictResolution, AddToMru, __ textcodepage __ , TextVisualLayout, local)expression.SaveAs (FileName, FileFormat, Password, WriteResPassword, ReadOnlyRecommended, CreateBackup, AccessMode, ConflictResolution, AddToMru, TextCodepage, TextVisualLayout, Local)

expressão Uma variável que representa um objeto Workbook .expression A variable that represents a Workbook object.

ParâmetrosParameters

NomeName Obrigatório/OpcionalRequired/Optional Tipo de dadosData type DescriçãoDescription
FileNameFileName OpcionalOptional VariantVariant Uma cadeia de caracteres que indica o nome do arquivo a ser salvo.A string that indicates the name of the file to be saved. Você pode incluir um caminho completo; se não fizer isso, o Microsoft Excel salvará o arquivo na pasta atual.You can include a full path; if you don't, Microsoft Excel saves the file in the current folder.
FileFormatFileFormat OpcionalOptional VariantVariant O formato do arquivo a ser usado quando você salvar o arquivo.The file format to use when you save the file. Para obter uma lista de opções válidas, consulte a enumeração XlFileFormat .For a list of valid choices, see the XlFileFormat enumeration. 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.For an existing file, the default format is the last file format specified; for a new file, the default is the format of the version of Excel being used.
PasswordPassword OpcionalOptional VariantVariant 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.A case-sensitive string (no more than 15 characters) that indicates the protection password to be given to the file.
WriteResPasswordWriteResPassword OpcionalOptional VariantVariant Uma cadeia de caracteres que indica a senha de reserva de gravação para este arquivo.A string that indicates the write-reservation password for this file. 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.If a file is saved with the password and the password isn't supplied when the file is opened, the file is opened as read-only.
ReadOnlyRecommendedReadOnlyRecommended OpcionalOptional VariantVariant True para exibir uma mensagem quando o arquivo for aberto, recomendando que o arquivo seja aberto como somente leitura.True to display a message when the file is opened, recommending that the file be opened as read-only.
CreateBackupCreateBackup OpcionalOptional VariantVariant True para criar um arquivo de backup.True to create a backup file.
AccessModeAccessMode OpcionalOptional XlSaveAsAccessModeXlSaveAsAccessMode O modo de acesso para a pasta de trabalho.The access mode for the workbook.
ConflictResolutionConflictResolution OpcionalOptional XlSaveConflictResolutionXlSaveConflictResolution Um valor XlSaveConflictResolution que determina como o método resolve um conflito ao salvar a pasta de trabalho.An XlSaveConflictResolution value that determines how the method resolves a conflict while saving the workbook. Se eu definir como xlUserResolution, a caixa de diálogo de resolução de conflito será exibida.If set to xlUserResolution, the conflict-resolution dialog box is displayed.

Se você definir como xlLocalSessionChanges, as alterações do usuário local serão automaticamente aceitas.If set to xlLocalSessionChanges, the local user's changes are automatically accepted.

Se definido como xlOtherSessionChanges, as alterações de outras sessões serão automaticamente aceitas em vez das alterações do usuário local.If set to xlOtherSessionChanges, the changes from other sessions are automatically accepted instead of the local user's changes.

Se esse argumento for omitido, a caixa de diálogo de resolução de conflito será exibida.If this argument is omitted, the conflict-resolution dialog box is displayed.
AddToMruAddToMru OpcionalOptional VariantVariant True para adicionar esta pasta de trabalho à lista de arquivos usados recentemente.True to add this workbook to the list of recently used files. O valor padrão é False.The default value is False.
TextCodepageTextCodepage OpcionalOptional VariantVariant Ignorado por todos os idiomas no Microsoft Excel.Ignored for all languages in Microsoft Excel.

Observação: quando o Excel salva uma pasta de trabalho em um dos formatos CSV ou de texto, que são especificados __ usando o parâmetro FileFormat, ele usa a página de código que corresponde ao idioma para a localidade do sistema em uso no computador atual.NOTE: When Excel saves a workbook to one of the CSV or text formats, which are specified by using the FileFormat parameter, it uses the code page that corresponds to the language for the system locale in use on the current computer. Essa configuração de sistema está disponível na guia região do painel > de controle e > local do idioma em local atual.This system setting is available in the Control Panel > Region and Language > Location tab under Current location.
TextVisualLayoutTextVisualLayout OpcionalOptional VariantVariant Ignorado por todos os idiomas no Microsoft Excel.Ignored for all languages in Microsoft Excel.

Observação: quando o Excel salva uma pasta de trabalho em um dos formatos CSV ou de texto, que são especificados __ usando o parâmetro FileFormat, ele salva esses formatos no layout lógico.NOTE: When Excel saves a workbook to one of the CSV or text formats, which are specified by using the FileFormat parameter, it saves these formats in logical layout. 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.If left-to-right (LTR) text is embedded within right-to-left (RTL) text in the file, or vice versa, logical layout saves the contents of the file in the correct reading order for all languages in the file without regard to direction. Quando um aplicativo abre o arquivo, cada execução de caracteres EPD ou DPE é renderizada na direção correta de acordo com os intervalos de valores de caracteres dentro da página de código (a menos que um aplicativo projetado para exibir o layout exato da memória do arquivo, como um o depurador ou editor é usado para abrir o arquivo).When an application opens the file, each run of LTR or RTL characters are rendered in the correct direction according to the character value ranges within the code page (unless an application that is designed to display the exact memory layout of the file, such as a debugger or editor, is used to open the file).
LocalLocal OpcionalOptional VariantVariant True salva arquivos no idioma do Microsoft Excel (incluindo as configurações do painel de controle).True saves files against the language of Microsoft Excel (including control panel settings). 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).False (default) saves files against the language of Visual Basic for Applications (VBA) (which is typically US English unless the VBA project where Workbooks.Open is run from is an old internationalized XL5/95 VBA project).

ComentáriosRemarks

Use strong passwords that combine uppercase and lowercase letters, numbers, and symbols.Use strong passwords that combine uppercase and lowercase letters, numbers, and symbols. Weak passwords don't mix these elements.Weak passwords don't mix these elements.

  • Senha forte: Y6dh! et5Strong password: Y6dh!et5
  • Senha fraca: House27Weak password: House27

Use uma senha fraca para que você possa lembrá-la sem precisar escrevê-la.Use a strong password that you can remember so that you don't have to write it down.

ExemploExample

Este exemplo cria uma nova pasta de trabalho, solicita um nome de arquivo ao usuário e salva a pasta de trabalho.This example creates a new workbook, prompts the user for a file name, and then saves the workbook.

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

Suporte e comentáriosSupport and feedback

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação?Have questions or feedback about Office VBA or this documentation? 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.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.