NamedRange.TextToColumns(Object, XlTextParsingType, XlTextQualifier, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) 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);
Parâmetros
- Destination
- Object
Um objeto Range que especifica o local em que o Microsoft Office Excel colocará os resultados. Se o intervalo for maior do que uma única célula, a célula superior esquerda será usada.
- DataType
- XlTextParsingType
O formato do texto a ser dividido em colunas.
Pode ser uma das seguintes constantes XlTextParsingType: xlDelimited (padrão) xlFixedWidth
- TextQualifier
- XlTextQualifier
Pode ser um dos seguintes valores XlTextQualifier: xlTextQualifierDoubleQuote (padrão) xlTextQualifierNonexlTextQualifierSingleQuote
- ConsecutiveDelimiter
- Object
true para fazer com que o Excel considere delimitadores consecutivos como um delimitador. O valor padrão é false.
- Tab
- Object
true para fazer com que DataType seja xlDelimited e que o caractere de tabulação seja um delimitador. O valor padrão é false.
- Semicolon
- Object
true fazer com que DataType seja xlDelimited e que o ponto e vírgula seja um delimitador. O valor padrão é false.
- Comma
- Object
true para fazer com que DataType seja xlDelimited e que a vírgula seja um delimitador. O valor padrão é false.
- Space
- Object
true para fazer com que DataType seja xlDelimited e que o caractere de espaço seja um delimitador. O valor padrão é false.
- Other
- Object
true para fazer com que DataType seja xlDelimited e que o caractere especificado pelo argumento OtherChar seja um delimitador. O valor padrão é false.
- OtherChar
- Object
O caractere delimitador quando Other é true. Se mais de um caractere for especificado, apenas o primeiro caractere da cadeia de caracteres será usado; os caracteres restantes serão ignorados.
- FieldInfo
- Object
Uma matriz contendo informações de análise para as colunas de dados individuais. A interpretação depende do valor de DataType. Quando os dados estão delimitados, esse argumento é uma matriz de matrizes de dois elementos, com cada matriz de dois elementos especificando as opções de conversão para uma determinada coluna. O primeiro elemento é o número da coluna (baseado em 1) e o segundo elemento é uma das constantes XlColumnDataType especificando como a coluna é analisada.
Pode ser um dos seguintes valores XlColumnDataType: xlGeneralFormatxlTextFormatxlMDYFormatxlDMYFormatxlYMDFormatxlMYDFormatxlDYMFormatxlYDMFormatxlEMDFormatxlSkipColumn
Você poderá usar o xlEMDFormat somente se o suporte ao idioma taiwanês estiver instalado e selecionado. xlEMDFormat especifica que as datas da era taiwanesa estão sendo usadas.
Os especificadores de coluna podem estar em qualquer ordem. Se um dado especificador de coluna não estiver presente para uma determinada coluna nos dados de entrada, a coluna será analisada com a configuração xlGeneralFormat.
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 especificará a opção de análise para a coluna como um número de 1 a 9, como listado acima.
- DecimalSeparator
- Object
O separador decimal que o Excel usa ao reconhecer números. A configuração padrão é a configuração do sistema.
- ThousandsSeparator
- Object
O separador de milhar que o Excel usa ao reconhecer números. A configuração padrão é a configuração do sistema.
- TrailingMinusNumbers
- Object
Números que começam com um caractere de menos.
Retornos
Exemplos
O exemplo de código a seguir usa o TextToColumns método para converter uma cadeia de caracteres de data delimitada por espaço em uma NamedRange a três colunas.
Este exemplo destina-se a uma personalização no nível de documento.
private void ConvertTextToColumns()
{
Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
this.Controls.AddNamedRange(this.Range["A1"],
"namedRange1");
namedRange1.Value2 = "01 01 2001";
Excel.Range destinationRange = this.Range["A5"];
namedRange1.TextToColumns(destinationRange,
Excel.XlTextParsingType.xlDelimited,
Excel.XlTextQualifier.xlTextQualifierDoubleQuote,
true);
}
Private Sub ConvertTextToColumns()
Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
= Me.Controls.AddNamedRange(Me.Range("A1"), _
"namedRange1")
namedRange1.Value2 = "01 01 2001"
Dim destinationRange As Excel.Range = Me.Range("A5")
namedRange1.TextToColumns(destinationRange, _
Excel.XlTextParsingType.xlDelimited, _
Excel.XlTextQualifier.xlTextQualifierDoubleQuote, , , , , _
True, , , , , , )
End Sub
Comentários
A tabela a seguir mostra os resultados da importação de texto no Excel para várias configurações de importação. Os resultados numéricos são exibidos na coluna mais à direita.
| Separador decimal do sistema | Separador de milhares do sistema | Valor do separador decimal | Valor do separador de milhar | Texto original | Valor da célula (tipo de dados) |
|---|---|---|---|---|---|
| Ponto final | Vírgula | Vírgula | Ponto final | 123.123, 45 | 123,123.45 (numérico) |
| Ponto final | Vírgula | Vírgula | Vírgula | 123.123, 45 | 123.123, 45 (texto) |
| Vírgula | Ponto final | Vírgula | Ponto final | 123123,45 | 123,123.45 (numérico) |
| Ponto final | Vírgula | Ponto final | Vírgula | 123123,45 | 123123,45 (texto) |
| Ponto final | Vírgula | Ponto final | Espaço | 123123,45 | 123,123.45 (numérico) |
Parâmetros opcionais
Para obter informações sobre parâmetros opcionais, consulte parâmetros opcionais em soluções do Office.