Compartilhar via


Método XmlMappedRange.TextToColumns

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
    Range que especifica onde o Microsoft Office Excel coloca os resultados.Se o intervalo é maior do que uma única célula, da célula superior esquerdo é usada.
  • 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 com que 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 com que 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 como argumento de OtherChar para ser um delimitador.O valor padrão é false.
  • OtherChar
    Tipo: System.Object
    O caractere delimitador de Other quando é true.Se mais de um caractere é especificado, somente o primeiro caractere da cadeia de caracteres é usado; os outros caracteres são ignorados.
  • FieldInfo
    Tipo: System.Object
    Um contendo a matriz analisa informações para as colunas de dados individuais.A interpretação depende do valor de DataType.Quando os dados estão limitados, 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 da 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 dele 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 definir 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 do 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 de (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

texto (123 123,45)

Período

Vírgula

Período

Space

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 a seguir usa o método de TextToColumns para converter uma cadeia de caracteres de data com delimitação espacial dentro de XmlMappedRange a três colunas.Este exemplo de código a seguir pressupõe que a planilha atual contiver XmlMappedRange chamado CustomerLastNameCell.

Private Sub ConvertTextToColumns()
    Me.CustomerDateCell.Value2 = "01 01 2001"
    Dim destinationRange As Excel.Range = Me.Range("A5")

    Me.CustomerDateCell.TextToColumns(destinationRange, _
        Excel.XlTextParsingType.xlDelimited, _
        Excel.XlTextQualifier.xlTextQualifierDoubleQuote, Space:=True)
End Sub
private void ConvertTextToColumns()
{
    this.CustomerDateCell.Value2 = "01 01 2001";
    Excel.Range destinationRange = this.Range["A5"];

    this.CustomerDateCell.TextToColumns(destinationRange, 
        Excel.XlTextParsingType.xlDelimited,
        Excel.XlTextQualifier.xlTextQualifierDoubleQuote);
}

Segurança do .NET Framework

Consulte também

Referência

XmlMappedRange Interface

Namespace Microsoft.Office.Tools.Excel