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 : struct, IComponentData

Parameters

Type	Name	Description
NativeArray<T>	componentDataArray	The values to copy into the matching entities.
JobHandle	jobHandle	An out parameter assigned a handle that you can use as a dependency for a Job that should happen after this operation completes.

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 T in a NativeArray into the entities matched by this query. This method is generally used in conjunction with ToComponentDataArrayAsync<T>(AllocatorManager.AllocatorHandle, out JobHandle) 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 T is not part of the query.