Table.SaveToBuffer - Revision history

Admin: 1 revision imported

2024-03-20T12:02:10Z

1 revision imported

1>Admin at 16:11, 8 February 2024

2024-02-08T16:11:08Z

Admin: 1 revision imported

2021-03-04T14:58:02Z

1 revision imported

Admin at 10:52, 27 February 2021

2021-02-27T10:52:57Z

Admin: 1 revision imported

2021-02-07T06:54:29Z

1 revision imported

Admin at 15:40, 4 February 2021

2021-02-04T15:40:31Z

New page

{{infobox function
|name=SaveToBuffer
|object=[[Электронная таблица SFT|Электронная таблица]]
|caption=Сохранение таблицы
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку, число, неверные аргументы
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Электронная таблица SFT|Электронная таблица]]}}
Функция производит сохранение текущей таблицы в буфер в указанном формате с указанными установками. Внутренний ''SFT'' формат все данные хранит в виде строк, поэтому при сохранении в формат, хранящий числа не в текстовом формате (к примеру, в xls), система превращает текст ячейки в число автоматически при отсутствии в строке неверных знаков. Разрешены только знаки ''-'',''0''..''9'', ''.'' и ''E'', разделителем целой и дробной частей числа всегда принимается точка. Знаки ''`'', ''пробел'' и <i>'</i> также могут принадлежать числам, как разделители разрядов. Если число содержит неверные знаки, оно будет экспортировано как строка, без каких либо изменений. Также если число содержит ведущие нули (к примеру, <code>000000123456</code>), оно будет экспортировано как строка. Программа экспорта не пытается определять даты и время, даты всегда будут экспортированы как строки.

== Синтаксис ==
<code>
{{Grey|Table.}}'''SaveToBuffer'''(''<Объект буфера (BUFFER)>''{{Optional|,<Начальная позиция буфера (INT)>{{Default|{{Eq}}0}},<Формат (INT,STRING)>{{Default|{{Eq}}0}},<Установки (INT)>{{Default|{{Eq}}0}}}}):''<Размер в байтах, добавленный в буфер (INT)>''
</code>

==== Аргументы ====
* <code>''<Объект буфера (BUFFER)>''</code> - Аргумент задает объект буфера, куда будет производиться сохранение таблицы.
* <code>''<Начальная позиция буфера (INT)>''</code> - {{Optional}} Аргумент задает начальную позицию таблицы в буфере, если аргумент опущен, сохранение будет происходить с начала буфера.
* <code>''<Формат (INT,STRING)>''</code> - {{Optional}} Аргумент задает формат загружаемого файла в строковом или числовом виде. Доступны следующие значения:
** '''0''' или '''SFT''' (по умолчанию) -- файл во внутреннем формате системы (sft)
** '''1''' или '''XLS''' -- файл в формате Excel (xls)
** '''2''' или '''XLSX''' -- {{Planned}} файл в формате Excel (xlsx)
* <code>''<Установки (INT)>''</code> - {{Optional}} Аргумент задает дополнительные установки при сохранении, и является битовой маской. Доступны следующие значения битов:
** '''бит 0''' -- запрет сохранения вместе с таблицей картинок, которые были загружены в таблицу с диска или из буфера. По умолчанию режим не активен. Режим может пригодиться, например, если сохраняемая таблица может содержать сканируемые картинки, которые не выгодно отправлять по Интернет для печати на удаленной стороне, и картинки будут передаваться отдельно и только в случае, если они уже не присутствуют на удаленной стороне.

==== Возвращаемое значение ====
Возвращает число -- размер таблицы, сохраненной в буфер.

== Примеры ==
<pre>
Т:=Table.Create();
Т.SetSourceName("Продажи");
Т.CopyByX("v1",1);

Строк:=0;
While З.Next(1) Do
зДок:=З.Документ;
If (зДок.DBName()<>"Реализация")And(зДок.DBName()<>"ВозвратОтПокупателя") Then
Continue;
EndIf;

...

Т.CopyByX("v2",1);
EndDo;

аБуф:=Buffer.Create();
Т.SaveToBuffer(аБуф);

//Отправить буфер по TCP/IP
...
</pre>

← Older revision	Revision as of 12:02, 20 March 2024
(No difference)

@@ Line 17: / Line 17: @@
 == Синтаксис ==
 <code>
-{{Grey|Table.}}'''SaveToBuffer'''(''<Объект буфера (BUFFER)>''{{Optional|,<Начальная позиция буфера (INT)>{{Default|{{Eq}}0}},<Формат (INT,STRING)>{{Default|{{Eq}}0}},<Установки (INT)>{{Default|{{Eq}}0}}}}):''<Размер в байтах, добавленный в буфер (INT)>''
+{{Grey|Table.}}'''SaveToBuffer'''(''<Объект буфера (BUFFER)>''{{Optional|,<Начальная позиция буфера (INT)>{{Default|{{Eq}}0}},<Формат (INT,STRING)>{{Default|{{Eq}}0}},<Установки (INT)>{{Default|{{Eq}}0}},<Список таблиц для сохранения в листы книги (LIST)>}}):''<Размер в байтах, добавленный в буфер (INT)>''
 </code>
@@ Line 36: / Line 36: @@
 * <code>''<Установки (INT)>''</code> - {{Optional}} Аргумент задает дополнительные установки при сохранении, и является битовой маской. Доступны следующие значения битов:
 ** '''бит 0''' -- запрет сохранения вместе с таблицей картинок, которые были загружены в таблицу с диска или из буфера. По умолчанию режим не активен. Режим может пригодиться, например, если сохраняемая таблица может содержать сканируемые картинки, которые не выгодно отправлять по Интернет для печати на удаленной стороне, и картинки будут передаваться отдельно и только в случае, если они уже не присутствуют на удаленной стороне.
 ==== Возвращаемое значение ====
-Возвращает число -- размер таблицы, сохраненной в буфер.
+Возвращает число -- размер данных, сохраненных в буфер.
 == Примеры ==

← Older revision	Revision as of 14:58, 4 March 2021
(No difference)

@@ Line 25: / Line 25: @@
 * <code>''<Формат (INT,STRING)>''</code> - {{Optional}} Аргумент задает формат загружаемого файла в строковом или числовом виде. Доступны следующие значения:
 ** '''0''' или '''SFT''' (по умолчанию) -- файл во внутреннем формате системы (sft)
-** '''1''' или '''XLS''' -- файл в формате Excel (xls)
+** '''1''' или '''XLS''' -- файл в формате Excel (xls). При экспорте в формат ''xls'' имеются следующие ограничения:
-** '''2''' или '''XLSX''' -- {{Planned}} файл в формате Excel (xlsx)
+*** Не экспортируются картинки, внедренные на лист в виде объектов
 * <code>''<Установки (INT)>''</code> - {{Optional}} Аргумент задает дополнительные установки при сохранении, и является битовой маской. Доступны следующие значения битов:
 ** '''бит 0''' -- запрет сохранения вместе с таблицей картинок, которые были загружены в таблицу с диска или из буфера. По умолчанию режим не активен. Режим может пригодиться, например, если сохраняемая таблица может содержать сканируемые картинки, которые не выгодно отправлять по Интернет для печати на удаленной стороне, и картинки будут передаваться отдельно и только в случае, если они уже не присутствуют на удаленной стороне.

← Older revision	Revision as of 06:54, 7 February 2021
(No difference)