WorkbookBase.SaveAs(Object, Object, Object, Object, Object, Object, XlSaveAsAccessMode, Object, Object, Object, Object, Object) Método

Definição

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.

Aplica-se a