CardExtensionHelperFixUniqueIdentifiersAsync - метод

public static ValueTask<bool> FixUniqueIdentifiersAsync(
	ListStorage<CardRow> rows,
	string[] identifierFieldNames,
	string? parentIdentifierFieldName = null,
	string? orderFieldName = null,
	bool removeDuplicates = true,
	Func<IList<CardRow>, CardRow, CancellationToken, ValueTask>? removeRowFuncAsync = null,
	CancellationToken cancellationToken = default
)

Public Shared Function FixUniqueIdentifiersAsync ( 
	rows As ListStorage(Of CardRow),
	identifierFieldNames As String(),
	Optional parentIdentifierFieldName As String = Nothing,
	Optional orderFieldName As String = Nothing,
	Optional removeDuplicates As Boolean = true,
	Optional removeRowFuncAsync As Func(Of IList(Of CardRow), CardRow, CancellationToken, ValueTask) = Nothing,
	Optional cancellationToken As CancellationToken = Nothing
) As ValueTask(Of Boolean)

public:
static ValueTask<bool> FixUniqueIdentifiersAsync(
	ListStorage<CardRow^>^ rows, 
	array<String^>^ identifierFieldNames, 
	String^ parentIdentifierFieldName = nullptr, 
	String^ orderFieldName = nullptr, 
	bool removeDuplicates = true, 
	Func<IList<CardRow^>^, CardRow^, CancellationToken, ValueTask>^ removeRowFuncAsync = nullptr, 
	CancellationToken cancellationToken = CancellationToken()
)

static member FixUniqueIdentifiersAsync : 
        rows : ListStorage<CardRow> * 
        identifierFieldNames : string[] * 
        ?parentIdentifierFieldName : string * 
        ?orderFieldName : string * 
        ?removeDuplicates : bool * 
        ?removeRowFuncAsync : Func<IList<CardRow>, CardRow, CancellationToken, ValueTask> * 
        ?cancellationToken : CancellationToken 
(* Defaults:
        let _parentIdentifierFieldName = defaultArg parentIdentifierFieldName null
        let _orderFieldName = defaultArg orderFieldName null
        let _removeDuplicates = defaultArg removeDuplicates true
        let _removeRowFuncAsync = defaultArg removeRowFuncAsync null
        let _cancellationToken = defaultArg cancellationToken new CancellationToken()
*)
-> ValueTask<bool> 

Параметры

rows  ListStorageCardRow

Список строк. Может быть обычной карточкой, файлов или заданием.

identifierFieldNames  String

Список имён полей в строках rows, которые содержат идентификаторы любого типа, уникальность которых требуется обеспечить в пределах списка строк, в т.ч. родительские идентификаторы.

parentIdentifierFieldName  String  (Optional)

Имя поля в строках rows, которое содержит идентификатор для связи с родительской строкой (ParentRowID), у которых обычно указан флажок "Is reference to owner". Эти идентификаторы позволяют найти строки в пределах одной родительской строки при удалении дубликатов. Может быть указан null или пустая строка, если строки rows не принадлежат дочерней секции.

orderFieldName  String  (Optional)

Имя поля для сортировки в строках rows или null, если поле не задано.

removeDuplicates  Boolean  (Optional)

Признак того, что строки-дубликаты должны быть удалены. Используйте false, чтобы найти строки, но не удалять их.

removeRowFuncAsync  FuncIListCardRow, CardRow, CancellationToken, ValueTask  (Optional)

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

cancellationToken  CancellationToken  (Optional)

Объект, посредством которого можно отменить асинхронную задачу.

Возвращаемое значение

Метод гарантирует, что если пользователь удалит и тут же добавит строку с таким же идентификатором, то удалённая не будет удалена, а новая строка не будет добавлена.

Рекомендуется использовать метод в случае, если в секции есть необходимые уникальные индексы.

Ссылки