xlsfinfo

Определите, содержит ли файл электронную таблицу Microsoft Excel

Синтаксис

status = xlsfinfo(filename)
[status,sheets] = xlsfinfo(filename)
[status,sheets,xlFormat] = xlsfinfo(filename)

Описание

status = xlsfinfo(filename) указывает, является ли filename файлом, который может считать функция xlsread.

[status,sheets] = xlsfinfo(filename) дополнительно возвращает имя каждой электронной таблицы в файле.

пример

[status,sheets,xlFormat] = xlsfinfo(filename) также возвращает описание формата, которое Excel® возвращает для файла. В системах без Excel для Windows® xlFormat является пустым символьным вектором, ''.

Примеры

свернуть все

Создайте демонстрационный файл с именем Excel® myExample.xlsx.

values = {1, 2, 3 ; 4, 5, 'x' ; 7, 8, 9};
headers = {'First', 'Second', 'Third'};
xlswrite('myExample.xlsx', [headers; values]);

Вызовите xlsfinfo, чтобы получить информацию о файле.

[status,sheets,xlFormat] = xlsfinfo('myExample.xlsx')
status =

Microsoft Excel Spreadsheet


sheets = 

    'Sheet1'    'Sheet2'    'Sheet3'


xlFormat =

xlOpenXMLWorkbook

status содержит описательный текст, который указывает, что функция xlsread может считать файл примера.

Входные параметры

свернуть все

Имя файла, заданного как вектор символов или строка.

Пример: 'myFile.xlsx'

Типы данных: char | string

Выходные аргументы

свернуть все

Тип файла, возвращенного как вектор символов.

  • Если filename является файлом, который может считать xlsread, то status является описательным текстом, таким как 'Microsoft Excel Spreadsheet'.

  • Если filename не является файлом, который может считать xlsread, то status пуст, ''.

  • Если MATLAB® не может найти файл, то xlsfinfo возвращает ошибку.

Имена рабочего листа, возвращенные как 1-by-n массив ячеек из символьных векторов, где n является количеством рабочих листов в файле. Каждая ячейка содержит имя рабочего листа. Если xlsread не может считать конкретный рабочий лист, соответствующая ячейка содержит сообщение об ошибке.

Если xlsfinfo не может считать файл, то sheets содержит сообщение об ошибке.

Описание формата файла возвращено Excel, возвращенным как вектор символов.

В системах Windows с программным обеспечением Excel xlFormat является одним из следующих.

'xlOpenXMLWorkbook'Электронная таблица в формате XLSX (Excel 2007 или позже)
'xlWorkbookNormal' или 'xlExcel8'Электронная таблица в формате XLS (совместимый с Excel 97-2003)
'xlCSV'Файл в формате разделенного от запятой значения (CSV)
'xlHtml' или 'xlWebArchive'Электронная таблица экспортирована в формат HTML

Во всех других системах xlFormat является пустым символьным вектором, ''.

Ограничения

  • xlsfinfo поддерживает только 7-битные символы ASCII.

Советы

  • Если xlsfinfo предупреждает, что не может запустить сервер ActiveX®, то сервер COM, который является частью типичной установки Excel, недоступен. В этом случае рассмотрите переустановку вашего программного обеспечения Excel. В системах с Excel для Windows xlsfinfo использует сервер COM, чтобы получить информацию.

Смотрите также

| | |

Представлено до R2006a