NamedRange.TextToColumns(Object, XlTextParsingType, XlTextQualifier, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выполняет синтаксический анализ ячеек, содержащих текст в нескольких столбцах.
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 помещает результаты. Если диапазон больше, чем одна ячейка, используется верхняя левая ячейка.
- DataType
- XlTextParsingType
Формат текста, который должен разбиваться на столбцы.
Может быть одна из следующих констант XlTextParsingType: xlDelimited (по умолчанию) xlFixedWidth
- TextQualifier
- XlTextQualifier
Может иметь одно из следующих значений XlTextQualifier: xlTextQualifierDoubleQuote (по умолчанию) xlTextQualifierNonexlTextQualifierSingleQuote
- ConsecutiveDelimiter
- Object
Значение true, чтобы приложение 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. Если задается несколько символов, используется только первый символ строки; остальные символы не учитываются.
- FieldInfo
- Object
Массив, содержащий сведения о синтаксическом анализе для отдельных столбцов данных. Интерпретация зависит от значения DataType. Если данные разделены, этот аргумент является массивом массивов, состоящих из двух элементов, причем каждый из массивов из двух элементов задает параметры преобразования для конкретного столбца. Первым элементом является номер столбца (отсчитываемый от единицы), а вторым элементом является одна из констант XlColumnDataType, определяющих, как выполняется синтаксический анализ столбца.
Может иметь одно из следующих значений XlColumnDataType: xlGeneralFormatxlTextFormatxlMDYFormatxlDMYFormatxlYMDFormatxlMYDFormatxlDYMFormatxlYDMFormatxlEMDFormatxlSkipColumn
xlEMDFormat можно использовать, если установлена и выбрана поддержка тайваньского языка. xlEMDFormat указывает, что используются даты тайваньской эры.
Спецификаторы столбцов могут быть в любом порядке. Если данный спецификатор конкретного столбца отсутствует во входных данных, синтаксический анализ столбца выполняется с параметром xlGeneralFormat.
Если исходные данные имеют столбцы фиксированной ширины, первый элемент каждого массива из двух элементов указывает начальное положение символа в столбце (как целое число; нуль (0) является первым символом). Второй элемент массива из двух элементов задает параметр синтаксического анализа для столбца как число от 1 до 9, как указано выше.
- DecimalSeparator
- Object
Десятичный разделитель, который Excel использует при распознавании чисел. Установкой по умолчанию является системная установка.
- ThousandsSeparator
- Object
Разделитель тысяч, который Excel использует при распознавании чисел. Установкой по умолчанию является системная установка.
- TrailingMinusNumbers
- 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
Комментарии
В следующей таблице показаны результаты импорта текста в Excel для различных параметров импорта. Числовые результаты отображаются в крайнем правом столбце.
| Десятичный разделитель системы | Разделитель тысяч системы | Значение десятичного разделителя | Значение разделителя тысяч | Исходный текст. | Значение ячейки (тип данных) |
|---|---|---|---|---|---|
| Период | Comma | Comma | Период | 123.123,45 | 123 123,45 (числовой) |
| Период | Comma | Comma | Comma | 123.123,45 | 123.123, 45 (текст) |
| Comma | Период | Comma | Период | 123,123.45 | 123 123,45 (числовой) |
| Период | Comma | Период | Comma | 123 123.45 | 123 123,45 (текст) |
| Период | Comma | Период | Пробел | 123 123.45 | 123 123,45 (числовой) |
Необязательные параметры
Дополнительные сведения о необязательных параметрах см. в разделе необязательные параметры в решениях Office.