Method ReplaceComponentForLinkedEntityGroup

ReplaceComponentForLinkedEntityGroup<T>(int, Entity, T)

Records a command that replaces a component value for an entity's LinkedEntityGroup. Entities in the LinkedEntityGroup that don't have the component will be skipped safely.

Declaration

public void ReplaceComponentForLinkedEntityGroup<T>(int sortKey, Entity e, T component) where T : unmanaged, IComponentData

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 whose LinkedEntityGroup will be referenced.
T	component	The component value to set.

Type Parameters

Name	Description
T	The type of component to add.

Remarks

At playback, this command throws an error if the entity is destroyed before playback or if the entity is still deferred.

Exceptions

Type	Condition
ArgumentException	Throws if the component has a reference to a deferred entity, requiring fixup within the command buffer.
NullReferenceException	Throws if an Allocator was not passed in when the EntityCommandBuffer was created.
InvalidOperationException	Throws if this EntityCommandBuffer has already been played back.