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 : struct, IBufferElementDataParameters
| Type | Name | Description |
|---|---|---|
| Entity | e | The entity to add the dynamic buffer to. |
Returns
| Type | Description |
|---|---|
| DynamicBuffer<T> | The DynamicBuffer<T> that will be added when the command plays back. |
Type Parameters
| Name | Description |
|---|---|
| T | The IBufferElementData type stored by the DynamicBuffer<T>. |
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<T> 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, or is deferred, 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. |