XmlMappedRange.TextToColumns(Object, XlTextParsingType, XlTextQualifier, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) Метод

Определение

Выполняет синтаксический анализ ячеек, содержащих текст в нескольких столбцах.Parses a column of cells that contain text into several columns.

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

Параметры

Destination
Object

Диапазон Range, который указывает, куда Microsoft Office Excel помещает результаты.A Range that specifies where Microsoft Office Excel places the results. Если диапазон больше, чем одна ячейка, используется верхняя левая ячейка.If the range is larger than a single cell, the top left cell is used.

DataType
XlTextParsingType

Формат текста, который должен разбиваться на столбцы.The format of the text to be split into columns.

Может быть одна из следующих констант XlTextParsingType:Can be one of the following XlTextParsingType constants: xlDelimited (по умолчанию)xlDelimited (default) xlFixedWidth

TextQualifier
XlTextQualifier

Может иметь одно из следующих значений XlTextQualifier:Can be one of the following XlTextQualifier values: xlTextQualifierDoubleQuote (по умолчанию)xlTextQualifierDoubleQuote (default) xlTextQualifierNonexlTextQualifierSingleQuote

ConsecutiveDelimiter
Object

Значение true, чтобы приложение Excel рассматривало последовательные разделители как один разделитель.true to have Excel consider consecutive delimiters as one delimiter. Значение по умолчанию — false.The default value is false.

Tab
Object

Значение true, чтобы параметр DataType имел значение xlDelimited и чтобы символ табуляции был разделителем.true to have DataType be xlDelimited and to have the tab character be a delimiter. Значение по умолчанию — false.The default value is false.

Semicolon
Object

Значение true, чтобы параметр DataType имел значение xlDelimited и чтобы символ точки с запятой был разделителем.true to have DataType be xlDelimited and to have the semicolon be a delimiter. Значение по умолчанию — false.The default value is false.

Comma
Object

Значение true, чтобы параметр DataType имел значение xlDelimited и чтобы запятая была разделителем.true to have DataType be xlDelimited and to have the comma be a delimiter. Значение по умолчанию — false.The default value is false.

Space
Object

Значение true, чтобы параметр DataType имел значение xlDelimited и чтобы пробел был разделителем.true to have DataType be xlDelimited and to have the space character be a delimiter. Значение по умолчанию — false.The default value is false.

Other
Object

Значение true, чтобы параметр DataType имел значение xlDelimited, а символ, задаваемый аргументом OtherChar, был разделителем.true to have DataType be xlDelimited and to have the character specified by the OtherChar argument be a delimiter. Значение по умолчанию — false.The default value is false.

OtherChar
Object

Символ разделителя, если Other имеет значение true.The delimiter character when Other is true. Если задается несколько символов, используется только первый символ строки; остальные символы не учитываются.If more than one character is specified, only the first character of the string is used; the remaining characters are ignored.

FieldInfo
Object

Массив, содержащий сведения о синтаксическом анализе для отдельных столбцов данных.An array containing parse information for the individual columns of data. Интерпретация зависит от значения DataType.The interpretation depends on the value of DataType. Если данные разделены, этот аргумент является массивом массивов, состоящих из двух элементов, причем каждый из массивов из двух элементов задает параметры преобразования для конкретного столбца.When the data is delimited, this argument is an array of two-element arrays, with each two-element array specifying the conversion options for a particular column. Первым элементом является номер столбца (отсчитываемый от единицы), а вторым элементом является одна из констант XlColumnDataType, определяющих, как выполняется синтаксический анализ столбца.The first element is the column number (1-based), and the second element is one of the XlColumnDataType constants specifying how the column is parsed.

Может иметь одно из следующих значений XlColumnDataType:Can be one of the following XlColumnDataType values: xlGeneralFormatxlTextFormatxlMDYFormatxlDMYFormatxlYMDFormatxlMYDFormatxlDYMFormatxlYDMFormatxlEMDFormatxlSkipColumn

xlEMDFormat можно использовать, если установлена и выбрана поддержка тайваньского языка.You can use xlEMDFormat only if Taiwanese language support is installed and selected. xlEMDFormat указывает, что используются даты тайваньской эры.xlEMDFormat specifies that Taiwanese era dates are being used.

Спецификаторы столбцов могут быть в любом порядке.The column specifiers can be in any order. Если данный спецификатор конкретного столбца отсутствует во входных данных, синтаксический анализ столбца выполняется с параметром xlGeneralFormat.If a given column specifier is not present for a particular column in the input data, the column is parsed with the xlGeneralFormat setting.

Если исходные данные имеют столбцы фиксированной ширины, первый элемент каждого массива из двух элементов указывает начальное положение символа в столбце (как целое число; нуль (0) является первым символом).If the source data has fixed-width columns, the first element of each two-element array specifies the starting character position in the column (as an integer; 0 (zero) is the first character). Второй элемент массива из двух элементов задает параметр синтаксического анализа для столбца как число от 1 до 9, как указано выше.The second element of the two-element array specifies the parse option for the column as a number from 1 through 9, as listed above.

DecimalSeparator
Object

Десятичный разделитель, который Excel использует при распознавании чисел.The decimal separator that Excel uses when recognizing numbers. Установкой по умолчанию является системная установка.The default setting is the system setting.

ThousandsSeparator
Object

Разделитель тысяч, который Excel использует при распознавании чисел.The thousands separator that Excel uses when recognizing numbers. Установкой по умолчанию является системная установка.The default setting is the system setting.

TrailingMinusNumbers
Object

Числа, начинающиеся со знака минус.Numbers that begin with a minus character.

Возвращаемое значение

Object

Примеры

В следующем примере кода метод используется TextToColumns для преобразования строки даты с разделителями-пробелами в XmlMappedRange три столбца.The following code example uses the TextToColumns method to convert a space-delimited date string within an XmlMappedRange to three columns. В этом примере кода предполагается, что текущий лист содержит XmlMappedRange имя CustomerLastNameCell .This code example assumes that the current worksheet contains an XmlMappedRange named CustomerLastNameCell.

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

Комментарии

В следующей таблице показаны результаты импорта текста в Excel для различных параметров импорта.The following table shows the results of importing text into Excel for various import settings. Числовые результаты отображаются в крайнем правом столбце.Numeric results are displayed in the rightmost column.

Десятичный разделитель системыSystem decimal separator Разделитель тысяч системыSystem thousands separator Значение десятичного разделителяDecimal separator value Значение разделителя тысячThousands separator value Исходный текст.Original text Значение ячейки (тип данных)Cell value (data type)
ПериодPeriod CommaComma CommaComma ПериодPeriod 123.123,45123.123,45 123 123,45 (числовой)123,123.45 (numeric)
ПериодPeriod CommaComma CommaComma CommaComma 123.123,45123.123,45 123.123, 45 (текст)123.123,45 (text)
CommaComma ПериодPeriod CommaComma ПериодPeriod 123,123.45123,123.45 123 123,45 (числовой)123,123.45 (numeric)
ПериодPeriod CommaComma ПериодPeriod CommaComma 123 123.45123 123.45 123 123,45 (текст)123 123.45 (text)
ПериодPeriod CommaComma ПериодPeriod ПробелSpace 123 123.45123 123.45 123 123,45 (числовой)123,123.45 (numeric)

Необязательные параметрыOptional Parameters

Дополнительные сведения о необязательных параметрах см. в разделе необязательные параметры в решениях Office.For information on optional parameters, see Optional Parameters in Office Solutions.

Применяется к