NamedRange.TextToColumns Метод

Ссылка

Определение

Пространство имен:: Microsoft.Office.Tools.Excel

Сборка:: Microsoft.Office.Tools.Excel.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Выполняет синтаксический анализ ячеек, содержащих текст в нескольких столбцах.

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

Параметры

Destination: Object

Объект Range, который указывает, куда Microsoft Office Excel помещает результаты. Если диапазон больше, чем одна ячейка, используется верхняя левая ячейка.

DataType: XlTextParsingType

Формат текста, который необходимо разделить на столбцы. Может быть одной из следующих XlTextParsingType констант: xlDelimited (по умолчанию) xlFixedWidth

TextQualifier: XlTextQualifier

Может иметь одно из следующих XlTextQualifier значений: xlTextQualifierDoubleQuote (по умолчанию) xlTextQualifierNone xlTextQualifierSingleQuote

ConsecutiveDelimiter: Object

Значение true, чтобы приложение Excel рассматривало последовательные разделители как один разделитель. Значение по умолчанию — false.

Tab: Object

trueDataTypexlDelimited значение , а символ табуляции должен быть разделителем. Значение по умолчанию — false.

Semicolon: Object

trueDataTypexlDelimited значение , а для того, чтобы точка с запятой была разделителем. Значение по умолчанию — false.

Comma: Object

true , чтобы иметь DataType значение и xlDelimited чтобы запятая была разделителем. Значение по умолчанию — false.

Space: Object

trueDataType значение , xlDelimited и , чтобы символ пробела был разделителем. Значение по умолчанию — false.

Other: Object

trueDataTypexlDelimited значение , а символ, заданный OtherChar аргументом , является разделителем. Значение по умолчанию — false.

OtherChar: Object

Символ разделителя, если Other имеет значение true. Если задается несколько символов, используется только первый символ строки; остальные символы не учитываются.

FieldInfo: Object

Массив, содержащий сведения о синтаксическом анализе для отдельных столбцов данных. Интерпретация зависит от значения DataType. Если данные разделены, этот аргумент является массивом массивов, состоящих из двух элементов, причем каждый из массивов из двух элементов задает параметры преобразования для конкретного столбца. Первый элемент — это номер столбца (на основе 1), а второй — одна из XlColumnDataType констант, указывающих способ анализа столбца. Может иметь одно из следующих XlColumnDataType значений. xlGeneralFormat xlMDYFormat xlYMDFormat xlMYDFormat xlDMYFormat xlTextFormat xlYDMFormat xlEMDFormat xlDYMFormat xlSkipColumn Вы можете использовать xlEMDFormat только в том случае, если установлена и выбрана поддержка тайваньского языка. xlEMDFormat указывает, что используются даты тайваньской эры. Описатели столбцов могут находиться в любом порядке. Если данный спецификатор конкретного столбца отсутствует во входных данных, синтаксический анализ столбца выполняется с параметром xlGeneralFormat. Если исходные данные имеют столбцы фиксированной ширины, первый элемент каждого массива из двух элементов указывает начальное положение символа в столбце (как целое число; нуль (0) является первым символом). Второй элемент массива из двух элементов задает параметр синтаксического анализа для столбца как число от 1 до 9, как указано выше.

DecimalSeparator: Object

Десятичный разделитель, который Excel использует при распознавании чисел. Установкой по умолчанию является системная установка.

ThousandsSeparator: Object

Разделитель тысяч, который Excel использует при распознавании чисел. Установкой по умолчанию является системная установка.

TrailingMinusNumbers: Object

Числа, начинающиеся со знака минус.

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

Object

Примеры

В следующем примере кода метод используется TextToColumns для преобразования строки даты с разделителями-пробелами в NamedRange в три столбца.

Этот пример предназначен для настройки на уровне документа.

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

Системный десятичный разделитель	Системный разделитель разрядов	Десятичное значение разделителя	Значение разделителя разрядов	Исходный текст.	Значение ячейки (тип данных)
Период	Запятая	Запятая	Период	123.123,45	123,123,45 (числовой)
Период	Запятая	Запятая	Запятая	123.123,45	123.123,45 (текст)
Запятая	Период	Запятая	Период	123,123.45	123,123,45 (числовой)
Период	Запятая	Период	Запятая	123 123.45	123 123.45 (текст)
Период	Запятая	Период	Пробел	123 123.45	123,123,45 (числовой)

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

Сведения о необязательных параметрах см. в разделе Необязательные параметры в решениях Office.

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

Поделиться через