NamedRange.TextToColumns Método

Definição

Namespace:

Microsoft.Office.Tools.Excel

Assembly:

Microsoft.Office.Tools.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);

abstract member TextToColumns : obj * Microsoft.Office.Interop.Excel.XlTextParsingType * Microsoft.Office.Interop.Excel.XlTextQualifier * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj -> obj

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

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 XlTextParsingType constantes: xlDelimited (padrão) xlFixedWidth

TextQualifier

XlTextQualifier

Pode ser um dos seguintes XlTextQualifier valores: 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 ter DataType e xlDelimited ter o caractere de tabulação como um delimitador. O valor padrão é false.

Semicolon

Object

trueDataType ter que ser xlDelimited e ter o ponto e vírgula ser um delimitador. O valor padrão é false.

Comma

Object

true ter DataType que ser xlDelimited e ter a vírgula ser um delimitador. O valor padrão é false.

Space

Object

trueDataType ter que ser xlDelimited e ter o caractere de espaço ser um delimitador. O valor padrão é false.

Other

Object

true ter DataType e xlDelimited ter o caractere especificado pelo OtherChar argumento como 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 XlColumnDataType constantes que especificam como a coluna é analisada. Pode ser um dos seguintes XlColumnDataType valores:xlTextFormatxlDMYFormatxlYMDFormatxlMYDFormatxlMDYFormatxlGeneralFormatxlYDMFormatxlEMDFormatxlDYMFormatxlSkipColumn você só poderá usar xlEMDFormat se o suporte ao idioma taiwanês estiver instalado e selecionado. xlEMDFormat especifica que 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

Object

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 para 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 para o 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 separador de milhares	Texto original	Valor da célula (tipo de dados)
Período	Vírgula	Vírgula	Período	123.123,45	123,123.45 (numérico)
Período	Vírgula	Vírgula	Vírgula	123.123,45	123.123,45 (texto)
Vírgula	Período	Vírgula	Período	123,123.45	123,123.45 (numérico)
Período	Vírgula	Período	Vírgula	123 123.45	123 123.45 (texto)
Período	Vírgula	Período	Space	123 123.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.