Método NamedRange.TextToColumns

Artigo
01/09/2014

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

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)

Sintaxe

'Declaração
Function TextToColumns ( _
    Destination As Object, _
    DataType As XlTextParsingType, _
    TextQualifier As XlTextQualifier, _
    ConsecutiveDelimiter As Object, _
    Tab As Object, _
    Semicolon As Object, _
    Comma As Object, _
    Space As Object, _
    Other As Object, _
    OtherChar As Object, _
    FieldInfo As Object, _
    DecimalSeparator As Object, _
    ThousandsSeparator As Object, _
    TrailingMinusNumbers As Object _
) As Object

Object TextToColumns(
    Object Destination,
    XlTextParsingType DataType,
    XlTextQualifier TextQualifier,
    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
Tipo: System.Object
Um objeto de Microsoft.Office.Interop.Excel.Range que especifica onde o Microsoft Office Excel colocará os resultados.Se o intervalo é maior do que uma única célula, da célula superior esquerdo é usada.

DataType
Tipo: Microsoft.Office.Interop.Excel.XlTextParsingType
O formato de texto a ser dividido em colunas.
Pode ser uma das seguintes constantes de XlTextParsingType :
xlDelimited (padrão)
xlFixedWidth

TextQualifier
Tipo: Microsoft.Office.Interop.Excel.XlTextQualifier
Pode ser um dos seguintes valores de XlTextQualifier :
xlTextQualifierDoubleQuote (padrão)
xlTextQualifierNone
xlTextQualifierSingleQuote

ConsecutiveDelimiter
Tipo: System.Object
true para que o excel considerar delimitadores consecutivos como delimitador.O valor padrão é false.

Tab
Tipo: System.Object
true para ter DataType ser xlDelimited e fazer o caractere de tabulação ser um delimitador.O valor padrão é false.

Semicolon
Tipo: System.Object
true para ter DataType ser xlDelimited e fazer o ponto-e-vírgula ser um delimitador.O valor padrão é false.

Comma
Tipo: System.Object
true para ter DataType ser xlDelimited e fazer com que a vírgula ser um delimitador.O valor padrão é false.

Space
Tipo: System.Object
true para ter DataType ser xlDelimited e fazer o caractere de espaço ser um delimitador.O valor padrão é false.

Other
Tipo: System.Object
true para ter DataType ser xlDelimited e ter o caractere especificado pelo argumento de OtherChar para ser um delimitador.O valor padrão é false.

OtherChar
Tipo: System.Object
O caractere delimitador de Other quando for true.Se mais de um caractere é especificado, somente o primeiro caractere da cadeia de caracteres é usado; os caracteres restantes são ignorados.

FieldInfo
Tipo: System.Object
Uma matriz que contém de análise informações para as colunas de dados individuais.A interpretação depende do valor de DataType.Quando dados são associados, esse argumento é uma matriz de matrizes de dois elementos, com cada matriz de dois elementos que especifica as opções de conversão para uma coluna específica.O primeiro elemento é o número de coluna (base 1), e o segundo elemento é uma das constantes de XlColumnDataType que especificam como a coluna é analisada.
Pode ser um dos seguintes valores de XlColumnDataType :
xlGeneralFormat
xlTextFormat
xlMDYFormat
xlDMYFormat
xlYMDFormat
xlMYDFormat
xlDYMFormat
xlYDMFormat
xlEMDFormat
xlSkipColumn
Você pode usar xlEMDFormat somente se o suporte taiwanês de linguagem é instalado e selecionado.xlEMDFormat especifica que as datas taiwanesas deles está sendo usado.
Especificadores da coluna podem estar em qualquer ordem.Se um determinado especificador da coluna não está presente para uma coluna específica nos dados de entrada, a coluna é analisado com a configuração de xlGeneralFormat .
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 começando a 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 listada acima.

DecimalSeparator
Tipo: System.Object
O separador decimal Excel que usa quando reconhecendo numera.A configuração padrão é definir o sistema.

ThousandsSeparator
Tipo: System.Object
O separador de milhares do excel que usa quando reconhecendo numera.A configuração padrão é definir o sistema.

TrailingMinusNumbers
Tipo: System.Object
Números que começam com o menos ao caractere.

Valor de retorno

Tipo: System.Object

Comentários

A tabela a seguir mostra os resultados de importar o texto do 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 milhares	Texto original	Valor da célula (tipo de dados)
Período	Vírgula	Vírgula	Período	123.123,45	numérico (123.123,45)
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	numérico (123.123,45)
Período	Vírgula	Período	Vírgula	123 123.45	123 123,45 (texto)
Período	Vírgula	Período	Espaço	123 123.45	numérico (123.123,45)

Parâmetros Opcionais

Para obter informações sobre parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

O exemplo de código usa o método de TextToColumns para converter uma cadeia de caracteres data com delimitação espacial em NamedRange a três colunas.

Este exemplo é para uma personalização de um documento nível.

    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

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);
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via