docs.unity.cn
    Show / Hide Table of Contents

    Method AddComponentData

    AddComponentData<T>(EntityManager, Entity, T)

    Adds a component to an entity and set the value of that component.

    Declaration
    public static void AddComponentData<T>(this EntityManager manager, Entity entity, T componentData)
        where T : class, IComponentData
    Parameters
    Type Name Description
    EntityManager manager
    Entity entity

    The entity.

    T componentData

    The data to set.

    Type Parameters
    Name Description
    T

    The type of component.

    Remarks

    Adding a component changes an entity's archetype and results in the entity being moved to a different chunk.

    Important: This function creates a sync point, which means that the EntityManager waits for all currently running Jobs to complete before adding the component and no additional Jobs can start before the function is finished. A sync point can cause a drop in performance because the ECS framework may not be able to make use of the processing power of all available cores.

    Back to top Copyright © 2020 Unity Technologies
    Generated by DocFX
    on Friday, May 28, 2021