NamedRange.TextToColumns Método

Definición

Espacio de nombres:

Microsoft.Office.Tools.Excel

Ensamblado:

Microsoft.Office.Tools.Excel.dll

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

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

Control Range que especifica dónde colocará los resultados Microsoft Office Excel. Si el rango es de más de una celda, se utiliza la celda superior izquierda.

DataType

XlTextParsingType

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

TextQualifier

XlTextQualifier

Puede ser uno de los siguientes XlTextQualifier valores: xlTextQualifierDoubleQuote (valor predeterminado) xlTextQualifierNonexlTextQualifierSingleQuote

ConsecutiveDelimiter

Object

true para que Excel considere los delimitadores consecutivos como un solo delimitador. El valor predeterminado es false.

Tab

Object

true para tener y para que DataTypexlDelimited el carácter de tabulación sea un delimitador. El valor predeterminado es false.

Semicolon

Object

true para que sea DataTypexlDelimited y para que el punto y coma sea un delimitador. El valor predeterminado es false.

Comma

Object

true para tener y para que DataTypexlDelimited la coma sea un delimitador. El valor predeterminado es false.

Space

Object

true para que sea DataTypexlDelimited y para que el carácter de espacio sea un delimitador. El valor predeterminado es false.

Other

Object

true para que sea DataTypexlDelimited y para que el carácter especificado por el OtherChar argumento sea un delimitador. El valor predeterminado es false.

OtherChar

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

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 columna (basado en 1) y el segundo elemento es una de las XlColumnDataType constantes que especifican cómo se analiza la columna. Puede ser uno de los siguientes XlColumnDataType valores: xlGeneralFormatxlMDYFormatxlYMDFormatxlMYDFormatxlDMYFormatxlTextFormatxlYDMFormatxlEMDFormatxlDYMFormatxlSkipColumn solo puede usar xlEMDFormat si la compatibilidad con idiomas taiwaneses está instalada y seleccionada. xlEMDFormat especifica que se están usando fechas de era taiwanesa. 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

Object

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

ThousandsSeparator

Object

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

TrailingMinusNumbers

Object

Números que empiezan por un carácter de signo menos.

Devoluciones

Object

Ejemplos

En el ejemplo de código siguiente se usa el TextToColumns método para convertir una cadena de fecha delimitada por espacio en tres NamedRange columnas.

Este ejemplo es para una personalización de nivel 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

Comentarios

En la tabla siguiente se muestran los resultados de la importación de texto en Excel para diversas configuraciones de importación. Los resultados numéricos se muestran en la columna situada más a la derecha.

Separador decimal del sistema	Separador de miles del sistema	Valor separador decimal	Valor del separador de miles	Texto original	Valor de celda (tipo de datos)
Período	Coma	Coma	Período	123.123,45	123.123.45 (numérico)
Período	Coma	Coma	Coma	123.123,45	123.123.45 (texto)
Coma	Período	Coma	Período	123,123.45	123.123.45 (numérico)
Período	Coma	Período	Coma	123 123.45	123 123.45 (texto)
Período	Coma	Período	Space	123 123.45	123.123.45 (numérico)

Parámetros opcionales

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