Range.TextToColumns Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Анализирует столбец ячеек, содержащих текст, на несколько столбцов.
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);
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 Excel будет размещать результаты. Если диапазон больше одной ячейки, используется верхняя левая ячейка.
- DataType
- XlTextParsingType
Необязательный параметр XlTextParsingType. Формат текста для разделения на столбцы. Может быть одной из следующих констант XlTextParsingType :xlDelimited default
xlFixedWidth
- TextQualifier
- XlTextQualifier
Необязательный параметр XlTextQualifier. Может быть одной из следующих констант XlTextQualifier :xlTextQualifierDoubleQuotedefault
xlTextQualifierNonexlTextQualifierSingleQuote
- ConsecutiveDelimiter
- Object
Необязательный объект. True , чтобы в Microsoft Excel рассматривались последовательные разделители как один разделитель. Значение по умолчанию — False.
- Tab
- Object
Необязательный объект.
Значение true , DataType
чтобы иметь значение xlDelimited , а символ табуляции — разделитель. Значение по умолчанию — False.
- Semicolon
- Object
Необязательный объект.
Значение true , чтобы иметь DataType
значение xlDelimited , а точка с запятой — разделитель. Значение по умолчанию — False.
- Comma
- Object
Необязательный объект.
Значение true , чтобы иметь DataType
значение xlDelimited , а запятая — разделитель. Значение по умолчанию — False.
- Space
- Object
Необязательный объект.
Значение true , чтобы иметь DataType
значение xlDelimited и символ пробела в качестве разделителя. Значение по умолчанию — False.
- Other
- Object
Необязательный объект.
Значение true , чтобы иметь DataType
значение xlDelimited , а символ, заданный OtherChar
аргументом, является разделителем. Значение по умолчанию — False.
- OtherChar
- Object
Необязательный объект (требуется, если Other
имеет значение True). Символ разделителя, если Other
имеет значение True. Если задано несколько символов, используется только первый символ строки; остальные символы игнорируются.
- FieldInfo
- Object
Необязательный объект. Массив, содержащий сведения для анализа отдельных столбцов данных. Интерпретация зависит от значения DataType
. Если данные разделены, этот аргумент представляет собой массив массивов двухэлементных массивов, при этом каждый двухэлементный массив задает параметры преобразования для определенного столбца. Первый элемент — это номер столбца (на основе 1), а второй — одна из XlColumnDataType констант, указывающих способ анализа столбца. Может быть одной из следующих констант XlColumnDataType :xlGeneralFormat. Родов.
xlTextFormat. Текст. xlMDYFormat. Дата MDY. xlDMYFormat. Дата DMY. xlYMDFormat. Дата YMD. xlMYDFormat. Дата MYD. xlDYMFormat. Дата DYM. xlYDMFormat. Дата YDM. xlEMDFormat. Дата EMD. xlSkipColumn. Пропустить столбец.XlEMDFormat можно использовать только в том случае, если установлена и выбрана поддержка тайваньского языка.
Константа xlEMDFormat указывает, что используются даты тайваньской эры. Описатели столбцов могут находиться в любом порядке. Если указанный описатель столбца отсутствует для определенного столбца во входных данных, столбец анализируется с помощью параметра Общие . Если исходные данные содержат столбцы фиксированной ширины, первый элемент каждого двухэлейного массива задает начальную позицию символа в столбце (в виде целого числа; 0 (ноль) — первый символ). Второй элемент массива с двумя элементами задает параметр синтаксического анализа для столбца в виде числа от 1 до 9, как указано выше.
- DecimalSeparator
- Object
Необязательный параметр String. Десятичный разделитель, который Microsoft Excel использует при распознавании чисел. Параметр по умолчанию — системный параметр.
- ThousandsSeparator
- Object
Необязательный параметр String. Разделитель тысяч, который Excel использует при распознавании чисел. Параметр по умолчанию — системный параметр.
- TrailingMinusNumbers
- Object
Необязательный объект. Числа, начинающиеся с символа "минус".
Возвращаемое значение
Комментарии
В следующей таблице показаны результаты импорта текста в Excel для различных параметров импорта. Числовые результаты отображаются в крайнем правом столбце.
Period | Запятой | Запятой | Period | 123.123,45 | 123,123,45 (числовое значение) |
Period | Запятой | Запятой | Запятой | 123.123,45 | 123.123,45 (текст) |
Запятой | Period | Запятой | Period | 123,123.45 | 123,123,45 (числовое значение) |
Period | Запятой | Period | Запятой | 123 123.45 | 123 123.45 (текст) |
Period | Запятой | Period | Space | 123 123.45 | 123,123,45 (числовое значение) |