docs.unity.cn
    Show / Hide Table of Contents

    Method ToComponentDataArray

    ToComponentDataArray<T>(AllocatorManager.AllocatorHandle)

    Creates a NativeArray containing the components of type T for the selected entities.

    Declaration
    [GenerateTestsForBurstCompatibility(GenericTypeArguments = new Type[]{typeof(BurstCompatibleComponentData)})]
    public NativeArray<T> ToComponentDataArray<T>(AllocatorManager.AllocatorHandle allocator)
        where T : struct, IComponentData
    Parameters
    Type Name Description
    AllocatorManager.AllocatorHandle allocator

    The type of memory to allocate.

    Returns
    Type Description
    NativeArray<T>

    An array containing the specified component for all the entities selected by the EntityQuery.

    Type Parameters
    Name Description
    T

    The component type.

    Remarks

    This version of the function blocks on all registered jobs against the relevant query components. For a non-blocking variant, see ToComponentDataListAsync<T>(AllocatorManager.AllocatorHandle, out JobHandle)

    Exceptions
    Type Condition
    InvalidOperationException

    Thrown if you request a component that is not part of the group.

    InvalidOperationException

    Thrown if T is not part of the query.

    ToComponentDataArray<T>()

    Creates a managed array containing the components of type T for the selected entities.

    Declaration
    [ExcludeFromBurstCompatTesting("Returns managed array")]
    public T[] ToComponentDataArray<T>()
        where T : class, IComponentData, new()
    Returns
    Type Description
    T[]

    A managed array containing the specified component for all the entities selected by the EntityQuery.

    Type Parameters
    Name Description
    T

    The component type.

    Remarks

    This version of the function blocks on all registered jobs against the relevant query components. For a non-blocking variant, see ToComponentDataListAsync<T>(AllocatorManager.AllocatorHandle, out JobHandle)

    Exceptions
    Type Condition
    InvalidOperationException

    Thrown if you request a component that is not part of the group.

    InvalidOperationException

    Thrown if T is not part of the query.

    Back to top Copyright © 2023 Unity Technologies — Terms of use
    Generated by DocFX
    on Wednesday, June 21, 2023