docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

    Method AddBuffer

    AddBuffer<T>(Entity)

    Records a command to add a dynamic buffer to an entity.

    Declaration
    public DynamicBuffer<T> AddBuffer<T>(Entity e) where T : unmanaged, IBufferElementData
    Parameters
    Type Name Description
    Entity e

    The entity to add the dynamic buffer to.

    Returns
    Type Description
    DynamicBuffer<T>

    The DynamicBuffer_1 that will be added when the command plays back.

    Type Parameters
    Name Description
    T

    The Unity.Entities.IBufferElementData type stored by the DynamicBuffer_1.

    Remarks

    At playback, if the entity already has this type of dynamic buffer, this method sets the dynamic buffer contents. If the entity doesn't have a DynamicBuffer_1 component that stores elements of type T, then this method adds a DynamicBuffer component with the provided contents. If the entity is destroyed before playback, an error is thrown.

    Exceptions
    Type Condition
    NullReferenceException

    Throws if an Allocator was not passed in when the EntityCommandBuffer was created.

    InvalidOperationException

    Throws if this EntityCommandBuffer has already been played back.

    In This Article
    Back to top
    Copyright © 2026 Unity Technologies — Trademarks and terms of use
    • Legal
    • Privacy Policy
    • Cookie Policy
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)