CardSerializableEntryCollection<T> - класс

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

Definition

Пространство имён: Tessa.Cards
Сборка: Tessa (в Tessa.dll) Версия: 4.0.6
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    CardSerializableEntryCollection<T>
Derived
Подробнее
Implements
ICollection<T>, IEnumerable<T>, IList<T>, IReadOnlyCollection<T>, IReadOnlyList<T>, ICollection, IEnumerable, IList

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

T

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

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

Заметки

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

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

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

Свойства

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

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

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

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

Методы

AddДобавляет заданный элемент в коллекцию.
CheckSealed Выбрасывает исключение если объект был защищён от изменений.
(Унаследован от CardSerializableObject)
ClearУдаляет все элементы коллекции.
Contains(T)Возвращает признак того, что заданный элемент содержится в коллекции.
Contains(Guid) Возвращает признак того, что элемент с заданным идентификатором присутствует в коллекции.
Contains(String) Возвращает признак того, что элемент с заданным именем присутствует в коллекции.
CopyToКопирует элементы коллекции в массив, начиная с заданного отсчитываемого от нуля индекса.
CreateAndEnsureSealing<T> Создаёт объект типа T посредством конструктора по умолчанию и защищает его от изменений, если текущий объект также защищён от изменений.
(Унаследован от CardSerializableObject)
DeserializeAsyncАсинхронно выполняет десериализацию полей объекта из заданного хранилища.
(Унаследован от CardSerializableObject)
DeserializeAttributeFromXmlAsync Выполняется для каждого атрибута десериализуемого атрибута.
(Унаследован от CardSerializableObject)
DeserializeElementFromXmlAsync Выполняется для каждого элемента десериализуемого объекта.
(Переопределяет CardSerializableObject.DeserializeElementFromXmlAsync(String, XmlReader, CancellationToken))
DeserializeFromJsonAsync(String, CancellationToken) Десериализует объект и его дочерние объекты из заданного текстового JSON с сохраняемыми типами данных.
(Унаследован от CardSerializableObject)
DeserializeFromStorageAsync(Dictionary<String, Object>, CancellationToken) Десериализует объект и его дочерние объекты из заданного хранилища Dictionary<string, object?>.
(Унаследован от CardSerializableObject)
DeserializeFromStorageInternalAsync Выполняет десериализацию объекта и всех его дочерних объектов из хранилища Dictionary<string, object?>.
(Переопределяет CardSerializableObject.DeserializeFromStorageInternalAsync(ICardSerializableContext, Dictionary<String, 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.
(Переопределяет CardSerializableObject.OnDeserializingAsync(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 Метод восстанавливает объект к работоспособному состоянии в соответствии со схемой. Этот процесс включает удаление данных из текущего объекта, которые имеют отношение к схеме, но фактически в ней отсутствуют.
(Переопределяет CardSchemeSerializableObject.RepairInternalAsync(ICardSchemeInfoProvider, IValidationResultBuilder, CancellationToken))
Seal Защищает объект от изменений.
(Унаследован от CardSerializableObject)
SealInternal Защищает объект от изменений. Метод может быть переопределён в классах-наследниках.
(Переопределяет CardSerializableObject.SealInternal())
SerializeAsyncАсинхронно выполняет сериализацию полей объекта в заданное хранилище.
(Унаследован от CardSerializableObject)
SerializeToJsonAsync Сериализует объект и его дочерние объекты в форме текстового JSON с сохраняемыми типами данных.
(Унаследован от CardSerializableObject)
SerializeToStorageAsync(CancellationToken) Сериализует объект и его дочерние объекты в возвращаемое хранилище Dictionary<string, object?>.
(Унаследован от CardSerializableObject)
SerializeToStorageAsync(Dictionary<String, Object>, CancellationToken) Сериализует объект и его дочерние объекты в заданное хранилище Dictionary<string, object?>.
(Унаследован от CardSerializableObject)
SerializeToStorageInternalAsync Выполняет сериализацию текущего объекта и всех его дочерних объектов в хранилище Dictionary<string, object?>.
(Переопределяет CardSerializableObject.SerializeToStorageInternalAsync(ICardSerializableContext, Dictionary<String, Object>))
ToStringReturns a string that represents the current object.
(Унаследован от Object)
TryGetValue(Guid, T) Пытается вернуть элемент коллекции по его идентификатору.
TryGetValue(String, T) Пытается вернуть элемент коллекции по его имени.
Validate() Выполняет валидацию объекта и всех его дочерних объектов.
(Унаследован от ValidationObject)
Validate(IValidationResultBuilder)Выполняет валидацию текущего объекта и всех его дочерних объектов.
(Унаследован от ValidationObject)
ValidateInternalВыполняет валидацию текущего объекта и всех его дочерних объектов.
(Переопределяет ValidationObject.ValidateInternal(IValidationResultBuilder))

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

AddRange<T> Добавляет значения items в коллекцию collection.
(Определяется CollectionsExtensions)
AddRange<T> Добавляет значения items в коллекцию collection.
(Определяется CollectionsExtensions)
AddRangeForList Добавляет значения items в коллекцию collection.
(Определяется CollectionsExtensions)
AllOrNull<T> Определяет отвечают ли все элементы последовательности переданному предикату.
(Определяется PlatformExtensions)
AsArray<T> Преобразует коллекцию в массив. В случае, если коллекция не является массивом, к ней применяется ToArray<TSource>(IEnumerable<TSource>).
(Определяется CollectionsExtensions)
AsReadOnlyCollection<T> Преобразует перечисление в коллекцию, доступную только для чтения. В случае, если перечисление не является коллекцией IReadOnlyCollection<T>, но является объектом IList<T>, тогда создаётся объект ReadOnlyCollection<T>, иначе к нему применяется ToImmutableList<TSource>(IEnumerable<TSource>).
(Определяется CollectionsExtensions)
ConvertToListDictionaries<T> Осуществляет сопоставлению коллекции source на коллекцию коллекций ключ-значение в соответствии с контекстом сопоставления по умолчанию
(Определяется DictionaryConverter)
ConvertToListDictionaries<T> Осуществляет сопоставлению коллекции source на коллекцию коллекций ключ-значение в соответствии с контекстом сопоставления context
(Определяется DictionaryConverter)
CopyAndAddRangeAsync<T> Копирует коллекцию сериализуемых объектов sourceItems и в конец коллекции сериализуемых объектов targetItems. Устанавливает порядок следования объектов, если объекты поддерживают ICardMetadataOrderable.
(Определяется CardExtensions)
CopyAndInsertAsync<T> Копирует коллекцию сериализуемых объектов sourceItems и вставляет по индексу в коллекцию сериализуемых объектов targetItems. Устанавливает порядок следования объектов, если объекты поддерживают ICardMetadataOrderable.
(Определяется CardExtensions)
CopyToTheBeginningOfAsync<T> Копирует коллекцию сериализуемых объектов sourceItems в начало коллекции сериализуемых объектов targetItems. Устанавливает порядок следования объектов, если объекты поддерживают ICardMetadataOrderable.
(Определяется CardExtensions)
ForEach<T> Выполняет указанное действие с каждым элементом коллекции IEnumerable<T>.
(Определяется CollectionsExtensions)
FullOuterJoin<T, TInner, TKey, TResult> Объединяет две последовательности по алгоритму FULL OUTER JOIN.
(Определяется CollectionsExtensions)
Get
(Определяется ComHelper)
IndexOf<T> Возвращает индекс первого вхождения элемента в последовательность, определяемый посредством заданного выражения.
(Определяется CollectionsExtensions)
IndexOf<T> Возвращает индекс первого вхождения элемента в последовательность, определяемый посредством заданного компаратора IEqualityComparer<T>.
(Определяется CollectionsExtensions)
IndexOf<T> Выполняет поиск элемента, удовлетворяющего условиям указанного предиката, и возвращает отсчитываемый от нуля индекс первого вхождения в диапазоне элементов списка, начиная с заданного индекса и заканчивая последним элементом.
(Определяется CollectionsExtensions)
IndexOf<T> Выполняет поиск элемента, удовлетворяющего условиям указанного предиката, и возвращает отсчитываемый от нуля индекс первого вхождения в диапазоне элементов списка, начинающемся с заданного индекса и содержащем указанное число элементов.
(Определяется CollectionsExtensions)
InsertNonOrderableAsync<T> Копирует коллекцию сериализуемых объектов sourceItems и вставляет по индексу в коллекцию сериализуемых объектов targetItems.
(Определяется CardExtensions)
InsertRange<T> Вставляет диапазон элементов в заданный список items, начиная с указанного индекса index.
(Определяется CollectionsExtensions)
InsertRangeForList Вставляет диапазон элементов в заданный список items, начиная с указанного индекса index.
(Определяется CollectionsExtensions)
Invoke
(Определяется ComHelper)
LastIndexOf<T> Возвращает индекс последнего вхождения элемента в последовательность, определяемый посредством заданного выражения.
(Определяется CollectionsExtensions)
LastIndexOf<T> Возвращает индекс последнего вхождения элемента в последовательность, определяемый посредством заданного компаратора IEqualityComparer<T>.
(Определяется CollectionsExtensions)
OrderByAttributeAndType<T>

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

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


(Определяется PlatformExtensions)
OrderByDbmsBase<T> Метод для сортировки списка в порядке по возрастанию с учётом особенностей СУБД.
(Определяется DataExtensions)
OrderByDependencies<T>
(Определяется CollectionsExtensions)
OrderByDependencies<T>
(Определяется CollectionsExtensions)
OrderByDependencies<T, TKey>
(Определяется CollectionsExtensions)
OrderByDependencies<T, TKey>
(Определяется CollectionsExtensions)
OrderByDescendingDbmsBase<T> Метод для сортировки списка в порядке по убыванию с учётом особенностей СУБД.
(Определяется DataExtensions)
OrderByLocalized<T> Сортирует значения последовательности по возрастанию по локализованному ключу, который определяется для каждого элемента.
(Определяется PlatformExtensions)
OrderByLocalizedDescending<T> Сортирует значения последовательности по убыванию по локализованному ключу, который определяется для каждого элемента.
(Определяется PlatformExtensions)
RemoveAll<T> Удаляет все элементы, совпадающие по заданному предикату. Возвращает количество удалённых элементов.
(Определяется CollectionsExtensions)
RemoveAllForList Удаляет все элементы, совпадающие по заданному предикату. Возвращает количество удалённых элементов.
(Определяется CollectionsExtensions)
RemoveRange<T> Удаляет значения items из коллекции collection.
(Определяется CollectionsExtensions)
RemoveRange<T> Удаляет значения items из коллекции collection.
(Определяется CollectionsExtensions)
RunWithMaxDegreeOfParallelismAsync<T> Выполняет асинхронную обработку элементов с ограничением на максимальное количество параллельных задач.
(Определяется PlatformExtensions)
Set
(Определяется ComHelper)
ToDictionaryAsync<T, TKey, TElement> Создает словарь Dictionary<TKey, TValue> из объекта IEnumerable<T> в соответствии с заданными функциями синхронного селектора ключа и асинхронного селектора значения.
(Определяется PlatformExtensions)
ToObservableCollection<T> Преобразует коллекцию IEnumerable в ObservableCollection
(Определяется CollectionsExtensions)
ToSealableList<T> Возвращает список объектов, поддерживающий защиту от изменений. Каждый из объектов T в списке либо не реализует интерфейс ISealable, либо защита от изменений таких объектов не активируется вместе со списком.
(Определяется CollectionsExtensions)
ToSealableObjectList<T> Возвращает список объектов, поддерживающий защиту от изменений. Каждый из объектов T в списке реализует интерфейс ISealable и защищается от изменений при активации защиты в списке.
(Определяется CollectionsExtensions)
TryFirst<T> Возвращает первый элемент последовательности, удовлетворяющий условию.
(Определяется CollectionsExtensions)
TrySingleOrDefault<T> Возвращает единственный конкретный элемент коллекции или значение по умолчанию для типа, если этот элемент не найден.
(Определяется CollectionsExtensions)
WithPreviousAndNext<T>
(Определяется EnumerableExtensions)

См. также