WorkbookBase.SaveAs(Object, Object, Object, Object, Object, Object, XlSaveAsAccessMode, Object, Object, Object, Object, Object) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Salva as alterações na pasta de trabalho em um arquivo diferente.
public void SaveAs (object filename, object fileFormat, object password, object writeResPassword, object readOnlyRecommended, object createBackup, Microsoft.Office.Interop.Excel.XlSaveAsAccessMode accessMode, object conflictResolution, object addToMru, object textCodepage, object textVisualLayout, object local);
Parâmetros
- filename
- Object
O nome do arquivo a ser salvo. É possível incluir um caminho completo; caso você não faça isso, o Microsoft Office Excel salva o arquivo na pasta atual.
- fileFormat
- Object
Um dos valores XlFileFormat que especifica o formato de arquivo a ser usado ao salvar o arquivo. Para um arquivo existente, o formato padrão é o último formato de arquivo especificado; para um novo arquivo, o padrão é o formato da versão do Excel que está sendo usado.
- password
- Object
Uma cadeia de caracteres que diferencia maiúsculas de minúsculas (não mais que 15 caracteres) que indica a senha de proteção a ser fornecida para o arquivo.
- writeResPassword
- Object
A senha de proteção contra gravação deste arquivo. Caso um arquivo seja salvo com a senha e a senha não seja fornecida quando o arquivo é aberto, o arquivo é aberto como somente leitura.
- readOnlyRecommended
- Object
true para exibir uma mensagem quando o arquivo é aberto, recomendando que o arquivo seja aberto como somente leitura.
- createBackup
- Object
true para criar um arquivo de backup.
- accessMode
- XlSaveAsAccessMode
Um dos valores de XlSaveAsAccessMode.
- conflictResolution
- Object
Um dos valores de XlSaveConflictResolution.
- addToMru
- Object
true para adicionar esta pasta de trabalho à lista de arquivos usados recentemente. O valor padrão é false.
- textCodepage
- Object
Não usado no Excel em inglês dos EUA.
- textVisualLayout
- Object
Não usado no Excel em inglês dos EUA.
- local
- Object
true salva arquivos com o idioma do Excel (incluindo configurações do painel de controle). false (padrão) salva os arquivos no idioma do VBA (Visual Basic for Applications).
Exemplos
O exemplo de código a seguir verifica o valor da FileFormat propriedade para determinar se a pasta de trabalho é uma pasta de trabalho normal. Se a pasta de trabalho for uma pasta de trabalho normal, o exemplo chamará o SaveAs método para salvar novamente a pasta de trabalho como uma planilha XML com o nome XMLCopy.xlsx no caminho especificado pela Path propriedade.
Este exemplo destina-se a uma personalização no nível de documento.
private void WorkbookSaveAs()
{
if (this.FileFormat == Excel.XlFileFormat.xlWorkbookNormal)
{
this.SaveAs(this.Path + @"\XMLCopy.xml",
Excel.XlFileFormat.xlXMLSpreadsheet,
false, false, Excel.XlSaveAsAccessMode.xlNoChange);
}
}
Private Sub WorkbookSaveAs()
If Me.FileFormat = Excel.XlFileFormat.xlWorkbookNormal Then
Me.SaveAs(Me.Path & "\XMLCopy.xml", _
Excel.XlFileFormat.xlXMLSpreadsheet, _
AccessMode:=Excel.XlSaveAsAccessMode.xlNoChange)
End If
End Sub
Comentários
O Visual Studio não dá suporte à gravação de uma pasta de trabalho como uma pasta de trabalho compartilhada.
Parâmetros opcionais
Para obter informações sobre parâmetros opcionais, consulte parâmetros opcionais em soluções do Office.