Método Workbooks.OpenText (Excel)

Carrega e analisa um arquivo de texto como uma nova pasta de trabalho com uma única planilha contendo os dados do arquivo de texto analisados.

Sintaxe

expressão. OpenText (FileName, Origin, StartRow, DataType, TextQualifier, ConsecutiveDelimiter, Tab, Semicolon, Comma, Space, Other, OtherChar, FieldInfo, TextVisualLayout, DecimalSeparator, ThousandsSeparator, TrailingMinusNumbers, Local)

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

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
FileName	Obrigatório	String	Especifica o nome do arquivo de texto a ser aberto ou analisado.
Origin	Opcional	Variant	Especifica a origem do arquivo de texto. Pode ser uma das seguintes constantes XlPlatform : xlMacintosh, xlWindows ou xlMSDOS. Adicionalmente, poderia ser um inteiro representando o número da página de código da página de código desejada. Por exemplo, "1256" especificaria que a codificação do arquivo de texto de origem é Árabe (Windows). Se esse argumento for omitido, o método usará a configuração atual da opção Origem do Arquivo no Assistente de Importação de Texto.
StartRow	Opcional	Variant	O número da linha na qual o texto começa a ser analisado. O valor padrão é 1.
DataType	Opcional	Variant	Especifica o formato da coluna dos dados no arquivo. Pode ser uma das seguintes constantes XlTextParsingType: xlDelimited ou xlFixedWidth. Se esse argumento não for especificado, o Microsoft Excel tentará determinar o formato da coluna quando abrir o arquivo.
TextQualifier	Opcional	XlTextQualifier	Especifica o qualificador do texto.
ConsecutiveDelimiter	Opcional	Variant	True para ter delimitadores consecutivos considerados como um delimitador. O padrão é False.
Tab	Opcional	Variant	True para que o caractere de tabulação seja o delimitador (DataType deve ser xlDelimited). O valor padrão é False.
Semicolon	Opcional	Variant	True para que o caractere de ponto e vírgula seja o delimitador (DataType deve ser xlDelimited). O valor padrão é False.
Comma	Opcional	Variant	True para que o caractere de vírgula seja o delimitador (DataType deve ser xlDelimited). O valor padrão é False.
Space	Opcional	Variant	True para que o caractere de espaço seja o delimitador (DataType deve ser xlDelimited). O valor padrão é False.
Other	Opcional	Variantes	True para que o caractere especificado pelo argumento OtherChar seja o delimitador (DataType deve ser xlDelimited). O valor padrão é False.
OtherChar	Opcional	Variantes	Necessário se o Outro for True. Especifica o caractere delimitador quando Outro é True. Se mais de um caractere for especificado, somente o primeiro caractere da cadeia de caracteres será usado; os caracteres restantes será ignorado.
FieldInfo	Opcional	Variant	Uma matriz com informações de análise para colunas de dados individuais. A interpretação depende do valor do DataType. Quando os dados forem delimitados, esse argumento será uma matriz de matrizes de dois elementos, com cada matriz de dois elementos especificando as opções de conversão para uma coluna em particular. O primeiro elemento é o número de coluna (baseado em 1) e o segundo elemento é uma das constantes XlColumnDataType especificando como a coluna é analisada.
TextVisualLayout	Opcional	Variant	O layout visual do texto.
DecimalSeparator	Opcional	Variant	O separador decimal que o Microsoft Excel usa ao reconhecer números. A configuração padrão é a configuração do sistema.
ThousandsSeparator	Opcional	Variant	O separador de milhares que o Excel usa ao reconhecer números. A configuração padrão é a configuração do sistema.
TrailingMinusNumbers	Opcional	Variantes	Especifique True se os números com um caractere de menos no final devem ser tratados como números negativos. Se for False ou se for omitido, os números com um caractere de menos no final serão tratados como texto.
Local	Opcional	Variantes	Especifique True se as configurações regionais do computador devem ser usadas para separadores, números e formatação de dados.

Comentários

Parâmetro FieldInfo

Use xlEMDFormat somente se você tiver instalado e selecionado o suporte ao idioma taiwanês. A constante xlEMDFormat especifica que datas da era taiwanesa estão sendo usadas.

Os especificadores de coluna podem estar em qualquer ordem. Se não houver um especificador de coluna para uma coluna em particular nos dados de entrada, a coluna será analisada com a configuração Geral.

Este exemplo faz com que a terceira coluna seja analisada como MDA (por exemplo, 01/10/1970), a primeira coluna seja analisada como texto,e as colunas restantes nos dados de origem sejam analisadas com a configuração Geral.

Array(Array(3, 3), Array(1, 2))

Se os dados de origem tiverem colunas de largura fixa, o primeiro elemento em cada matriz de dois elementos especificará a posição do caractere inicial na coluna (como um inteiro; o caractere 0 (zero) será o primeiro caractere). O segundo elemento da matriz de dois elementos especifica a opção de análise para a coluna como um número entre 0 e 9, como listado na tabela anterior.

Parâmetro ThousandsSeparator

A tabela a seguir mostra os resultados da importação de texto para o Excel para diversas configurações de importação. Os resultados numéricos são exibidos na coluna mais à direita.

Separador do sistema decimal	Separador de milhares do sistema	Valor do separador decimal	Valor do separador de milhares	Texto importado	Valor da célula (tipo de dados)
Period	Ponto	Ponto	Ponto	123,123.45	123.123,45 (numérico)
Ponto	Ponto	Ponto	Ponto	123,123.45	123.123,45 (texto)
Ponto	Ponto	Ponto	Ponto	123,123.45	123.123,45 (numérico)
Ponto	Ponto	Ponto	Ponto	123 123,45	123 123,45 (texto)
Ponto	Ponto	Ponto	Espaço	123 123,45	123.123,45 (numérico)

Exemplo

Este exemplo abre o arquivo Dados.txt e usa delimitadores de tabulação para analisar o arquivo de texto em uma planilha.

Workbooks.OpenText filename:="DATA.TXT", _ 
    dataType:=xlDelimited, tab:=True

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.