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. Abrir (FileName, UpdateLinks, ReadOnly, Format, Password, WriteResPassword, IgnoreReadOnlyRecommended, Origin, Delilimiter, 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 | Variantes | Especifica a forma como as referências externas (links) no arquivo, como a referência a um intervalo na pasta de trabalho Budget.xls na fórmula =SUM([Budget.xls]Annual!C10:C25) a 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 o 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, o Microsoft Excel gera gráficos dos grafos 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 | Variantes | Se o arquivo for um arquivo de texto e o argumento Formatar for 6, esse argumento será uma cadeia de caracteres que especifica o caractere a ser usado como delimitador. 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 | Variantes | 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 | Variantes | 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 de 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 pasta de trabalho 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 de forma programática.
Você pode especificar um dos seguintes valores no parâmetro UpdateLinks para determinar se as referências externas (links) são atualizadas quando a pasta 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 Formatar para determinar o caractere delimitador 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.