NamedRange.TextToColumns Метод (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

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

Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel.v9.0 (в Microsoft.Office.Tools.Excel.v9.0.dll)

Синтаксис

'Декларация
Public Function TextToColumns ( _
    Destination As Object, _
    DataType As XlTextParsingType, _
    TextQualifier As XlTextQualifier, _
    ConsecutiveDelimiter As Object, _
    Tab As Object, _
    Semicolon As Object, _
    Comma As Object, _
    Space As Object, _
    Other As Object, _
    OtherChar As Object, _
    FieldInfo As Object, _
    DecimalSeparator As Object, _
    ThousandsSeparator As Object, _
    TrailingMinusNumbers As Object _
) As Object
'Применение
Dim instance As NamedRange
Dim Destination As Object
Dim DataType As XlTextParsingType
Dim TextQualifier As XlTextQualifier
Dim ConsecutiveDelimiter As Object
Dim Tab As Object
Dim Semicolon As Object
Dim Comma As Object
Dim Space As Object
Dim Other As Object
Dim OtherChar As Object
Dim FieldInfo As Object
Dim DecimalSeparator As Object
Dim ThousandsSeparator As Object
Dim TrailingMinusNumbers As Object
Dim returnValue As Object

returnValue = instance.TextToColumns(Destination, _
    DataType, TextQualifier, ConsecutiveDelimiter, _
    Tab, Semicolon, Comma, Space, Other, _
    OtherChar, FieldInfo, DecimalSeparator, _
    ThousandsSeparator, TrailingMinusNumbers)

public Object TextToColumns(
    Object Destination,
    XlTextParsingType DataType,
    XlTextQualifier TextQualifier,
    Object ConsecutiveDelimiter,
    Object Tab,
    Object Semicolon,
    Object Comma,
    Object Space,
    Object Other,
    Object OtherChar,
    Object FieldInfo,
    Object DecimalSeparator,
    Object ThousandsSeparator,
    Object TrailingMinusNumbers
)

Параметры

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

DataType
Тип: Microsoft.Office.Interop.Excel.XlTextParsingType
Формат текста, который должен разбиваться на столбцы.
Может быть одной из следующих констант XlTextParsingType:
- xlDelimited (по умолчанию)
- xlFixedWidth

TextQualifier
Тип: Microsoft.Office.Interop.Excel.XlTextQualifier
Может быть одно из следующих значений XlTextQualifier:
- xlTextQualifierDoubleQuote (по умолчанию)
- xlTextQualifierNone
- xlTextQualifierSingleQuote

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

Tab
Тип: System.Object
Значение true, чтобы параметр DataType был xlDelimited, и чтобы символ табуляции был разделителем. Значение по умолчанию — false.

Semicolon
Тип: System.Object
Значение true, чтобы параметр DataType был xlDelimited, и чтобы символ точки с запятой был разделителем. Значение по умолчанию — false.

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

Space
Тип: System.Object
Значение true, чтобы параметр DataType был xlDelimited, и чтобы символ пробела был разделителем. Значение по умолчанию — false.

Other
Тип: System.Object
Значение true, чтобы параметр DataType был xlDelimited, а символ, задаваемый аргументом OtherChar, был разделителем. Значение по умолчанию — false.

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

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

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

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

TrailingMinusNumbers
Тип: System.Object
Числа, начинающиеся со знака минус.

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

Тип: System.Object

Заметки

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

Системный десятичный разделитель	Системный разделитель тысяч	Значение десятичного разделителя	Значение разделителя тысяч	Исходный текст	Значение ячейки (тип данных)
Точка	Запятая	Запятая	Точка	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.

Примеры

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

В этом примере демонстрируется настройка уровня документа.

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

private void ConvertTextToColumns()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", missing],
        "namedRange1");

    namedRange1.Value2 = "01 01 2001";
    Excel.Range destinationRange = this.Range["A5", missing];

    namedRange1.TextToColumns(destinationRange,
        Excel.XlTextParsingType.xlDelimited,
        Excel.XlTextQualifier.xlTextQualifierDoubleQuote, missing,
        missing, missing, missing, true, missing, missing, missing,
        missing, missing, missing);
}

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.