# AddComponentForLinkedEntityGroup

> Records a command that adds a component to an entity's LinkedEntityGroup based on an EntityQueryMask. Entities in the LinkedEntityGroup that don't match the mask will be skipped safely.

## Definition

* **Type:** Method
* **Namespace:** [Unity.Entities](/engine/7000.0/script-reference/unity/entities.md)
* **Assembly:** UnityEngine.EntitiesModule

## AddComponentForLinkedEntityGroup\<T>(int, Entity, EntityQueryMask, T)

Records a command that adds a component to an entity's [LinkedEntityGroup](/engine/7000.0/script-reference/unity/entities/linkedentitygroup.md) based on an [EntityQueryMask](/engine/7000.0/script-reference/unity/entities/entityquerymask.md). Entities in the [LinkedEntityGroup](/engine/7000.0/script-reference/unity/entities/linkedentitygroup.md) that don't match the mask will be skipped safely.

```csharp
public void AddComponentForLinkedEntityGroup<T>(int sortKey, Entity e, EntityQueryMask mask, T component) where T : unmanaged, IComponentData
```

### Parameters

**** (\[int]\(https\://learn.microsoft.com/dotnet/api/system.int32)): A unique index for each set of commands added to this EntityCommandBuffer across all parallel jobs writing commands to this buffer. The [ChunkIndexInQuery](/engine/7000.0/script-reference/unity/entities/chunkindexinquery.md) provided by [IJobEntity](/engine/7000.0/script-reference/unity/entities/ijobentity.md) is an appropriate value to use for this parameter. In an [IJobChunk](/engine/7000.0/script-reference/unity/entities/ijobchunk.md) pass the 'unfilteredChunkIndex' value from IJobChunk.Execute.**** (\[Entity]\(/engine/7000.0/script-reference/unity/entities/entity)): The entity whose LinkedEntityGroup will be referenced.**** (\[EntityQueryMask]\(/engine/7000.0/script-reference/unity/entities/entityquerymask)): The EntityQueryMask that is used to determine which linked entities to add the component to. Note that EntityQueryMask ignores all query filtering (including chunk filtering and enableable components), and may thus match more entities than expected.**** (T): The component value to set.

### Remarks

At playback, this command throws an error if the entity is destroyed before playback, or if any of the matching linked entities cannot add the component.

## AddComponentForLinkedEntityGroup(int, Entity, EntityQueryMask, ComponentType)

Records a command that adds a component to an entity's [LinkedEntityGroup](/engine/7000.0/script-reference/unity/entities/linkedentitygroup.md) based on an [EntityQueryMask](/engine/7000.0/script-reference/unity/entities/entityquerymask.md). Entities in the [LinkedEntityGroup](/engine/7000.0/script-reference/unity/entities/linkedentitygroup.md) that don't match the mask will be skipped safely.

```csharp
public void AddComponentForLinkedEntityGroup(int sortKey, Entity e, EntityQueryMask mask, ComponentType componentType)
```

### Parameters

**** (\[int]\(https\://learn.microsoft.com/dotnet/api/system.int32)): A unique index for each set of commands added to this EntityCommandBuffer across all parallel jobs writing commands to this buffer. The [ChunkIndexInQuery](/engine/7000.0/script-reference/unity/entities/chunkindexinquery.md) provided by [IJobEntity](/engine/7000.0/script-reference/unity/entities/ijobentity.md) is an appropriate value to use for this parameter. In an [IJobChunk](/engine/7000.0/script-reference/unity/entities/ijobchunk.md) pass the 'unfilteredChunkIndex' value from IJobChunk.Execute.**** (\[Entity]\(/engine/7000.0/script-reference/unity/entities/entity)): The entity whose LinkedEntityGroup will be referenced.**** (\[EntityQueryMask]\(/engine/7000.0/script-reference/unity/entities/entityquerymask)): The EntityQueryMask that is used to determine which linked entities to add the component to. Note that EntityQueryMask ignores all query filtering (including chunk filtering and enableable components), and may thus match more entities than expected.**** (\[ComponentType]\(/engine/7000.0/script-reference/unity/entities/componenttype)): The component type to add.

### Remarks

At playback, this command throws an error if the entity is destroyed before playback, or if any of the matching linked entities cannot add the component.