Workbooks.OpenText Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Загружает и анализирует текстовый файл как новую книгу с одним листом, содержащим проанализированные данные текстового файла.
public void OpenText (string Filename, object Origin, object StartRow, object DataType, 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 TextVisualLayout, object DecimalSeparator, object ThousandsSeparator, object TrailingMinusNumbers, object Local);Public Sub OpenText (Filename As String, Optional Origin As Object, Optional StartRow As Object, Optional DataType As Object, 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 TextVisualLayout As Object, Optional DecimalSeparator As Object, Optional ThousandsSeparator As Object, Optional TrailingMinusNumbers As Object, Optional Local As Object)Параметры
- Filename
- String
Обязательный атрибут типа String. Указывает имя файла текстового файла, который необходимо открыть и проанализировать.
- Origin
- Object
Необязательный объект. Указывает источник текстового файла. Может быть одной из следующих XlPlatform констант: xlMacintosh, xlWindows или xlMSDOS. Кроме того, это может быть целое число, представляющее номер кодовой страницы требуемой кодовой страницы. Например, "1256" указывает, что кодировка исходного текстового файла — арабский (Windows). Если этот аргумент опущен, метод использует текущий параметр источника файла в мастере импорта текста.
- StartRow
- Object
Необязательный объект. Номер строки, с которой начинается синтаксический анализ текста. Значение по умолчанию равно 1.
- DataType
- Object
Необязательный объект. Задает формат столбца данных в файле. Может быть одной из следующих XlTextParsingType констант: xlDelimited или xlFixedWidth. Если этот аргумент не указан, Microsoft Excel пытается определить формат столбца при открытии файла.
- TextQualifier
- XlTextQualifier
Необязательный параметр XlTextQualifier. Задает квалификатор текста. Может быть одной из этих XlTextQualifier констант.xlTextQualifierDoubleQuotedefaultxlTextQualifierNonexlTextQualifierSingleQuote
- ConsecutiveDelimiter
- Object
Необязательный объект. Значение true , чтобы последовательные разделители считались одним разделителем. Значение по умолчанию - 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 , чтобы символ, заданный OtherChar аргументом, был разделителем (DataType должен быть xlDelimited). Значение по умолчанию — False.
- OtherChar
- Object
Необязательный объект (требуется, если Other имеет значение True). Указывает символ разделителя, если Other имеет значение True. Если задано несколько символов, используется только первый символ строки; остальные символы игнорируются.
- FieldInfo
- Object
Необязательный параметр XlColumnDataType. Массив, содержащий сведения для анализа отдельных столбцов данных. Интерпретация зависит от значения DataType. Если данные разделены, этот аргумент представляет собой массив массивов двухэлементных массивов, при этом каждый двухэлементный массив задает параметры преобразования для определенного столбца. Первый элемент — это номер столбца (на основе 1), а второй — одна из константXlColumnDataType , указывающая способ синтаксического анализа столбца. xlGeneralFormat ОбщийxlTextFormat TextxlMDYFormat MDY datexlDMYFormat DMY datexlYMDFormat YMD датаxlMYDFormat MYD datexlDYMFormat DYM datexlYDMFormat YDM datexlEMDFormat EMD datexlSkipColumn Skip ColumnYou может использовать xlEMDFormat только в том случае, если вы установили и выбрали поддержку тайваньского языка.
Константа xlEMDFormat указывает, что используются даты тайваньской эры. Описатели столбцов могут находиться в любом порядке. Если для определенного столбца во входных данных нет описателя столбца, то столбец анализируется с помощью параметра Общие. ЗаметкиЕсли указать, что столбец должен быть пропущен, необходимо явно указать тип для всех оставшихся столбцов, иначе данные не будут анализироваться правильно. Если в данных есть узнаваемая дата, ячейка будет отформатирована как дата на листе, даже если для столбца задано значение Общие. Кроме того, если указан один из указанных выше форматов дат для столбца, а данные не содержат распознанную дату, то формат ячейки на листе будет иметь значение General.Если исходные данные содержат столбцы фиксированной ширины, первый элемент в каждом двухэлейном массиве определяет положение начального символа в столбце (в виде целого числа; символ 0 (нуль) — это первый символ). Второй элемент в массиве с двумя элементами задает параметр синтаксического анализа для столбца в виде числа от 0 до 9, как показано в предыдущей таблице.
- TextVisualLayout
- Object
Необязательный объект. Визуальный макет текста.
- DecimalSeparator
- Object
Необязательный объект. Десятичный разделитель, который Microsoft Excel использует при распознавании чисел. Параметр по умолчанию — системный параметр.
- ThousandsSeparator
- Object
Необязательный объект. Разделитель тысяч, который Excel использует при распознавании чисел. Параметр по умолчанию — системный параметр. В следующей таблице показаны результаты импорта текста в Excel для различных параметров импорта. Числовые результаты отображаются в крайнем правом столбце.
- TrailingMinusNumbers
- Object
Необязательный объект.
- Local
- Object
Необязательный объект.