Range.TextToColumns Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 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 default xlFixedWidth
- TextQualifier
- XlTextQualifier
Opcional XlTextQualifier . Pode ser uma das seguintes constantes XlTextQualifier: xlTextQualifierDoubleQuote default xlTextQualifierNonexlTextQualifierSingleQuote
- 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 de tabulação como um delimiter. O valor padrão é False.
- Semicolon
- Object
Objeto Opcional. True para DataType ter sido xlDelimited e ter o ponto e vírgula como um delimiter. O valor padrão é False.
- Comma
- Object
Objeto Opcional. True para DataType ter sido xlDelimited e ter a vírgula como um delimiter. O valor padrão é False.
- Space
- Object
Objeto Opcional. True para ter DataType sido xlDelimited e ter o caractere de espaço como um delimiter. O valor padrão é False.
- Other
- Object
Objeto Opcional. True para DataType ter sido xlDelimited e ter o caractere especificado pelo OtherChar argumento como um delimiter. O valor padrão é False.
- OtherChar
- Object
Objeto Opcional (obrigatório se Other for True). O caractere delimiter quando Other for 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 da coluna (baseado em 1) e o segundo elemento é uma das constantes que especificam como a coluna XlColumnDataType é analisado. Pode ser uma das seguintes constantes XlColumnDataType: xlGeneralFormat. Genera. xlTextFormat. Texto. xlMDYFormat. Data MDY. xlDMYFormat. Data DMY. xlYMDFormat. Data do YMD. xlMYDFormat. Data MYD. xlDYMFormat. Data de DYM. xlYDMFormat. Data do YDM. xlEMDFormat. Data do EMD. xlSkipColumn. Ignorar Coluna.Você só poderá usar xlEMDFormat se o suporte a 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á analisado com a configuração Geral. Se os dados de origem têm colunas de largura fixa, o primeiro elemento de cada matriz de dois elementos especifica 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 caracteresopcional . 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 caracteresopcional . 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
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.
| 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 | 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) |