XmlMappedRange.TextToColumns (Método)

Artículo
05/15/2013

Analiza una columna de celdas que contienen texto y redistribuye el texto en varias columnas.

Espacio de nombres: Microsoft.Office.Tools.Excel
Ensamblado: Microsoft.Office.Tools.Excel (en Microsoft.Office.Tools.Excel.dll)

Sintaxis

'Declaración
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
Control Range que especifica dónde coloca los resultados Microsoft Office Excel.Si el rango es de más de una celda, se utiliza la celda superior izquierda.

DataType
Tipo: Microsoft.Office.Interop.Excel.XlTextParsingType
Formato del texto que se va a dividir en columnas.
Puede ser una de las siguientes constantes de XlTextParsingType:
xlDelimited (valor predeterminado)
xlFixedWidth

TextQualifier
Tipo: Microsoft.Office.Interop.Excel.XlTextQualifier
Puede ser uno de los siguientes valores de XlTextQualifier:
xlTextQualifierDoubleQuote (valor predeterminado)
xlTextQualifierNone
xlTextQualifierSingleQuote

ConsecutiveDelimiter
Tipo: System.Object
true para que Excel considere los delimitadores consecutivos como un solo delimitador.El valor predeterminado es false.

Tab
Tipo: System.Object
Es true para que DataType sea xlDelimited y que el carácter de tabulación sea un delimitador.El valor predeterminado es false.

Semicolon
Tipo: System.Object
Es true para que DataType sea xlDelimited y que el signo de punto y coma sea un delimitador.El valor predeterminado es false.

Comma
Tipo: System.Object
Es true para que DataType sea xlDelimited y que la coma sea un delimitador.El valor predeterminado es false.

Space
Tipo: System.Object
Es true para que DataType sea xlDelimited y que el carácter de espacio en blanco sea un delimitador.El valor predeterminado es false.

Other
Tipo: System.Object
Es true para que DataType sea xlDelimited y que el carácter especificado por el argumento OtherChar sea un delimitador.El valor predeterminado es false.

OtherChar
Tipo: System.Object
Carácter delimitador cuando Other es true.Si se especifica más de un carácter, se utiliza sólo el primer carácter de la cadena; se omiten los caracteres restantes.

FieldInfo
Tipo: System.Object
Matriz que contiene información de análisis de las columnas de datos.La interpretación depende del valor de DataType.Cuando se delimitan los datos, este argumento es una matriz de matrices de dos elementos, cada una de las cuales especifica las opciones de conversión para una columna determinada.El primer elemento es el número de columnas (basado en uno) y el segundo elemento es una de las constantes de XlColumnDataType que especifica cómo se analiza la columna.
Puede ser uno de los siguientes valores de XlColumnDataType:
xlGeneralFormat
xlTextFormat
xlMDYFormat
xlDMYFormat
xlYMDFormat
xlMYDFormat
xlDYMFormat
xlYDMFormat
xlEMDFormat
xlSkipColumn
Solo puede usar xlEMDFormat si está instalada y seleccionada la compatibilidad de idioma taiwanés.xlEMDFormat especifica si se utilizan fechas de era en formato de idioma taiwanés.
Los especificadores de columna pueden estar en cualquier orden.Si un especificador de columna determinado no está presente para una columna en particular en los datos de entrada, la columna se analiza con la configuración de xlGeneralFormat.
Si el ancho de las columnas para los datos de origen es fijo, el primer elemento de cada matriz de dos elementos especifica la posición del carácter de inicio de la columna (como entero; 0 (cero) es el primer carácter).El segundo elemento de la matriz de dos elementos especifica la opción de análisis de la columna como un número del 1 al 9, según lo enumerado anteriormente.

DecimalSeparator
Tipo: System.Object
Separador decimal que utiliza Excel al reconocer los números.El valor predeterminado es el de la configuración del sistema.

ThousandsSeparator
Tipo: System.Object
Separador de miles que utiliza Excel al reconocer los números.El valor predeterminado es el de la configuración del sistema.

TrailingMinusNumbers
Tipo: System.Object
Números que empiezan por un carácter de signo menos.

Valor devuelto

Tipo: System.Object

Comentarios

En la siguiente tabla se muestran los resultados de la importación de texto en Excel según distintas configuraciones de importación.Los resultados numéricos se muestran en la columna situada a la derecha.

Separador decimal del sistema	Separador de miles del sistema	Valor de separador decimal	Valor de separador de miles	Texto original	Valor de celda (tipo de datos)
Period	Coma	Coma	Period	123.123,45	123,123.45 (numérico)
Period	Coma	Coma	Coma	123.123,45	123.123,45 (texto)
Coma	Period	Coma	Period	123,123.45	123,123.45 (numérico)
Period	Coma	Period	Coma	123 123.45	123 123,45 (texto)
Period	Coma	Period	Espacio	123 123.45	123,123.45 (numérico)

Parámetros opcionales

Para obtener información sobre parámetros opcionales, vea Parámetros opcionales en las soluciones de Office.

Ejemplos

En el siguiente ejemplo de código se utiliza el método TextToColumns para convertir a formato de tres columnas una cadena de fecha delimitada por espacios dentro de un control XmlMappedRange.En este ejemplo de código se supone que la hoja de cálculo actual contiene un control XmlMappedRange denominado 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);
}

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Vea también

Referencia

XmlMappedRange Interfaz

Microsoft.Office.Tools.Excel (Espacio de nombres)

Compartir a través de