Range.TextToColumns Método

Definição

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

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

public object TextToColumns (object Destination, Microsoft.Office.Interop.Excel.XlTextParsingType DataType = Microsoft.Office.Interop.Excel.XlTextParsingType.xlDelimited, Microsoft.Office.Interop.Excel.XlTextQualifier TextQualifier = Microsoft.Office.Interop.Excel.XlTextQualifier.xlTextQualifierDoubleQuote, object ConsecutiveDelimiter, object Tab, object Semicolon, object Comma, object Space, object Other, object OtherChar, object FieldInfo, object DecimalSeparator, object ThousandsSeparator, object TrailingMinusNumbers);

Public Function TextToColumns (Optional Destination As Object, Optional DataType As XlTextParsingType = Microsoft.Office.Interop.Excel.XlTextParsingType.xlDelimited, Optional TextQualifier As XlTextQualifier = Microsoft.Office.Interop.Excel.XlTextQualifier.xlTextQualifierDoubleQuote, Optional ConsecutiveDelimiter As Object, Optional Tab As Object, Optional Semicolon As Object, Optional Comma As Object, Optional Space As Object, Optional Other As Object, Optional OtherChar As Object, Optional FieldInfo As Object, Optional DecimalSeparator As Object, Optional ThousandsSeparator As Object, Optional TrailingMinusNumbers As Object) As Object

Parâmetros

Destination

Object

Objeto opcional. Um Range objeto 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

XlTextParsingType

Opcional XlTextParsingType. O formato do texto a ser dividido em colunas. Pode ser uma das seguintes constantes XlTextParsingType :xlDelimited defaultxlFixedWidth

TextQualifier

XlTextQualifier

Opcional XlTextQualifier. Pode ser uma das seguintes constantes XlTextQualifier :xlTextQualifierDoubleQuotedefaultxlTextQualifierNonexlTextQualifierSingleQuote

ConsecutiveDelimiter

Object

Objeto opcional. True para que o Microsoft Excel considere delimitadores consecutivos como um delimitador. O valor padrão é False.

Tab

Object

Objeto opcional. True para ter DataType sido xlDelimited e ter o caractere tab ser um delimitador. O valor padrão é False.

Semicolon

Object

Objeto opcional. True para ter DataType sido xlDelimited e ter o ponto e vírgula ser um delimitador. O valor padrão é False.

Comma

Object

Objeto opcional. True para ter DataType sido xlDelimited e ter a vírgula ser um delimitador. O valor padrão é False.

Space

Object

Objeto opcional. True a have DataType be xlDelimited and to have the space character be a delimititer. O valor padrão é False.

Other

Object

Objeto opcional. True para ter DataType sido xlDelimited e ter o caractere especificado pelo OtherChar argumento ser um delimitador. O valor padrão é False.

OtherChar

Object

Objeto opcional (necessário se Other for True). O caractere delimitador quando Other é True. Se mais de um caractere for especificado, somente o primeiro caractere da cadeia de caracteres será usado; os caracteres restantes será ignorado.

FieldInfo

Object

Objeto opcional. Uma matriz com informações de análise para colunas de dados individuais. A interpretação depende do valor de 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 XlColumnDataType constantes que especificam como a coluna é analisada. Pode ser uma das seguintes constantes XlColumnDataType :xlGeneralFormat. Gêneros. xlTextFormat. Texto. xlMDYFormat. Data do MDY. xlDMYFormat. Data DMY. xlYMDFormat. Data do YMD. xlMYDFormat. Data MYD. xlDYMFormat. Data DYM. xlYDMFormat. Data do YDM. xlEMDFormat. Data de EMD. xlSkipColumn. Skip Column.Você só pode usar xlEMDFormat se o suporte ao idioma taiwanês estiver instalado e selecionado. A constante xlEMDFormat especifica que as 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 Geral . 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 para a coluna como um número de 1 a 9, como listado acima.

DecimalSeparator

Object

Cadeia de caracteres opcional. O separador decimal que o Microsoft Excel usa ao reconhecer números. A configuração padrão é a configuração do sistema.

ThousandsSeparator

Object

Cadeia de caracteres opcional. O separador de milhares que o Excel usa ao reconhecer números. A configuração padrão é a configuração do sistema.

TrailingMinusNumbers

Object

Objeto opcional. Números que começam com um sinal de menos.

Retornos

Object

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.

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)