CardSerializableEntryCollectionT - класс

Коллекция, содержащая сериализуемые в бинарную форму и в XML объекты, для которых определён способ доступа по имени и по идентификатору.

Definition

Пространство имён: Tessa.Cards
Сборка: Tessa (в Tessa.dll) Версия: 4.0.4
C#
public abstract class CardSerializableEntryCollection<T> : CardSchemeSerializableObject, 
	IList<T>, ICollection<T>, IEnumerable<T>, IEnumerable, IList, 
	ICollection, IReadOnlyList<T>, IReadOnlyCollection<T>
where T : new(), CardSerializableObject, ICardSerializableEntry
Inheritance
Object    ValidationObject    CardSerializableObject    CardSchemeSerializableObject    CardSerializableEntryCollectionT
Derived
Подробнее
Implements
ICollectionT, IEnumerableT, IListT, IReadOnlyCollectionT, IReadOnlyListT, ICollection, IEnumerable, IList

Параметры типа

T

Ссылочный тип элементов коллекции, унаследованный от CardSerializableObject, дополнительно реализующий интерфейс ICardSerializableEntry и содержащий конструктор по умолчанию.

Для такого объекта также должен быть переопределён метод сравнения Equals(Object) таким образом, чтобы он сравнивал объекты по равенству идентификаторов.

Заметки

В качестве элементов коллекции удобно использовать наследников класса CardSerializableEntry.

Конструкторы

CardSerializableEntryCollectionTСоздаёт экземпляр класса с параметрами по умолчанию.
CardSerializableEntryCollectionT(IEnumerableT)Создаёт экземпляр класса с указанием коллекции элементов.
CardSerializableEntryCollectionT(Int32)Создаёт экземпляр класса с указанием начальной вместимости списка.

Свойства

CountКоличество элементов в коллекции.
IsReadOnly

Признак доступности коллекции только для чтения.

Свойство возвращает значение свойства [Tessa.Platform.ISealable.IsSealed].

IsSealed Признак того, что объект был защищён от изменений.
(Унаследован от CardSerializableObject)
ItemGuid Возвращает элемент коллекции по его идентификатору.
ItemInt32 Возвращает элемент коллекции по его индексу в списке.
ItemString Возвращает элемент коллекции по его имени.
Reference Имя глобального объекта, на который ссылается данный объект.
(Унаследован от CardSerializableObject)
XmlElementNameInternal Имя XML-элемента, для которого выполняется сериализация и десериализация.
(Унаследован от CardSerializableObject)
XmlItemNameInternalИмя входящих в коллекцию XML-элементов, для которых выполняется сериализация и десериализация.

Методы

AddДобавляет заданный элемент в коллекцию.
CheckSealed Выбрасывает исключение если объект был защищён от изменений.
(Унаследован от CardSerializableObject)
ClearУдаляет все элементы коллекции.
Contains(T)Возвращает признак того, что заданный элемент содержится в коллекции.
Contains(Guid) Возвращает признак того, что элемент с заданным идентификатором присутствует в коллекции.
Contains(String) Возвращает признак того, что элемент с заданным именем присутствует в коллекции.
CopyToКопирует элементы коллекции в массив, начиная с заданного отсчитываемого от нуля индекса.
CreateAndEnsureSealingT Создаёт объект типа T посредством конструктора по умолчанию и защищает его от изменений, если текущий объект также защищён от изменений.
(Унаследован от CardSerializableObject)
DeserializeAsyncАсинхронно выполняет десериализацию полей объекта из заданного хранилища.
(Унаследован от CardSerializableObject)
DeserializeAttributeFromXmlAsync Выполняется для каждого атрибута десериализуемого атрибута.
(Унаследован от CardSerializableObject)
DeserializeElementFromXmlAsync Выполняется для каждого элемента десериализуемого объекта.
(Переопределяет CardSerializableObjectDeserializeElementFromXmlAsync(String, XmlReader, CancellationToken))
DeserializeFromJsonAsync(String, CancellationToken) Десериализует объект и его дочерние объекты из заданного текстового JSON с сохраняемыми типами данных.
(Унаследован от CardSerializableObject)
DeserializeFromStorageAsync(DictionaryString, Object, CancellationToken) Десериализует объект и его дочерние объекты из заданного хранилища Dictionary<string, object?>.
(Унаследован от CardSerializableObject)
DeserializeFromStorageInternalAsync Выполняет десериализацию объекта и всех его дочерних объектов из хранилища Dictionary<string, object?>.
(Переопределяет CardSerializableObjectDeserializeFromStorageInternalAsync(ICardSerializableContext, DictionaryString, Object))
DeserializeFromXmlAsync(Stream, CancellationToken) Выполняет десериализацию объекта из XML из заданного потока.
(Унаследован от CardSerializableObject)
DeserializeFromXmlAsync(String, CancellationToken) Выполняет десериализацию объекта из XML, заданного посредством строки.
(Унаследован от CardSerializableObject)
DeserializeFromXmlAsync(XmlReader, CancellationToken) Выполняет десериализацию объекта и всех его дочерних объектов из элемента XML.
(Унаследован от CardSerializableObject)
EqualsDetermines whether the specified object is equal to the current object.
(Унаследован от Object)
FinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
(Унаследован от Object)
GetEnumeratorВозвращает итератор по элементам коллекции.
GetHashCodeServes as the default hash function.
(Унаследован от Object)
GetTypeGets the Type of the current instance.
(Унаследован от Object)
GetValidationName Возвращает строку, определяющую имя объекта, или null, если имя объекта ещё неизвестно или объект не содержит имени.
(Унаследован от ValidationObject)
IndexOfВозвращает отсчитываемый от нуля индекс заданного элемента в коллекции.
InsertВставляет элемент в заданную позицию.
IsValidВыполняет проверку объекта на валидность и возвращает признак того, что объект является валидным.
(Унаследован от ValidationObject)
MemberwiseCloneCreates a shallow copy of the current Object.
(Унаследован от Object)
OnDeserializedAsync Выполняется после успешной десериализации объекта и всех его дочерних объектов из элемента XML.
(Унаследован от CardSerializableObject)
OnDeserializingAsync Выполняется перед десериализацией объекта и всех его дочерних объектов из элемента XML.
(Переопределяет CardSerializableObjectOnDeserializingAsync(ICardSerializableContext))
OnItemAttributeSerializationToXml

Происходит перед сериализацией элементов коллекции в XML-элемент.

При переопределении метода в него можно добавить логику по дополнению XML-элемента атрибутами, которые не были добавлены методом сериализации самого элемента коллекции, но которые обрабатываются при десериализации XML-элемента.

PrepareForCopyAsync Подготавливает объект перед копированием в буффер обмена.
(Унаследован от CardSerializableObject)
PrepareForPasteAsync Подготавливает объект после чтения из буффера обмена.
(Унаследован от CardSerializableObject)
Remove(T)Удаляет заданный элемент из коллекции.
Remove(Guid) Удаляет элемент с заданным идентификатором из коллекции.
Remove(String) Удаляет элемент с заданным именем из коллекции.
RemoveAtУдаляет элемент в заданной позиции.
RepairAsync(ICardSchemeInfoProvider, CancellationToken) Метод восстанавливает объект к работоспособному состоянии в соответствии со схемой. Этот процесс включает удаление данных из текущего объекта, которые имеют отношение к схеме, но фактически в ней отсутствуют.
(Унаследован от CardSchemeSerializableObject)
RepairAsync(ICardSchemeInfoProvider, IValidationResultBuilder, CancellationToken) Метод восстанавливает объект к работоспособному состоянии в соответствии со схемой. Этот процесс включает удаление данных из текущего объекта, которые имеют отношение к схеме, но фактически в ней отсутствуют.
(Унаследован от CardSchemeSerializableObject)
RepairInternalAsync Метод восстанавливает объект к работоспособному состоянии в соответствии со схемой. Этот процесс включает удаление данных из текущего объекта, которые имеют отношение к схеме, но фактически в ней отсутствуют.
(Переопределяет CardSchemeSerializableObjectRepairInternalAsync(ICardSchemeInfoProvider, IValidationResultBuilder, CancellationToken))
Seal Защищает объект от изменений.
(Унаследован от CardSerializableObject)
SealInternal Защищает объект от изменений. Метод может быть переопределён в классах-наследниках.
(Переопределяет CardSerializableObjectSealInternal)
SerializeAsyncАсинхронно выполняет сериализацию полей объекта в заданное хранилище.
(Унаследован от CardSerializableObject)
SerializeToJsonAsync Сериализует объект и его дочерние объекты в форме текстового JSON с сохраняемыми типами данных.
(Унаследован от CardSerializableObject)
SerializeToStorageAsync(CancellationToken) Сериализует объект и его дочерние объекты в возвращаемое хранилище Dictionary<string, object?>.
(Унаследован от CardSerializableObject)
SerializeToStorageAsync(DictionaryString, Object, CancellationToken) Сериализует объект и его дочерние объекты в заданное хранилище Dictionary<string, object?>.
(Унаследован от CardSerializableObject)
SerializeToStorageInternalAsync Выполняет сериализацию текущего объекта и всех его дочерних объектов в хранилище Dictionary<string, object?>.
(Переопределяет CardSerializableObjectSerializeToStorageInternalAsync(ICardSerializableContext, DictionaryString, Object))
ToStringReturns a string that represents the current object.
(Унаследован от Object)
TryGetValue(Guid, T) Пытается вернуть элемент коллекции по его идентификатору.
TryGetValue(String, T) Пытается вернуть элемент коллекции по его имени.
Validate Выполняет валидацию объекта и всех его дочерних объектов.
(Унаследован от ValidationObject)
Validate(IValidationResultBuilder)Выполняет валидацию текущего объекта и всех его дочерних объектов.
(Унаследован от ValidationObject)
ValidateInternalВыполняет валидацию текущего объекта и всех его дочерних объектов.
(Переопределяет ValidationObjectValidateInternal(IValidationResultBuilder))

Методы расширения

AddRangeT Добавляет значения items в коллекцию collection.
(Определяется CollectionsExtensions)
AddRangeT Добавляет значения items в коллекцию collection.
(Определяется CollectionsExtensions)
AddRangeForList Добавляет значения items в коллекцию collection.
(Определяется CollectionsExtensions)
AllOrNullT Определяет отвечают ли все элементы последовательности переданному предикату.
(Определяется PlatformExtensions)
AsArrayT Преобразует коллекцию в массив. В случае, если коллекция не является массивом, к ней применяется ToArrayTSource(IEnumerableTSource).
(Определяется CollectionsExtensions)
ConvertToListDictionariesT Осуществляет сопоставлению коллекции source на коллекцию коллекций ключ-значение в соответствии с контекстом сопоставления по умолчанию
(Определяется DictionaryConverter)
ConvertToListDictionariesT Осуществляет сопоставлению коллекции source на коллекцию коллекций ключ-значение в соответствии с контекстом сопоставления context
(Определяется DictionaryConverter)
CopyAndAddRangeAsyncT Копирует коллекцию сериализуемых объектов sourceItems и в конец коллекции сериализуемых объектов targetItems. Устанавливает порядок следования объектов, если объекты поддерживают ICardMetadataOrderable.
(Определяется CardExtensions)
CopyAndInsertAsyncT Копирует коллекцию сериализуемых объектов sourceItems и вставляет по индексу в коллекцию сериализуемых объектов targetItems. Устанавливает порядок следования объектов, если объекты поддерживают ICardMetadataOrderable.
(Определяется CardExtensions)
CopyToTheBeginningOfAsyncT Копирует коллекцию сериализуемых объектов sourceItems в начало коллекции сериализуемых объектов targetItems. Устанавливает порядок следования объектов, если объекты поддерживают ICardMetadataOrderable.
(Определяется CardExtensions)
ForEachT Выполняет указанное действие с каждым элементом коллекции IEnumerableT.
(Определяется CollectionsExtensions)
FullOuterJoinT, TInner, TKey, TResult Объединяет две последовательности по алгоритму FULL OUTER JOIN.
(Определяется CollectionsExtensions)
Get
(Определяется ComHelper)
IndexOfT Возвращает индекс первого вхождения элемента в последовательность, определяемый посредством заданного выражения.
(Определяется CollectionsExtensions)
IndexOfT Возвращает индекс первого вхождения элемента в последовательность, определяемый посредством заданного компаратора IEqualityComparerT.
(Определяется CollectionsExtensions)
IndexOfT Выполняет поиск элемента, удовлетворяющего условиям указанного предиката, и возвращает отсчитываемый от нуля индекс первого вхождения в диапазоне элементов списка, начиная с заданного индекса и заканчивая последним элементом.
(Определяется CollectionsExtensions)
IndexOfT Выполняет поиск элемента, удовлетворяющего условиям указанного предиката, и возвращает отсчитываемый от нуля индекс первого вхождения в диапазоне элементов списка, начинающемся с заданного индекса и содержащем указанное число элементов.
(Определяется CollectionsExtensions)
InsertNonOrderableAsyncT Копирует коллекцию сериализуемых объектов sourceItems и вставляет по индексу в коллекцию сериализуемых объектов targetItems.
(Определяется CardExtensions)
InsertRangeT Вставляет диапазон элементов в заданный список items, начиная с указанного индекса index.
(Определяется CollectionsExtensions)
InsertRangeForList Вставляет диапазон элементов в заданный список items, начиная с указанного индекса index.
(Определяется CollectionsExtensions)
Invoke
(Определяется ComHelper)
LastIndexOfT Возвращает индекс последнего вхождения элемента в последовательность, определяемый посредством заданного выражения.
(Определяется CollectionsExtensions)
LastIndexOfT Возвращает индекс последнего вхождения элемента в последовательность, определяемый посредством заданного компаратора IEqualityComparerT.
(Определяется CollectionsExtensions)
OrderByAttributeAndTypeT

Сортирует элементы с учётом атрибута OrderAttribute на типах объектов.

Если атрибут отсутствует или элемент равен null - подразумевается 0. Если несколько зависимостей имеют одинаковый порядок, то они сортируются по краткому имени типа элемента (без пространства имён), а при его совпадении - по квалифицированному имени типа (с учётом пространства имён и названия сборки).


(Определяется PlatformExtensions)
OrderByDbmsBaseT Метод для сортировки списка в порядке по возрастанию с учётом особенностей СУБД.
(Определяется DataExtensions)
OrderByDependenciesT
(Определяется CollectionsExtensions)
OrderByDependenciesT
(Определяется CollectionsExtensions)
OrderByDependenciesT, TKey
(Определяется CollectionsExtensions)
OrderByDependenciesT, TKey
(Определяется CollectionsExtensions)
OrderByDescendingDbmsBaseT Метод для сортировки списка в порядке по убыванию с учётом особенностей СУБД.
(Определяется DataExtensions)
OrderByLocalizedT Сортирует значения последовательности по возрастанию по локализованному ключу, который определяется для каждого элемента.
(Определяется PlatformExtensions)
OrderByLocalizedDescendingT Сортирует значения последовательности по убыванию по локализованному ключу, который определяется для каждого элемента.
(Определяется PlatformExtensions)
RemoveAllT Удаляет все элементы, совпадающие по заданному предикату. Возвращает количество удалённых элементов.
(Определяется CollectionsExtensions)
RemoveAllForList Удаляет все элементы, совпадающие по заданному предикату. Возвращает количество удалённых элементов.
(Определяется CollectionsExtensions)
RemoveRangeT Удаляет значения items из коллекции collection.
(Определяется CollectionsExtensions)
RemoveRangeT Удаляет значения items из коллекции collection.
(Определяется CollectionsExtensions)
RunWithMaxDegreeOfParallelismAsyncT Выполняет асинхронную обработку элементов с ограничением на максимальное количество параллельных задач.
(Определяется PlatformExtensions)
Set
(Определяется ComHelper)
ToDictionaryAsyncT, TKey, TElement Создает словарь DictionaryTKey, TValue из объекта IEnumerableT в соответствии с заданными функциями синхронного селектора ключа и асинхронного селектора значения.
(Определяется PlatformExtensions)
ToObservableCollectionT Преобразует коллекцию IEnumerable в ObservableCollection
(Определяется CollectionsExtensions)
ToSealableListT Возвращает список объектов, поддерживающий защиту от изменений. Каждый из объектов T в списке либо не реализует интерфейс ISealable, либо защита от изменений таких объектов не активируется вместе со списком.
(Определяется CollectionsExtensions)
ToSealableObjectListT Возвращает список объектов, поддерживающий защиту от изменений. Каждый из объектов T в списке реализует интерфейс ISealable и защищается от изменений при активации защиты в списке.
(Определяется CollectionsExtensions)
TryFirstT Возвращает первый элемент последовательности, удовлетворяющий условию.
(Определяется CollectionsExtensions)
TrySingleOrDefaultT Возвращает единственный конкретный элемент коллекции или значение по умолчанию для типа, если этот элемент не найден.
(Определяется CollectionsExtensions)
WithPreviousAndNextT
(Определяется EnumerableExtensions)

См. также