StorageExtensions - класс

Методы-расширения для пространства имён Tessa.Platform.Storage.

Definition

Пространство имён: Tessa.Platform.Storage
Сборка: Tessa (в Tessa.dll) Версия: 4.1.3+7e2b1422f9b8c7c41fbbc4b151a843bed05319ab
C#
public static class StorageExtensions
Inheritance
Object    StorageExtensions

Методы

ConvertEnumT Возвращает значение перечисления Enum или defaultValue из указанного хранилища по ключу. Выполняет преобразование типов при необходимости. Преобразование из строк выполняется без учёта регистра.
DeepCloneT Выполняет глубокое клонирование сериализуемого объекта за счёт его полной сериализации / десериализации.
DeepCloneAsyncT Выполняет глубокое клонирование сериализуемого объекта за счёт его полной сериализации / десериализации.
DeserializeWithStorageSupportAsync Десериализует объект указанного типа type с поддержкой типов данных, сериализуемых как хранилище, в т.ч.: IStorageDictionaryProvider, IStorageListProvider, IStorageSerializableIAsyncStorageSerializable, коллекция объектов IStorageSerializable и коллекция объектов IAsyncStorageSerializable. Выполняет стандартную десериализацию для других типов объектов.
FromDictionaryT Устанавливает данные объекта, используя переданную коллекцию пар ключ / значение в качестве хранилища, и возвращает этот объект.
FromJsonT Устанавливает данные объекта, десериализованные из текстового представления Json, и возвращает этот объект.
FromJsonStringT Десериализует объект из JSON-строки с учетом сериализации типов, используя конвертер TypedJsonConverter.
FromSerializedDictionaryT Десериализует объект, для которого не указан тип (класс), из хранилища Dictionary<string, object?>.
FromTypedDictionaryT Десериализует объект, для которого указан тип (класс), из хранилища Dictionary<string, object?>.
GetT Возвращает значение из хранилища IDictionary<string, object>, полученное по ключу key и приведённое к типу T.
GetOrAddTGet, TDefault Возвращает либо значение из хранилища IDictionary<string, object>, полученное по ключу key и приведённое к типу TGet при его наличии, либо возвращает значение, созданное вызовом конструктора по умолчанию для типа TDefault, если запрошенное значение отсутствовало в хранилище, и устанавливает его в storage.
GetSerializedListT Извлекает список нетипизированных объектов из хранилища.
GetSerializedObjectT Извлекает нетипизированный объект из хранилища.
GetTypedListT Извлекает из хранилища список типизированных объектов.
GetTypedObjectT Извлекает из словаря объект, сериализованный с сохранением типа.
GetTypedObjectDictionaryT Десериализует сложный типизированный словарь [string, T].
MergeFromT Копирует данные из коллекции ключ / значение в сериализуемый объект, выполняя слияние с перезаписью уже существующих в текущем объекте данных.
MergeTo Копирует данные из сериализуемого объекта в коллекцию ключ / значение, выполняя слияние с перезаписью уже существующих в заданном объекте данных.
RegisterStorageAPI 
RemoveIfDefault(IDictionaryString, Object, String, Boolean) Удаляет значение в хранилище по указанному ключу, если оно равно значению по умолчанию defaultValue.
RemoveIfDefault(IDictionaryString, Object, String, DateTime) Удаляет значение в хранилище по указанному ключу, если оно равно значению по умолчанию defaultValue.
RemoveIfDefault(IDictionaryString, Object, String, DateTimeOffset) Удаляет значение в хранилище по указанному ключу, если оно равно значению по умолчанию defaultValue.
RemoveIfDefault(IDictionaryString, Object, String, Decimal) Удаляет значение в хранилище по указанному ключу, если оно равно значению по умолчанию defaultValue.
RemoveIfDefault(IDictionaryString, Object, String, Double) Удаляет значение в хранилище по указанному ключу, если оно равно значению по умолчанию defaultValue.
RemoveIfDefault(IDictionaryString, Object, String, Guid) Удаляет значение в хранилище по указанному ключу, если оно равно значению по умолчанию defaultValue.
RemoveIfDefault(IDictionaryString, Object, String, Int32) Удаляет значение в хранилище по указанному ключу, если оно равно значению по умолчанию defaultValue.
RemoveIfDefault(IDictionaryString, Object, String, Int64) Удаляет значение в хранилище по указанному ключу, если оно равно значению по умолчанию defaultValue.
RemoveIfDefault(IDictionaryString, Object, String, String) Удаляет значение в хранилище по указанному ключу, если оно равно значению по умолчанию defaultValue.
RemoveIfDefault(IDictionaryString, Object, String, TimeSpan) Удаляет значение в хранилище по указанному ключу, если оно равно значению по умолчанию defaultValue.
RemoveIfDefaultEnumT Удаляет значение перечисления в хранилище по указанному ключу, если оно равно значению по умолчанию defaultValue.
RemoveIfDefaultObject Удаляет значение в хранилище по указанному ключу, если оно равно значению по умолчанию defaultValue.
RemoveIfEmptyCollection Удаляет значение в хранилище по указанному ключу, если оно равно null или является пустой коллекцией (в т.ч. пустым DictionaryTKey, TValue).
RemoveIfEmptyString Удаляет значение в хранилище по указанному ключу, если оно равно null или пустой строке.
RemoveIfNull Удаляет значение в хранилище по указанному ключу, если оно равно null.
RemoveIfWhiteSpaceString Удаляет значение в хранилище по указанному ключу, если оно равно null, пустой строке или строке, состоящей из пробелов.
SetFlagsTFlags Устанавливает значение флагового перечисления в хранилище по указанному ключу.
SetFlagsIfNotDefaultTFlags Устанавливает значение флагового перечисления в хранилище по указанному ключу, если value не равно значению по умолчанию defaultValue.
SetIfNotDefault(IDictionaryString, Object, String, Boolean, Boolean) Устанавливает значение в хранилище по указанному ключу, если value не равно значению по умолчанию defaultValue.
SetIfNotDefault(IDictionaryString, Object, String, DateTime, DateTime) Устанавливает значение в хранилище по указанному ключу, если value не равно значению по умолчанию defaultValue.
SetIfNotDefault(IDictionaryString, Object, String, Double, Double) Устанавливает значение в хранилище по указанному ключу, если value не равно значению по умолчанию defaultValue.
SetIfNotDefault(IDictionaryString, Object, String, Guid, Guid) Устанавливает значение в хранилище по указанному ключу, если value не равно значению по умолчанию defaultValue.
SetIfNotDefault(IDictionaryString, Object, String, Int16, Int16) Устанавливает значение в хранилище по указанному ключу, если value не равно значению по умолчанию defaultValue.
SetIfNotDefault(IDictionaryString, Object, String, Int32, Int32) Устанавливает значение в хранилище по указанному ключу, если value не равно значению по умолчанию defaultValue.
SetIfNotDefault(IDictionaryString, Object, String, Int64, Int64) Устанавливает значение в хранилище по указанному ключу, если value не равно значению по умолчанию defaultValue.
SetIfNotDefault(IDictionaryString, Object, String, NullableBoolean, NullableBoolean) Устанавливает значение в хранилище по указанному ключу, если value не равно значению по умолчанию defaultValue.
SetIfNotDefault(IDictionaryString, Object, String, NullableDateTime, NullableDateTime) Устанавливает значение в хранилище по указанному ключу, если value не равно значению по умолчанию defaultValue.
SetIfNotDefault(IDictionaryString, Object, String, NullableDouble, NullableDouble) Устанавливает значение в хранилище по указанному ключу, если value не равно значению по умолчанию defaultValue.
SetIfNotDefault(IDictionaryString, Object, String, NullableGuid, NullableGuid) Устанавливает значение в хранилище по указанному ключу, если value не равно значению по умолчанию defaultValue.
SetIfNotDefault(IDictionaryString, Object, String, NullableInt16, NullableInt16) Устанавливает значение в хранилище по указанному ключу, если value не равно значению по умолчанию defaultValue.
SetIfNotDefault(IDictionaryString, Object, String, NullableInt32, NullableInt32) Устанавливает значение в хранилище по указанному ключу, если value не равно значению по умолчанию defaultValue.
SetIfNotDefault(IDictionaryString, Object, String, NullableInt64, NullableInt64) Устанавливает значение в хранилище по указанному ключу, если value не равно значению по умолчанию defaultValue.
SetIfNotDefault(IDictionaryString, Object, String, String, String) Устанавливает значение в хранилище по указанному ключу, если value не равно значению по умолчанию defaultValue.
SetIfNotDefaultT(IDictionaryString, Object, String, T, T) Устанавливает значение в хранилище по указанному ключу, если value не равно значению по умолчанию defaultValue.
SetIfNotDefaultAsString(IDictionaryString, Object, String, Guid, Guid) Устанавливает значение в хранилище по указанному ключу в виде строки, если value не равно значению по умолчанию defaultValue.
SetIfNotDefaultAsString(IDictionaryString, Object, String, NullableGuid, NullableGuid) Устанавливает значение в хранилище по указанному ключу в виде строки, если value не равно значению по умолчанию defaultValue.
SetIfNotEmpty(IDictionaryString, Object, String, String) Устанавливает значение в хранилище по указанному ключу, если value не равно null или пустой строке.
SetIfNotEmptyT(IDictionaryString, Object, String, IReadOnlyCollectionT) Устанавливает значение в хранилище по указанному ключу, если value не является пустой коллекцией или null.
SetIfNotNull Устанавливает значение в хранилище по указанному ключу, если value не равно null.
SetIfNotWhiteSpace Устанавливает значение в хранилище по указанному ключу, если value не равно null, пустой строке или строке из пробелов.
ToDynamicT Возвращает объект, осуществляющий доступ к хранилищу IDictionary<string, object> через позднее связывание.
ToJsonStringT Сохраняет объект в JSON-строку с учетом индентации и сериализации типов, используя конвертер TypedJsonConverter.
ToListStorageT Преобразует элементы items в объект ListStorageT, содержащий список объектов Object, определяемый фабрикой factory.
ToSerializedDictionary Сериализует объект, для которого не указывается тип (класс), в хранилище Dictionary<string, object?>.
ToSerializedListT Сериализует список объектов в список хэш-таблиц, каждая из которых является хранилищем объекта в списке без указания типа объекта (класса). Возвращаемое значение null аналогично пустому списку.
ToTypedDictionaryT Сериализует объект в типизированное хранилище.
ToTypedListT Сериализует список объектов в список типизированных хранилищ.
ToTypedObjectDictionaryT Сериализует хэш-таблицу с объектами, реализующими ITypedSerializable, в хэш-таблицу, где по ключу расположено хранилище соответствующего объекта, полученное вызовом ToTypedDictionaryT(T), т.е. оно является хэш-таблицей Dictionary<string, object?> с указанием типа (класса). Значение null аналогично пустой хэш-таблице.
TryConvertBoolean Возвращает значение Boolean или null из указанного хранилища по ключу. Выполняет преобразование типов при необходимости.
TryConvertBooleanEnumerable Возвращает перечисление значений Boolean или null, если список отсутствует по ключу. Если список присутствует, то каждое значение должно быть не равно null и успешно конвертироваться в Boolean.
TryConvertByte Возвращает значение Byte или null из указанного хранилища по ключу. Выполняет преобразование типов при необходимости.
TryConvertBytes Возвращает значение byte[] или null из указанного хранилища по ключу. Выполняет преобразование типов при необходимости.
TryConvertDateTime Возвращает значение DateTime с типом UTC или null из указанного хранилища по ключу. Выполняет преобразование типов при необходимости.
TryConvertDateTimeOffset Возвращает значение DateTimeOffset или null из указанного хранилища по ключу. Выполняет преобразование типов при необходимости.
TryConvertDecimal Возвращает значение Decimal или null из указанного хранилища по ключу. Выполняет преобразование типов при необходимости.
TryConvertDecimalEnumerable Возвращает перечисление значений Decimal или null, если список отсутствует по ключу. Если список присутствует, то каждое значение должно быть не равно null и успешно конвертироваться в Double.
TryConvertDouble Возвращает значение Double или null из указанного хранилища по ключу. Выполняет преобразование типов при необходимости.
TryConvertDoubleEnumerable Возвращает перечисление значений Double или null, если список отсутствует по ключу. Если список присутствует, то каждое значение должно быть не равно null и успешно конвертироваться в Double.
TryConvertEnumT Возвращает значение перечисления Enum или null из указанного хранилища по ключу. Выполняет преобразование типов при необходимости. Преобразование из строк выполняется без учёта регистра.
TryConvertFlagsTFlags Возвращает значение флагового перечисления TFlags из указанного хранилища по ключу или null, если ключ не найден.
TryConvertGuid Возвращает значение Guid или null из указанного хранилища по ключу. Выполняет преобразование типов при необходимости.
TryConvertGuidEnumerable Возвращает перечисление значений Guid или null, если список отсутствует по ключу. Если список присутствует, то каждое значение должно быть не равно null и успешно конвертироваться в Guid.
TryConvertInt32 Возвращает значение Int32 или null из указанного хранилища по ключу. Выполняет преобразование типов при необходимости.
TryConvertInt32Enumerable Возвращает перечисление значений Int32 или null, если список отсутствует по ключу. Если список присутствует, то каждое значение должно быть не равно null и успешно конвертироваться в Int32.
TryConvertInt64 Возвращает значение Int64 или null из указанного хранилища по ключу. Выполняет преобразование типов при необходимости.
TryConvertInt64Enumerable Возвращает перечисление значений Int64 или null, если список отсутствует по ключу. Если список присутствует, то каждое значение должно быть не равно null и успешно конвертироваться в Int64.
TryConvertTimeSpan Возвращает значение TimeSpan или null из указанного хранилища по ключу. Выполняет преобразование типов при необходимости.
TryGetT

Возвращает либо значение из хранилища IDictionary<string, object>, полученное по ключу key и приведённое к типу T при его наличии, либо возвращает значение по умолчанию defaultValue, если запрошенное значение отсутствовало в хранилище.

Внимание! Если требуется получить значение, которое может присутствовать со значением null, но тип данных не допускает null, например, для типа int, то пишите следующим образом: storage.TryGet<int?>("key") ?? 0

TryGetValueT Возвращает признак наличия значения в хранилище IDictionary<string, object>, полученное по ключу key и само значение и приведённое к типу T при его наличии.
Внимание! Если требуется получить значение, которое может присутствовать со значением null, но тип данных не допускает null, например, для типа int, то пишите следующим образом: storage.TryGet<int?>("key") ?? 0

См. также