Добро пожаловать Гость, вы находитесь: Вход

Изображение Flexberry Wiki



  • Продукт: Flexberry ORM
  • Программная библиотека: ICSSoft.STORMNET.Tools.dll
  • Предназначение: Вспомогательные инструменты для сериализации, работы с XML, с почтой, сборками и т.д..






Библиотека ICSSoft.STORMNET.Tools.dll

Библиотека ICSSoft.STORMNET.Tools.dll предоставляет различные вспомогательные инструменты для работы, в её классах реализованы функции:
  • сериализации-десериализации,
  • работы с XML,
  • отправки почты,
  • сжатия файлов,
  • обработки подписанных сборок
  • и др..

Данные вспомогательные методы рекомендованы к применению разработчикам.
Рассмотрим подробнее некоторые из них.

Инструменты для сериализации-десериализации

При выборе между бинарной и SOAP-сериализацией следует учесть, что бинарный вид сериализации более производительный и результирующие строки получаются короче.

ICSSoft.STORMNET.Tools.ToolXML

ICSSoft.STORMNET.Tools.ToolXML - инструмент для сериализации-десериализации в XML.
Данный класс реализует два варианта преобразований в XML:
  • SOAP сериализация с помощью стандартного System.Runtime.Serialization.Formatters.Soap.SoapFormatter,
  • специально реализованная конвертация объекта данных к XmlDocument, применима только для ICSSoft.STORMNET.DataObject (информация о применении данного варианта доступна в статье).

В классе реализованы следующие методы:

МетодОписание
XMLDocument2DataObject Назначение: Получение объекта данных из ранее полученного XML документа. Данный метод написан специально для DataObject
Параметры:
dataObject - Объект данных, в который будем десериализовывать
xmlDoc - Сериализованный объект данных
Сигнатура:
 public static void XMLDocument2DataObject(ref ICSSoft.STORMNET.DataObject dataObject, XmlDocument xmlDoc) 
DataObject2XMLDocument Назначение: Получение XML документа из объекта данных. Данный вид сериализации написан специально для DataObject и основан на переборе свойств, детейлов и ссылок на мастеров с последующим занесением всего этого в XMLDocument.
Параметры:
dataObject - Сам объект данных
serializeAggregators - Следует ли сериализовать детейлы
setObjectLoadingStateLoaded - Установить LoadingState объекта в Loaded
setObjectStatusCreated - Установить ObjectStatus объекта в Created
serializeMasters - Проводить полную сериализацию мастеров объектов
Возвращаемый результат: Сериализованное представление объекта
Сигнатура:
 public static XmlDocument DataObject2XMLDocument(ref ICSSoft.STORMNET.DataObject dataObject) 

 public static XmlDocument DataObject2XMLDocument(ref ICSSoft.STORMNET.DataObject dataObject, bool serializeAggregators) 

 public static XmlDocument DataObject2XMLDocument(ref ICSSoft.STORMNET.DataObject dataObject, bool serializeAggregators, bool setObjectLoadingStateLoaded, bool setObjectStatusCreated) 

 public static XmlDocument DataObject2XMLDocument(
            ref ICSSoft.STORMNET.DataObject dataObject, 
            bool serializeAggregators,
            bool setObjectLoadingStateLoaded, 
            bool setObjectStatusCreated, 
            bool serializeMasters) 
ObjectToString Назначение: Сериализация объекта при помощи SoapFormatter.
Параметры:
o - Объект для сериализации
Возвращаемый результат: Сериализованный объект
Сигнатура:
 public static string ObjectToString(object o) 
ObjectFromString Назначение: Десериализация объекта при помощи SoapFormatter.
Параметры:
s - Сериализованный объект
Возвращаемый результат: Востановленный объект
Сигнатура:
 public static object ObjectFromString(string s) 

ICSSoft.STORMNET.Tools.ToolBinarySerializer

ICSSoft.STORMNET.Tools.ToolBinarySerializer - инструмент для бинарной сериализации-десериализации.
Сериализованные байты конвертируются в ToBase64String. Реализация основана на примененииSystem.Runtime.Serialization.Formatters.Binary.BinaryFormatter.
В классе реализованы следующие методы:

МетодОписание
ObjectToString Назначение: Сериализация объекта при помощи BinaryFormatter.
Параметры:
o - Объект
Возвращаемый результат: Строка.
Сигнатура:
 public static string ObjectToString(object o) 
ObjectFromString Назначение: Десериализация объекта при помощи BinaryFormatter.
Параметры:
s - Сериализованный объект
binder - Binder, который необходимо указать, если при десереализации необходимо реализовать собственную логику по поиску типов.
Возвращаемый результат: Востановленный объект.
Сигнатура:
 public static object ObjectFromString(string s) 

 public static object ObjectFromString(string s, SerializationBinder binder) 



ICSSoft.STORMNET.Tools.XmlTools

ICSSoft.STORMNET.Tools.XmlTools - класс для работы с XML.
В классе реализованы следующие методы:

МетодОписание
GetXDocumentByXElement Назначение: Конвертация System.Xml.Linq.XElement в System.Xml.XmlDocument.
Параметры:
xElement - xElement для конвертации.
versionXmlDoc - Версия создаваемого xml документа.
encodingXmlDoc - Кодировка для создаваемого xml документа.
Возвращаемый результат: Результат конвертации - XmlDocument.
Сигнатура:
 public static XmlDocument GetXDocumentByXElement(XElement xElement, string versionXmlDoc, string encodingXmlDoc) 
LoadXml Назначение: Прочитать Xml-файл. Может автоматически определить кодировку на основании кодировки, использующейся внутри Xml.
Параметры:
filePath - Путь до Xml-файла.
encoding - Кодировка, которую необходимо использовать для чтения Xml-файла.
Сигнатура:
 public static XmlDocument LoadXml(string filePath, Encoding encoding = null) 

Откуда ссылаются на эту страницу


Куда ссылается эта страница



На этой странице ещё нет сообщений. Ваше будет первым!

ScrewTurn Wiki version 3.0.5.600. Some of the icons created by FamFamFam.