docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

    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)")]
    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 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 <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 T is not part of the query.

    In This Article
    Back to top
    Copyright © 2024 Unity Technologies — Trademarks and terms of use
    • Legal
    • Privacy Policy
    • Cookie Policy
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)