Skip to content
API referenceDevelopmentEngine APIEngine ccf7d03f
Synced
  • Writes an ordered array of structured objects.

API: engine
Project: Inno.Core.Serialization

public void Inno.Core.Serialization.SerializationWriter.WriteObjectArray<TValue>(string name, System.Collections.Generic.IEnumerable<TValue> values, System.Action<Inno.Core.Serialization.SerializationWriter, TValue> writeElement, System.Func<TValue, Inno.Core.Serialization.SerializationCaptureKeyBuilder, bool>? captureKey = null)

Type parameter TValue: The source element type.

Parameter name: The unique non-empty member name.

Parameter values: The elements to write.

Parameter writeElement: The callback that fills each element object.

Parameter captureKey: An optional pure callback covering every element output and contextual input. It must declare a current Core identity owner and return true only for a complete proof. Snapshot capture alone can reuse a matching element; ordinary serialization always executes writeElement.

The key builder belongs only to its synchronous callback. Uncertified rows and rows that invoke nested converters execute the ordinary element writer on every capture. Callback failures and changed declared inputs abort publication without modifying a previous snapshot.

Exception T:System.ArgumentNullException: Values or writeElement is null.

Exception T:System.ArgumentException: The member name is null, empty or whitespace.

Exception T:System.InvalidOperationException: The writer has retired, a member is duplicated, or declared capture inputs change during writing.