Method AppendToBuffer

AppendToBuffer<T>(int, Entity, T)

Records a command to append a single element to the end of a dynamic buffer component.

Declaration

public void AppendToBuffer<T>(int sortKey, Entity e, T element) where T : struct, IBufferElementData

Parameters

Type	Name	Description
int	sortKey	A unique index for each set of commands added to this EntityCommandBuffer across all parallel jobs writing commands to this buffer. The ChunkIndexInQuery provided by IJobEntity is an appropriate value to use for this parameter. In an IJobChunk pass the 'unfilteredChunkIndex' value from Execute(in ArchetypeChunk, int, bool, in v128).
Entity	e	The entity to which the dynamic buffer belongs.
T	element	The new element to add to the DynamicBuffer<T> component.

Type Parameters

Name	Description
T	The IBufferElementData type stored by the DynamicBuffer<T>.

Remarks

At playback, this command throws an error if this entity is destroyed before playback, if this entity is still deferred, or if the entity doesn't have a DynamicBuffer<T> component storing elements of type T.

Exceptions

Type	Condition
InvalidOperationException	Thrown if the entity does not have a DynamicBuffer<T> component storing elements of type T at the time the entity command buffer executes this append-to-buffer command.
NullReferenceException	Throws if an Allocator was not passed in when the EntityCommandBuffer was created.