SerializationWriter.WriteObjectArray
Section titled “SerializationWriter.WriteObjectArray”
- Writes an ordered array of structured objects.
Required contracts
Section titled “Required contracts”API: scripting
Project: Inno.Core.Serialization
Scope: Runtime
Declaration
Section titled “Declaration”public void InnoEngine.Serialization.SerializationWriter.WriteObjectArray<TValue>(string name, System.Collections.Generic.IEnumerable<TValue> values, System.Action<InnoEngine.Serialization.SerializationWriter, TValue> writeElement, System.Func<TValue, InnoEngine.Serialization.SerializationCaptureKeyBuilder, bool>? captureKey = null)Type parameters
Section titled “Type parameters”Type parameter TValue: The source element type.
Parameters
Section titled “Parameters”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.
Remarks
Section titled “Remarks”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.
Exceptions
Section titled “Exceptions”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.