Método Workbooks.Open (Excel)

Abre uma pasta de trabalho.

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. Open (FileName, UpdateLinks, ReadOnly, Format, Password, WriteResPassword, IgnoreReadOnlyRecommended, Origin, Delimiter, Editable, Notify, Converter, AddToMru, Local, CorruptLoad)

expressão Uma variável que representa um objeto Workbooks.

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
FileName Opcional Variant String. O nome de arquivo da pasta de trabalho a ser aberta.
UpdateLinks Opcional Variant Especifica a maneira como referências externas (links) no arquivo, como a referência a um intervalo na pasta de trabalho Budget.xls na fórmula a =SUM([Budget.xls]Annual!C10:C25) seguir, são atualizadas. Se esse argumento for omitido, será solicitado que o usuário especifique como os links serão atualizados. Para saber mais sobre os valores usados por este parâmetro, veja a seção Comentários.

Se Microsoft Excel estiver abrindo um arquivo no formato WKS, WK1 ou WK3 e o argumento UpdateLinks for 0, nenhum gráfico será criado; caso contrário, Microsoft Excel gera gráficos dos gráficos anexados ao arquivo.
ReadOnly Opcional Variant Verdadeiro para abrir a pasta de trabalho em modo somente leitura.
Format Opcional Variant Se o Microsoft Excel abrir um arquivo de texto, esse argumento especificará o caractere delimitador. Se esse argumento for omitido, o delimitador atual será usado. Para saber mais sobre os valores usados por esse parâmetro, veja a seção Comentários.
Password Opcional Variant Uma cadeia de caracteres que contém a senha necessária para abrir uma pasta de trabalho protegida. Se esse argumento for omitido e a pasta de trabalho exigir uma senha, será solicitada a senha do usuário.
WriteResPassword Opcional Variant Uma cadeia de caracteres que contém a senha necessária para gravar uma pasta de trabalho reservada para gravação. Se esse argumento for omitido e se a pasta de trabalho exigir uma senha, a senha será solicitada do usuário.
IgnoreReadOnlyRecommended Opcional Variant True para fazer com que o Microsoft Excel não exiba a mensagem recomendada somente leitura (se a pasta de trabalho tiver sido salva com a opção Somente Leitura Recomendada).
Origin Opcional Variant Se o arquivo for um arquivo de texto, esse argumento indicará onde foi originado, de forma que as páginas de código e o Retorno de Carro/Alimentação de Linha (CR/LF) possam ser mapeadas corretamente. Pode ser uma das seguintes constantes XlPlatform: xlMacintosh, xlWindows ou xlMSDOS. Se esse argumento for omitido, o sistema operacional atual será usado.
Delimitador Opcional Variant Se o arquivo for um arquivo de texto e o argumento Format for 6, esse argumento será uma cadeia de caracteres que especifica o caractere a ser usado como o delimiter. Por exemplo, use Chr(9) para tabulações, use "," para vírgulas, use ";" para ponto-e-vírgulas ou use um caractere personalizado. Somente o primeiro caractere da cadeia de caracteres será usado.
Editable Opcional Variant Se o arquivo for um suplemento do Microsoft Excel 4.0, esse argumento será True para abrir o suplemento, de forma que seja uma janela visível. Se esse argumento for False ou se for omitido, o suplemento será aberto como oculto e não poderá ser reexibido. Essa opção não se aplica a suplementos criados no Microsoft Excel 5.0 ou posterior.

Se o arquivo for um modelo do Excel, True para abrir o modelo especificado para edição. False para abrir uma nova pasta de trabalho com base no modelo especificado. O valor padrão é False.
Notify Opcional Variant Se o arquivo não puder ser aberto em modo leitura/gravação, esse argumento será True para adicionar o arquivo para a lista de notificações de arquivo. O Microsoft Excel abrirá o arquivo como somente leitura, pesquisará a lista de notificações de arquivo e então notificará o usuário quando o arquivo for disponibilizado. Se esse argumento for False ou se for omitido, nenhuma notificação será solicitada e todas as tentativas de abrir um arquivo não disponível falharão.
Converter Opcional Variant O índice do primeiro conversor de arquivos a ser experimentado na abertura do arquivo. O conversor do arquivo especificado será experimentado primeiro; se esse conversor não reconhecer o arquivo, todos os outros conversores serão experimentados. O índice do conversor consiste nos números de linha dos conversores retornados pela propriedade FileConverters.
AddToMru Opcional Variant True para adicionar esta pasta de trabalho à lista de arquivos usados recentemente. O valor padrão é False.
Local Opcional Variant True salva os arquivos na linguagem do Microsoft Excel (incluindo as configurações do painel de controle). False (padrão) salva arquivos na linguagem do Visual Basic for Applications (VBA) (que normalmente é Inglês (Estados Unidos) a menos que o projeto VBA onde Workbooks.Open seja executado de um antigo projeto internacionalizado do VBA XL5/95).
CorruptLoad Opcional XlCorruptLoad Pode ser uma das seguintes constantes: xlNormalLoad, xlRepairFile e xlExtractData. O comportamento padrão se nenhum valor for especificado é xlNormalLoad e não tentará a recuperação quando iniciado por meio do OM.

Valor de retorno

Um objeto Workbook que representa a workbook aberta.

Comentários

Por padrão, as macros são ativadas quando os arquivos são abertos por programação. Use a propriedade AutomationSecurity para definir o modo de segurança de macro usado ao abrir arquivos programaticamente.

Você pode especificar um dos seguintes valores no parâmetro UpdateLinks para determinar se as referências externas (links) são atualizadas quando a lista de trabalho é aberta.

Valor Descrição
0 As referências externas (links) não serão atualizadas quando a pasta de trabalho for aberta.
3 As referências externas (links) serão atualizadas quando a pasta de trabalho for aberta.

Você pode especificar um dos seguintes valores no parâmetro Format para determinar o caractere delimiter do arquivo.

Valor Delimitador
1 Tabulações
2 Vírgulas
3 Espaços
4 Ponto-e-vírgulas
5 Nada
6 Caractere personalizado (veja o argumento Delimitador)

Exemplo

O exemplo de código a seguir abre a pasta de trabalho Análise.xls e então executa sua macro Auto_Open.

Workbooks.Open "ANALYSIS.XLS" 
ActiveWorkbook.RunAutoMacros xlAutoOpen

O exemplo de código a seguir importa uma planilha de outra pasta de trabalho para uma nova planilha na pasta de trabalho atual. A Planilha1 na pasta de trabalho atual deve conter o nome do caminho da pasta de trabalho para importar na célula D3, o nome do arquivo na célula D4 e o nome da pasta de trabalho na célula D5. A pasta de trabalho importada é inserida após a Planilha1 na pasta de trabalho atual.

Sub ImportWorksheet() 
    ' This macro will import a file into this workbook 
    Sheets("Sheet1").Select 
    PathName = Range("D3").Value 
    Filename = Range("D4").Value 
    TabName = Range("D5").Value 
    ControlFile = ActiveWorkbook.Name 
    Workbooks.Open Filename:=PathName & Filename 
    ActiveSheet.Name = TabName 
    Sheets(TabName).Copy After:=Workbooks(ControlFile).Sheets(1) 
    Windows(Filename).Activate 
    ActiveWorkbook.Close SaveChanges:=False 
    Windows(ControlFile).Activate 
End Sub

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.