Método NamedRange.TextToColumns

Artigo
08/01/2011

Analisa uma coluna de 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
A Microsoft.Office.Interop.Excel.Range objeto que especifica onde o Excel de Microsoft Office irá colocar os resultados.Se o intervalo for maior do que uma única célula, a célula superior esquerda é usada.

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

TextQualifier
Tipo: Microsoft.Office.Interop.Excel.XlTextQualifier
Pode ser uma das seguintes XlTextQualifier valores:
xlTextQualifierDoubleQuote (default)
xlTextQualifierNone
xlTextQualifierSingleQuote

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

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

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

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

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

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

OtherChar
Tipo: System.Object
O delimitador caractere quando Other é true.Se mais de um caractere for especificado, que o primeiro caractere da seqüência de caracteres é usado; os caracteres restantes serão ignorados.

FieldInfo
Tipo: System.Object
Uma matriz contendo informações de análise para colunas individuais dos dados.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 da XlColumnDataType constantes especificando como a coluna é analisada.
Pode ser uma das seguintes XlColumnDataType valores:
xlGeneralFormat
xlTextFormat
xlMDYFormat
xlDMYFormat
xlYMDFormat
xlMYDFormat
xlDYMFormat
xlYDMFormat
xlEMDFormat
xlSkipColumn
Você pode usar xlEMDFormat somente se o suporte de idioma de Formosa estiver instalado e selecionado.xlEMDFormatEspecifica que as datas 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 é analisada com a xlGeneralFormat configuração.
Se os dados de origem têm colunas de largura fixa, o primeiro elemento de cada matriz de dois elementos especifica a posição de 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
Tipo: System.Object
O separador decimal que o Excel usa quando reconhece números.A configuração padrão é a configuração do sistema.

ThousandsSeparator
Tipo: System.Object
Milhares separador que o Excel usa quando reconhece números.A configuração padrão é a configuração do sistema.

TrailingMinusNumbers
Tipo: System.Object
Números que começam com um sinal de subtração.

Valor de retorno

Tipo: System.Object

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 milhar do sistema	Valor do separador decimal	Milhares valor do separador	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)

Optional Parameters

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

Exemplos

O seguinte exemplo de código usa a TextToColumns método para converter uma seqüência de caracteres delimitados por espaço de data em um NamedRange para três colunas.

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

    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", missing],
        "namedRange1");

    namedRange1.Value2 = "01 01 2001";
    Excel.Range destinationRange = this.Range["A5", missing];

    namedRange1.TextToColumns(destinationRange,
        Excel.XlTextParsingType.xlDelimited,
        Excel.XlTextQualifier.xlTextQualifierDoubleQuote, missing,
        missing, missing, missing, true, missing, missing, missing,
        missing, missing, missing);
}

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áveis.

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via