Метод Workbooks.OpenText (Excel)

Статья
04/07/2023

Загружает и анализирует текстовый файл как новую книгу с одним листом, содержащим проанализированные данные текстового файла.

Синтаксис

expression. OpenText (FileName, Origin, StartRow, DataType, TextQualifier, ПоследовательныйДелимитер, Tab, Точка с запятой, ПРОБЕЛ, Other, OtherChar, FieldInfo, TextVisualLayout, DecimalSeparator, ThousandsSeparator, TrailingMinusNumbers, Local)

Выражение Переменная, представляющая объект Workbooks .

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
FileName	Обязательный	String	Указывает имя файла текстового файла, который необходимо открыть и проанализировать.
Происхождения	Необязательный	Variant	Указывает источник текстового файла. Может быть одной из следующих констант XlPlatform : xlMacintosh, xlWindows или xlMSDOS. Кроме того, это может быть целое число, представляющее номер кодовой страницы требуемой кодовой страницы. Например, "1256" указывает, что исходный текстовый файл кодируется на арабском языке (Windows). Если этот аргумент опущен, метод использует текущий параметр источника файла в мастере импорта текста.
StartRow	Необязательный	Variant	Номер строки, с которой начинается синтаксический анализ текста. Значение по умолчанию равно 1.
DataType	Необязательный	Variant	Задает формат столбца данных в файле. Может быть одной из следующих констант XlTextParsingType : xlDelimited или xlFixedWidth. Если этот аргумент не указан, Microsoft Excel пытается определить формат столбца при открытии файла.
TextQualifier	Необязательный	XlTextQualifier	Задает квалификатор текста.
ПоследовательныйДелимитер	Необязательный	Variant	Значение true , чтобы последовательные разделители считались одним разделителем. Значение по умолчанию - false.
Вкладка	Необязательный	Variant	Значение true , чтобы символ табуляции был разделителем (DataType должен быть xlDelimited). Значение по умолчанию — False.
Точка с запятой	Необязательный	Variant	Значение true , чтобы символ с запятой был разделителем (DataType должен быть xlDelimited). Значение по умолчанию — False.
Запятой	Необязательный	Variant	Значение true , чтобы символ запятой был разделителем (DataType должен быть xlDelimited). Значение по умолчанию — False.
Space	Необязательный	Variant	Значение true , чтобы символ пробела был разделителем (DataType должен быть xlDelimited). Значение по умолчанию — False.
Other	Необязательный	Variant	Значение true , чтобы символ, заданный аргументом OtherChar , был разделителем (DataType должен быть xlDelimited). Значение по умолчанию — False.
OtherChar	Необязательный	Variant	Требуется, если значение Other имеет значение True. Указывает символ разделителя, если значение Other имеет значение True. Если задано несколько символов, используется только первый символ строки; остальные символы игнорируются.
Fieldinfo	Необязательный	Variant	Массив, содержащий сведения для анализа отдельных столбцов данных. Интерпретация зависит от значения DataType. Если данные разделены, этот аргумент представляет собой массив массивов двухэлементных массивов, при этом каждый двухэлементный массив задает параметры преобразования для определенного столбца. Первый элемент — это номер столбца (на основе 1), а второй — одна из констант XlColumnDataType , указывающая способ синтаксического анализа столбца.
TextVisualLayout	Необязательный	Variant	Визуальный макет текста.
DecimalSeparator	Необязательный	Variant	Десятичный разделитель, который Microsoft Excel использует при распознавании чисел. По умолчанию используется системный параметр.
ThousandsSeparator	Необязательный	Variant	Разделитель тысяч, который Excel использует при распознавании чисел. По умолчанию используется системный параметр.
TrailingMinusNumbers	Необязательный	Variant	Укажите значение True , если числа с символом минус в конце должны рассматриваться как отрицательные числа. Если значение False или опущено, числа с символом минус в конце обрабатываются как текст.
Local	Необязательный	Variant	Укажите значение True , если региональные параметры компьютера должны использоваться для разделителей, чисел и форматирования данных.

Замечания

Параметр FieldInfo

Используйте xlEMDFormat , только если вы установили и выбрали поддержку тайваньского языка. Константа xlEMDFormat указывает, что используются даты тайваньской эры.

Описатели столбцов могут находиться в любом порядке. Если для определенного столбца во входных данных нет описателя столбца, то столбец анализируется с помощью параметра Общие.

В этом примере третий столбец анализируется как MDY (например, 10.01.1970), первый столбец анализируется как текст, а остальные столбцы в исходных данных анализируются с помощью параметра "Общие".

Array(Array(3, 3), Array(1, 2))

Если исходные данные содержат столбцы фиксированной ширины, первый элемент в каждом двухэлейном массиве задает положение начального символа в столбце (в виде целого числа; символ 0 (нуль) — первый символ). Второй элемент в массиве с двумя элементами задает параметр синтаксического анализа для столбца в виде числа от 0 до 9, как показано в предыдущей таблице.

Параметр ThousandsSeparator

В следующей таблице показаны результаты импорта текста в 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 (числовое значение)

Пример

В этом примере открывается файл Data.txt и используются разделители табуляции для синтаксического анализа текстового файла на листе.

Workbooks.OpenText filename:="DATA.TXT", _ 
    dataType:=xlDelimited, tab:=True

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.