Exponenta Banner
exponenta event banner

xlswrite

Запишите файл электронной таблицы Microsoft Excel

свернуть все на странице

Синтаксис

xlswrite(filename,A)
xlswrite(filename,A,sheet)
xlswrite(filename,A,xlRange)
xlswrite(filename,A,sheet,xlRange)
status = xlswrite(___)
[status,message] = xlswrite(___)

Описание

пример

xlswrite(filename,A) пишет матричный A в первый рабочий лист в рабочей книге электронной таблицы Microsoft® Excel® filename, запускающийся в ячейке A1.

xlswrite(filename,A,sheet) пишет в заданный рабочий лист.

xlswrite(filename,A,xlRange) пишет в прямоугольную область, заданную xlRange в первом рабочем листе рабочей книги. Используйте синтаксис области значений Excel, такой как 'A1:C3'.

пример

xlswrite(filename,A,sheet,xlRange) пишет в заданный рабочий лист и область значений.

status = xlswrite(___) возвращает состояние операции записи, с помощью любого из входных параметров в предыдущих синтаксисах. Когда операция успешна, состоянием является 1. В противном случае состоянием является 0.

[status,message] = xlswrite(___) дополнительно возвращает любое предупреждающее сообщение или сообщение об ошибке, сгенерированное операцией записи в структуре message.

Примеры

свернуть все

Открыть скрипт

Запишите вектор с 7 элементами в файл Excel®.

filename = 'testdata.xlsx';
A = [12.7 5.02 -98 63.9 0 -.2 56];
xlswrite(filename,A)
Открыть скрипт

Запишите смешанный текст и числовые данные к файлу Excel®, запускающемуся в ячейке E1 Sheet2.

filename = 'testdata.xlsx';
A = {'Time','Temperature'; 12,98; 13,99; 14,97};
sheet = 2;
xlRange = 'E1';
xlswrite(filename,A,sheet,xlRange)

Warning: Added specified worksheet.

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

свернуть все

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

Если filename не существует, xlswrite создает файл, определяя формат на основе заданного расширения. Чтобы создать файл, совместимый с программным обеспечением Excel 97-2003, задайте расширение .xls. Чтобы создать файлы в форматах Excel 2007, задайте расширение .xlsx, .xlsb или .xlsm. Если вы не задаете расширение, xlswrite использует значение по умолчанию, .xls.

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

Пример: C: \myFolder\myFile.xlsx'

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

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

Введите матрицу, заданную как двумерное числовое, символьный массив или массив строк, или, если каждая ячейка содержит единственный элемент, массив ячеек.

Если A является массивом ячеек, содержащим что-то другое, чем числовой скаляр или текст, то xlswrite тихо оставляет соответствующую ячейку в электронной таблице пустой.

Максимальный размер массива A зависит от связанной версии Excel. Для получения дополнительной информации о спецификациях Excel и пределах, смотрите справку Excel.

Пример: [10,2,45;-32,478,50]

Пример: {92.0, 'Да', 45.9, 'Нет'}

Пример: "ABCDEF"

Типы данных: единственный | удваиваются | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | логический | char | строка | ячейка

Имя рабочего листа, заданное как одно из следующего:

  • Вектор символа или строка, которая содержит имя рабочего листа. Имя не может содержать двоеточие (:). Чтобы определить имена листов в файле электронной таблицы, используйте xlsfinfo.

  • Положительное целое число, которое указывает на индекс рабочего листа.

Если sheet не существует, xlswrite добавляет новый лист в конце набора рабочего листа. Если sheet является индексом, больше, чем количество рабочих листов, xlswrite добавляет пустые листы, пока количество рабочих листов в рабочей книге не равняется sheet. В любом случае xlswrite генерирует предупреждение, указывающее, что это добавило новый рабочий лист.

Типы данных: char | представляет в виде строки | единственный | дважды | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Прямоугольная область значений, заданная как вектор символа или строка.

Задайте xlRange с помощью двух противостоящих углов, которые задают область, чтобы записать. Например, 'D2:H4' представляет прямоугольную область 3 на 5 между этими двумя углами D2 и H4 на рабочем листе. Входной параметр xlRange не является чувствительным к регистру, и использует стиль ссылки Excel A1 (см. справку Excel). xlswrite не распознает названные области значений.

  • Если вы не задаете sheet, то xlRange должен включать оба угла и символ двоеточия, даже для отдельной ячейки (такие как 'D2:D2'). В противном случае xlswrite интерпретирует входной параметр как имя рабочего листа (такое как 'D2').

  • Если вы задаете sheet, то xlRange может задать только первую ячейку (такую как 'D2'). xlswrite пишет входному массиву A, начинающийся в этой ячейке.

  • Если xlRange больше, чем размер входного массива A, программное обеспечение Excel заполняет остаток от области с #N/A. Если xlRange меньше, чем размер A, то xlswrite пишет только подмножество, которое вписывается в xlRange к файлу.

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

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

свернуть все

Состояние операции записи, возвращенной или как 1 (true) или как 0 (false). Когда операция записи успешна, status является 1. В противном случае status является 0.

Ошибка или предупреждение сгенерированного во время операции записи, возвращенной как массив структур, содержащий два поля:

сообщениеТекст предупреждающего сообщения или сообщения об ошибке.
identifierИдентификатор сообщения.

Ограничения

  • Если ваш компьютер не имеет Excel для Windows®, или вы используете MATLAB® Online™, то функция xlswrite:

    • Массив записей A к текстовому файлу в формате разделенного от запятой значения (CSV). A должен быть числовой матрицей.

    • Игнорирует аргументы sheet и xlRange.

    Это ограничение также применяется, когда сервер COM (часть типовой установки Excel) не доступен.

Советы

  • Если ваш компьютер имеет программное обеспечение Microsoft Office 2003, но вы хотите создать файл в формате Excel 2007, установить Пакет Совместимости Office 2007.

  • Excel и MATLAB могут сохранить даты как текст, который представляет те даты (такие как '10/31/96') или последовательные числа даты (такие как 729329). Если ваш массив включает последовательные числа даты, преобразуйте эти даты в их текстовое представление с помощью datestr прежде, чем вызвать xlswrite.

  • Чтобы записать данные к файлам Excel с пользовательскими форматами (такими как шрифты или цвета), получите доступ к серверу Windows COM непосредственно с помощью actxserver, а не xlswrite. Например, этот MathWorks Support Answer использует actxserver, чтобы установить связь между MATLAB и Excel, записывает данные к рабочему листу и задает цвета ячеек.

Алгоритмы

Excel преобразовывает значения Inf в 65535. MATLAB преобразовывает значения NaN в пустые ячейки.

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

| | |

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

Была ли эта тема полезной?
Документация MATLAB
Поддержка