Método Range.TextToColumns (Excel)

Analisa uma coluna de células que contêm texto em várias colunas.

Sintaxe

expressão. TextToColumns (Destination, DataType, TextQualifier, ConsecutiveDelimiter, Tab, Semicolon, Comma, Space, Other, OtherChar, FieldInfo, DecimalSeparator, ThousandsSeparator, TrailingMinusNumbers)

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

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
Destination	Opcional	Variantes	Um objeto Range que especifica onde o Microsoft Excel colocará os resultados. Se o intervalo for maior do que uma única célula, a célula superior esquerda será usada.
DataType	Opcional	XlTextParsingType	O formato do texto a ser dividido em colunas.
TextQualifier	Opcional	XlTextQualifier	Especifica se deve usar aspas simples, duplas ou não como o qualificador de texto.
ConsecutiveDelimiter	Opcional	Variantes	True para que o Excel considere delimitadores consecutivos como um delimitador. O valor padrão é False.
Tab	Opcional	Variant	True para ter DataType como xlDelimited e para ter o caractere de tabulação como um delimitador. O valor padrão é False.
Semicolon	Opcional	Variant	True para ter DataType como xlDelimited e para ter o ponto-e-vírgula como um delimitador. O valor padrão é False.
Comma	Opcional	Variant	True para ter DataType como xlDelimited e para ter a vírgula como um delimitador. O valor padrão é False.
Space	Opcional	Variant	True para ter DataType como xlDelimited e para ter o caractere de espaço como um delimitador. O valor padrão é False.
Other	Opcional	Variant	True para ter DataType como xlDelimited e para ter o caractere especificado pelo argumento OtherChar como um delimitador. O valor padrão é False.
OtherChar	Opcional	Variantes	Necessário se o Outro for True; 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.
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	Variant	Números que começam com um sinal de menos.

Valor de retorno

Variant

Comentários

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 original	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)

Use a constante xlEMDFormat da enumeração XlColumnDataType somente se o suporte ao idioma taiwanês estiver instalado e selecionado. A constante xlEMDFormat especifica que datas da era taiwanesa estão sendo usadas.

Os especificadores de coluna podem estar em qualquer ordem. Se um determinado especificador de coluna não estiver presente para uma coluna específica nos dados de entrada, a coluna será analisada com a configuração xlGeneralFormat . Este exemplo faz com que a terceira coluna seja ignorada, a primeira coluna seja analisada como texto e as colunas restantes nos dados de origem sejam analisadas com a configuração xlGeneralFormat.

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

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

O exemplo a seguir analisa duas colunas de um arquivo de largura fixa, com a primeira coluna desde o início da linha e se estendendo por 10 caracteres. A segunda coluna começa na posição 15 e prossegue até o fim da linha. Para evitar a inclusão dos caracteres entre a posição 10 e a posição 15, o Microsoft Excel adiciona uma entrada de coluna ignorada.

Array(Array(0, 1), Array(10, 9), Array(15, 1))

Exemplo

Este exemplo converte o conteúdo da Área de transferência, uma tabela de texto delimitado por espaço, em colunas separadas na Planilha1. Você pode criar uma tabela simples delimitada no Bloco de Notas ou no WordPad (ou em outro editor de texto), copiar a tabela de texto para a Área de Transferência, alternar para o Microsoft Excel e executar esse exemplo.

Worksheets("Sheet1").Activate 
ActiveSheet.Paste 
Selection.TextToColumns DataType:=xlDelimited, _ 
 ConsecutiveDelimiter:=True, Space:=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.