# ToComponentDataListAsync

> Creates (and asynchronously populates) a NativeList containing the value of component T for the selected entities. Since the exact number of entities matching the query won't be known until the job runs, this method returns a NativeList<T>.

## Definition

* **Type:** Method
* **Namespace:** [Unity.Entities](/engine/7000.0/script-reference/unity/entities.md)
* **Assembly:** UnityEngine.EntitiesModule

## ToComponentDataListAsync\<T>(AllocatorHandle, JobHandle)

Creates (and asynchronously populates) a NativeList containing the value of component `T` for the selected entities. Since the exact number of entities matching the query won't be known until the job runs, this method returns a [NativeList\<T>](/engine/7000.0/script-reference/unity/collections/nativelist1.md).

```csharp
public NativeList<T> ToComponentDataListAsync<T>(AllocatorManager.AllocatorHandle allocator, out JobHandle outJobHandle) where T : unmanaged, IComponentData
```

### Parameters

**** (\[AllocatorHandle]\(/engine/7000.0/script-reference/unity/collections/allocatormanager/allocatorhandle)): The type of memory to allocate.**** (\[JobHandle]\(/engine/7000.0/script-reference/unity/jobs/jobhandle)): An `out` parameter assigned a handle that you can use as a dependency for a Job that uses the output data.

### Returns

| Type                                                                               | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ---------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [NativeList\<T>](/engine/7000.0/script-reference/unity/collections/nativelist1.md) | A list containing all the values of component type `T` selected by the query. The contents of this list (including the list's `Length` property) must not be accessed before `outJobHandle` has been completed. To pass this list to a job that expects a [NativeArray\<T>](/engine/7000.0/script-reference/unity/collections/nativearray1.md), use [NativeList\<T>.AsDeferredJobArray](/engine/7000.0/script-reference/unity/collections/nativelist1/asdeferredjobarray.md). |

### Remarks

The job scheduled by this call will automatically use the component safety system to determine its input dependencies, to avoid the most common race conditions. If additional input dependencies are required beyond what the component safety system knows about, use [EntityQuery.ToComponentDataListAsync](/engine/7000.0/script-reference/unity/entities/entityquery/tocomponentdatalistasync.md).

## ToComponentDataListAsync\<T>(AllocatorHandle, JobHandle, JobHandle)

Creates (and asynchronously populates) a NativeList containing the value of component `T` for the selected entities. Since the exact number of entities matching the query won't be known until the job runs, this method returns a [NativeList\<T>](/engine/7000.0/script-reference/unity/collections/nativelist1.md).

```csharp
public NativeList<T> ToComponentDataListAsync<T>(AllocatorManager.AllocatorHandle allocator, JobHandle additionalInputDep, out JobHandle outJobHandle) where T : unmanaged, IComponentData
```

### Parameters

**** (\[AllocatorHandle]\(/engine/7000.0/script-reference/unity/collections/allocatormanager/allocatorhandle)): The type of memory to allocate.**** (\[JobHandle]\(/engine/7000.0/script-reference/unity/jobs/jobhandle)): A job handle which the newly scheduled job will depend upon, in addition to the dependencies automatically determined by the component safety system.**** (\[JobHandle]\(/engine/7000.0/script-reference/unity/jobs/jobhandle)): An `out` parameter assigned a handle that you can use as a dependency for a Job that uses the output data.

### Returns

| Type                                                                               | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ---------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [NativeList\<T>](/engine/7000.0/script-reference/unity/collections/nativelist1.md) | A list containing all the values of component type `T` selected by the query. The contents of this list (including the list's `Length` property) must not be accessed before `outJobHandle` has been completed. To pass this list to a job that expects a [NativeArray\<T>](/engine/7000.0/script-reference/unity/collections/nativearray1.md), use [NativeList\<T>.AsDeferredJobArray](/engine/7000.0/script-reference/unity/collections/nativelist1/asdeferredjobarray.md). |