Method CopyFromComponentDataArrayAsync
CopyFromComponentDataArrayAsync<T>(NativeArray<T>, out JobHandle)
Obsolete. Use CopyFromComponentDataListAsync<T>(NativeList<T>, out JobHandle) instead.
Declaration
[Obsolete("This method does not correctly support enableable components, and is generally unsafe. Use CopyFromComponentDataListAsync() instead. (RemovedAfter Entities 1.0)")]
[GenerateTestsForBurstCompatibility(GenericTypeArguments = new Type[] { typeof(BurstCompatibleComponentData) })]
public void CopyFromComponentDataArrayAsync<T>(NativeArray<T> componentDataArray, out JobHandle jobHandle) where T : unmanaged, IComponentData
Parameters
Type | Name | Description |
---|---|---|
NativeArray<T> | componentDataArray | The values to copy into the matching entities. |
JobHandle | jobHandle | An |
Type Parameters
Name | Description |
---|---|
T | The component type. |
Remarks
Obsolete. Use CopyFromComponentDataListAsync<T>(NativeList<T>, out JobHandle) instead.
Asynchronously copies the values of component type <code class="typeparamref">T</code> in a NativeArray into the entities
matched by this query.
This method is generally used in conjunction with <xref href="Unity.Entities.EntityQuery.ToComponentDataArrayAsync%60%601(Unity.Collections.AllocatorManager.AllocatorHandle%2cUnity.Jobs.JobHandle%40)" data-throw-if-not-resolved="false"></xref> to extract component values,
pass them into some code that expects a flat array of values, and then scatter the updated values back to entities.
Exceptions
Type | Condition |
---|---|
InvalidOperationException | Thrown in the query contains any enableable components. |
InvalidOperationException | Thrown if |