Статьи‎ > ‎GameWithFire‎ > ‎

Методы

AddIn.ADOUtils

ADORecordsetВТаблицуЗначений ( ADORecordset ) / ADORecordsetToValueTable

Параметры:

ADORecordset - тип: COM объект ADORecordset. Набор записей - источник данных.

Возвращает: тип: ТаблицаЗначений. Новая таблица значений заполненная данными набора записей.

Описание: Метод создает новую таблицу значений с колонками соответствующими колонкам переданного набора записей. И переносит содержимое набора записей в таблицу значений. При создании колонок в таблице значений, им назначается тип соответствующий типу поля ADORecordset.
Соответствие типов:

  • adChar, adVarChar, adWChar, adVarWChar, adBSTR: Строка(n); где n - DefinedSize, переменная длина;
  • adDecimal, adNumeric: Число(p, s), где p - Precision; s - Scale; любой знак;
  • adUnsignedTinyInt: Число(3, 0), любой знак;
  • adSmallInt, adUnsignedSmallInt: Число(5, 0), любой знак;
  • adInteger, adUnsignedInt: Число(10, 0), любой знак;
  • adBigInt, adUnsignedBigInt: Число(20, 0), любой знак;
  • adDate, adDBDate, adDBTime, adDBTimeStamp: Дата, дата и время;
  • adBoolean: Булево.

А также колонка может содержать тип Null.
Для остальных типов ADO тип колонки таблицы значений не назначается.
Правила назначения имени колонки: если имя в результате запроса пустое, назначается имя '_', если в имени есть символы не буквы и не цифры они заменяются на символ '_', если первый символ имени цифра, он заменяется на символ '_'; затем, если получилось такое имя, которое уже присутствует в коллекции колонок, то имя новой колонки будет образовано путем добавления суффикса с индексом начиная от 1.

ADORecordsetВРезультатЗапроса ( ADORecordset[, Итоги] ) / ADORecordsetToQueryResult

Параметры:

ADORecordset     - тип: COM объект ADORecordset. Набор записей - источник данных.
Итоги                    - тип: Строка. Строка описания итогов (ресурсов и измерений) для результата запроса. Необязательный. По-умолчанию - пустая строка.

Возвращает: тип: РезультатЗапроса.

Описание: Позволяет получить объект типа РезультатЗапроса для набора данных. Реализован с помощью объекта ПостроительЗапроса. Настройка объекта ОписаниеИсточиникаДанных для построителя запроса описывается параметром Итоги.

Формат строки итогов:
[<Ресурс>[,...n]] [ПО <Измерение>[,...n]]

<Ресурс>
<Выражение> [КАК <ИмяРесурса>]
<Выражение>
Выражение на языке запросов допустимое при описании источника данных для построителя запроса в свойстве КолонкаОписанияИсточникаДанных::Итог.
<ИмяРесурса>
Имя колонки в источнике данных для помещения результата выражения.
<Измерение>
Имя колонки в источнике данных которая будет являться измерением.


Замечание 1. Если ИмяРесурса не указано, то имя ресурса подбирается автоматически по колонке использованной в выражении. Если в выражении используется несколько колонок, необходимо явное указание имени ресурса с помощью ключевого слова КАК. При явном указании имени ресурса ключевое слово КАК не указывать не допускается.
Замечание 2. Необходимо помнить что при задании хотя бы одного ресурса или измерения в результате запроса всегда присутствует общий итог (по всем записям). Это ограничение объекта ПостроительЗапроса.

InflateData ( ADOFiled [,ЧислоБайт] )

Параметры:

ADOFiled        - тип: COM объект ADOFieldObject. Поле данных, выборки результата запроса
ЧислоБайт    - тип: Число. Количество байт, которые нужно получить с начала файла. Необязательный. Если значение не указано тогда получает все

Возвращает: тип: COMSafeArray типа VT_UI1 с одним измерением.

Описание: Получает данные распакованной записи. Данные представляют собой "сырые" байты - никак не обработанные, а только распакованные. Необходим для определения того, что содержит в себе запись:
  • Строку;
  • Двоичные данные;
  • Контейнер;
COMSafeArray в данном случае используется потому как двоичные данные записи могут содержать любые данные, в том числе и те которые нельзя представить в виде строки. См. также: представления символов в ASCii кодах

InflateToString ( ADOFiled )

Параметры:

ADOFiled    - тип: COM объект ADOFieldObject. Поле данных, выборки результата запроса

Возвращает: тип: Строка.

Описание: Получает распакованную строку из поля содержащего двоичные данные. Если в начале распакованных данных не будет находится маркера кодировки UTF-8 будет вызвано исключение. Данный метод рекомендуется использовать только после  InflateData (который и может определить наличие маркера, см. представления символов в ASCii кодах). Перед выполнением метода нужно с позиционироваться на записи и не закрывать ее.

InflateToFile( ADOFiled, ИмяФайла )

Параметры:

ADOFiled    - тип: COM объект ADOFieldObject. Поле данных, выборки результата запроса
ИмяФайла    - тип: Строка. Имя файла, в который будут распакованы данные, если файл не существует он будет создан.

Описание: Выгружает и распаковывает двоичные данные из поля в файл.

DefateData ( ADOFiled , МассивБайт )

Параметры:

ADOFiled          - тип: COM объект ADOFieldObject. Поле данных или параметр, запроса
МассивБайт    - тип: COMSafeArray типа VT_UI1 с одним измерением. Байты данных для запаковки.

Возвращаемое значение: Число. Размер упакованного поля в байтах.
Описание:
Упаковывает содержимое массива байтов,
и помешает результат в ADOFiled.

DefateFromString ( ADOFiled , Строка )

Параметры:

ADOFiled      - тип: COM объект ADOFieldObject. Поле данных или параметр, запроса
Строка         - тип: Строка, которую необходимо упаковать.

Возвращаемое значение: Число. Размер упакованного поля в байтах.
Описание: Упаковывает строку, и помешает результат в ADOFiled. Метод сохраняет строку в кодировке UTF-8 и соответственно помещает её маркер.

DefateFromFile ( ADOFiled , ИмяФайла)

Параметры:

ADOFiled      - тип: COM объект ADOFieldObject. Поле данных или параметр, запроса
Строка         - тип: Имя файла подлежащего упаковке.

Возвращаемое значение: Число. Размер упакованного поля в байтах.
Описание: Упаковывает файл, и помешает результат в ADOFiled.

GetUsersFile( ADOFiled)

Параметры: 

ADOFiled      - тип: COM объект ADOFieldObjectПоле данных запроса (SELECT BinaryData FROM dbo.Params WHERE FileName = 'user.usr')

Возвращаемое значение: Строка.
Описание: Получает распакованную строку из поля содержащего двоичные данные описывающих пользователей.

PutUsersFile( ADOFiled, Строка)

Параметры: 

ADOFiled      - тип: COM объект ADOFieldObjectПоле данных (SELECT BinaryData FROM dbo.Params WHERE FileName = 'user.usr') или параметр запроса 

Строка         - тип: Строка. Строка, которую необходимо записать.

Возвращаемое значение: Число. Размер упакованного поля в байтах.
Описание: Сохраняет строку в формат двоичных данных описывающих пользователей

V8DateToDBDate( Дата)

Параметры: 

Дата         - тип: Дата. Дата, которую необходимо преобразовать в дату хранения СУБД MSSQL.

Возвращаемое значение: Дата.
Описание: Преобразовывает дату из формата 1С в формат СУБД MSSQL с учетом смещения дат (установленного свойства YearOffset) 

BooleanParameter( Значение )

Параметры: 

Значение         - тип: Булево

Возвращаемое значение: COMSafeArray(1) типа VT_UI1 с одним измерением
Описание:
 Перобразовывает значение в формат хранения данных в СУБД

TypeParameter( Значение )

Параметры: 

Значение         - тип: Тип

Возвращаемое значение: COMSafeArray(1) типа VT_UI1 с одним измерением
Описание:
 Преобразовывает значение в формат хранения данных в СУБД,  данные такого типа хранятся в полях *_TYPE

TableNumberParameter( Значение )

Параметры: 

Значение         - тип: Число(10,0)

Возвращаемое значение: COMSafeArray(4) типа VT_UI1 с одним измерением
Описание:
 Преобразовывает значение в формат хранения данных в СУБД
,  данные такого типа хранятся в полях *_RTRef и фактически обозначают номер таблицы для полей составного типа

DataVersionParameter( Значение )

Параметры: 

Значение         - тип: Число. Номер версии данных

Возвращаемое значение: COMSafeArray(8) типа VT_UI1 с одним измерением
Описание:
 Преобразовывает значение в формат хранения данных в СУБД

RRefParameter( Значение )

Параметры: 

Значение         - тип: Любая ссылка

Возвращаемое значение: COMSafeArray(16) типа VT_UI1 с одним измерением
Описание:
 Преобразовывает значение в формат хранения данных в СУБД



AddIn.V8Storage

Open( ИмяФайла )


Параметры:

ИмяФайла    - тип: Строка. Имя файла, в котором находится хранилище формата 1С.

Описание: Открывает файл хранилища.

Create( ИмяФайла )


Параметры:

ИмяФайла    - тип: Строка. Имя файла, если файл не существует он будет создан.

Описание: Создает новое хранилище.

Close( ИмяФайла )


Параметры:

ИмяФайла    - тип: Строка. Имя файла, в котором находится хранилище формата 1С.

Описание: Закрывает, ранее открытый файл хранилища

V8StorageItems

Count( )


Описание: Возвращает количество потоков в коллекции

Get ( ЗаголовокПотока )


Параметры:

ЗаголовокПотока    - тип: Строка. Имя потока, в хранилище.

Возвращаемое значение: V8Streаm
Описание: Получает поток хранилища по имени.

Add ( ЗаголовокПотока )


Параметры:

ЗаголовокПотока    - тип: Строка. Имя потока, должно быть уникально в рамках хранилища.

Возвращаемое значение: V8Streаm
Описание: Создает(добавляет) новый поток в хранилище

Delete ( ЗаголовокПотока )


Параметры:

ЗаголовокПотока    - тип: Строка. Имя потока, в хранилище.

Описание: Удаляет поток из хранилища.

V8Stream

GetData ( Inflate [,ЧислоБайт] )

Параметры:

Inflate            - тип: Булево. Определяет необходимость распаковки данных.
ЧислоБайт    - тип: Число. Количество байт, которые нужно получить с начала потока. Необязательный. Если значение не указано тогда получает все

Возвращает: тип: COMSafeArray типа VT_UI1 с одним измерением.

Описание: Получает массив данных текущего потока. Необходим для определения того что содержит в себе поток:
  • Строку;
  • Двоичные данные;
  • Контейнер;
Массив данных в данном случае используется потому как двоичные данные могут содержать любые данные, в том  числе и те которые, нельзя представить в виде строки. Аналогичен методу InflateData объекта AddIn.ADOUtils

GetDataToString ( Iiflate )

Параметры:

Inflate            - тип: Булево. Определяет необходимость распаковки данных.

Возвращает: тип: Строка.

Описание: Получает строку из текущего потока. Если в начале распакованных данных не будет находится маркера кодировки UTF-8 будет вызвано исключение. Данный метод рекомендуется использовать только после  GetData ( который и может определить наличие маркера). Аналогичен методу InflateToString  объекта AddIn.ADOUtils

GetDataToFile( ИмяФайла, Inflate )

Параметры:

ИмяФайла     - тип: Строка. Имя файла, в который будут выгружен поток, если файл не существует он будет создан.

Inflate            - тип: Булево. Определяет необходимость распаковки данных.

Описание: Выгружает поток в файл. Аналогичен методу InflateToFile  объекта AddIn.ADOUtils

PutData ( Deflate, МассивБайт )

Параметры:

Deflate              - тип: Булево. Определяет необходимость упаковки данных.
МассивБайт    - тип: COMSafeArray типа VT_UI1 с одним измерением.

Возвращаемое значение: Число. Размер потока в байтах.
Описание:
На основе массива байтов формирует поток
. Аналогичен методу DefateData  объекта AddIn.ADOUtils

PutDateFromString ( Строка , Deflate )

Параметры:

Строка         - тип: Строка, которую необходимо упаковать.

Deflate         - тип: Булево. Определяет необходимость упаковки данных.

Возвращаемое значение: Число. Размер потока в байтах.
Описание: Помещает строку в поток. Метод сохраняет строку в кодировке UTF-8 и соответственно помещает её маркер. Аналогичен методу DefateFromString  объекта AddIn.ADOUtils

PutDateFromFile (  ИмяФайла , Delate )

Параметры:

Строка         - тип: Имя файла, который нужно поместить в поток.
Deflate         - тип: Булево. Определяет необходимость упаковки данных.

Возвращаемое значение: Число. Размер потока в байтах.
Описание: Помещает файл в поток. Аналогичен методу DefateFromFile   объекта AddIn.ADOUtils

Показывать 23 элементов
Класс/ОбъектИмяОписаниеПараметрыВозвр. значение
Сортировать 
 
Сортировать 
 
Сортировать 
 
Сортировать 
 
Сортировать 
 
Класс/ОбъектИмяОписаниеПараметрыВозвр. значение
AddIn.ADOUtils V8DateToDBDate Преобразовывает дату из формата 1С в формат СУБД MSSQL с учетом смещения дат (установленного свойства YearOffset)  Дата Дата 
AddIn.ADOUtils InflateToString Получает распакованную строку из поля содержащего двоичные данные ADOFiled - тип: COM объект ADOFieldObject. Поле данных, выборки результата запроса Строка 
AddIn.ADOUtils InflateData Получает данные распакованной записи. Данные представляют собой "сырые" байты - никак не обработанные, а только распакованные. Необходим для определения того, что содержит в себе запись. ADOFiled - тип: COM объект ADOFieldObject. Поле данных, выборки результата запроса ЧислоБайт - тип: Число. Количество бат которые нужно получить с начала файла. Необязательный.  COMSafeArray типа VT_UI1 с одним измерением 
AddIn.ADOUtils GetUsersFile Получает распакованную строку из поля содержащего двоичные данные описывающих пользователей ADOFiled - тип: COM объект ADOFieldObject. Поле данных запроса (SELECT BinaryData FROM dbo.Params WHERE FileName = 'user.usr') Строка 
AddIn.ADOUtils InflateToFile Выгружает и распаковывает двоичные данные из поля в файл. ADOFiled - тип: COM объект ADOFieldObject. Поле данных, выборки результата запроса ИмяФайла - тип: Строка. Имя файла, в который будут распакованы данные, если файл не существует он будет создан.  
AddIn.ADOUtils ADORecordsetВТаблицуЗначений Метод создает новую таблицу значений с колонками соответствующими колонкам переданного набора записей. И переносит содержимое набора записей в таблицу значений.. ADORecordset - тип: COM объект ADORecordset. ТаблицаЗначений. Новая таблица значений заполненная данными набора записей. 
AddIn.ADOUtils DefateFromFile Упаковывает файл, и помешает результат в ADOFiled ADOFiled - тип: COM объект ADOFieldObject. Поле данных или параметр, запроса Строка - тип: Имя файла подлежащего упаковке. Число. Размер упакованных данных 
AddIn.ADOUtils DefateData Упаковывает содержимое массива байтов, и помешает результат в ADOFiled. ADOFiled - тип: COM объект ADOFieldObject. Поле данных или параметр, запроса МассивБайт - тип: COMSafeArray типа VT_UI1 с одним измерением. Байты данных для запаковки. Число. Размер упакованных данных 
AddIn.ADOUtils DefateFromString Упаковывает строку, и помешает результат в ADOFiled. ADOFiled - тип: COM объект ADOFieldObject. Поле данных или параметр, запроса Строка - тип: Строка, которую необходимо упаковать. Число. Размер упакованных данных. 
AddIn.ADOUtils ADORecordsetВРезультатЗапроса Позволяет получить объект типа РезультатЗапроса для набора данных. Реализован с помощью объекта ПостроительЗапроса. ADORecordset - тип: COM объект ADORecordset. Набор записей - источник данных. Итоги - тип: Строка. Строка описания итогов (ресурсов и измерений) для результата запроса. Необязательный. По-умолчанию - пустая строка. РезультатЗапроса 
AddIn.ADOUtils PutUsersFile Сохраняет строку в формат двоичных данных описывающих пользователей ADOFiled - тип: COM объект ADOFieldObject. Поле данных (SELECT BinaryData FROM dbo.Params WHERE FileName = 'user.usr') или параметр запроса Строка - тип: Строка, которую необходимо записать. Число. Размер упакованного поля в байтах 
AddIn.V8Storage Close Закрывает, ранее открытый файл хранилища ИмяФайла - тип: Строка. Имя файла, в котором находится хранилище формата 1С.  
AddIn.V8Storage Open Открывает файл хранилища ИмяФайла - тип: Строка. Имя файла, в котором находится хранилище формата 1С  
V8StorageItems Get Получает поток хранилища по имени. ЗаголовокПотока - тип: Строка. Имя потока, в хранилище. V8Streаm 
V8StorageItems Add  Создает(добавляет) новый поток в хранилище ЗаголовокПотока - тип: Строка. Имя потока. V8Streаm 
V8StorageItems Delete Удаляет поток из хранилища. ЗаголовокПотока - тип: Строка. Имя потока, в хранилище.  
V8StorageItems Count Возвращает количество потоков в коллекции  Число 
V8Stream GetDataToString Получает строку из текущего потока. Inflate - тип: Булево. Определяет необходимость распаковки данных. Строка 
V8Stream GetDataToFile Выгружает поток в файл ИмяФайла - тип: Строка. Имя файла, в который будут выгружен поток. Inflate- тип: Булево. Определяет необходимость распаковки данных.   
V8Stream PutDateFromString Помещает строку в поток Строка - тип: Строка, которую необходимо упаковать. Deflate - тип: Булево. Определяет необходимость упаковки данных. Число. Размер потока. 
V8Stream GetData Получает массив данных текущего потока. Необходим для определения того что содержит в себе поток Inflate тип: Булево. Определяет необходимость распаковки данных. ЧислоБайт - тип: Число. Количество байт, которые нужно получить с начала потока.  COMSafeArray типа VT_UI1 с одним измерением. 
V8Stream PutDateFromFile Помещает файл в поток Строка- тип: Имя файла, который нужно поместить в поток. Deflate - тип: Булево. Определяет необходимость упаковки данных. Число. Размер потока. 
V8Stream PutData На основе массива байтов формирует поток. Deflate - тип: Булево. Определяет необходимость упаковки данных. МассивБайт - тип: COMSafeArray типа VT_UI1 с одним измерением. Число. Размер потока 
Показывать 23 элементов