Lesa á ensku Breyta

Deila með


GC.AllocateUninitializedArray<T>(Int32, Boolean) Method

Definition

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Allocates an array while skipping zero-initialization, if possible.

public static T[] AllocateUninitializedArray<T>(int length, bool pinned = false);

Type Parameters

T

Specifies the type of the array element.

Parameters

length
Int32

Specifies the length of the array.

pinned
Boolean

Specifies whether the allocated array must be pinned.

Returns

T[]

An array object with uninitialized memory.

Remarks

In .NET 7 and earlier versions: If pinned is set to true, T must not be a reference type or a type that contains object references.

Skipping zero-initialization is a security risk. The uninitialized array can contain invalid valuetype instances or sensitive information created by other parts of the application. The code operating on uninitialized arrays should be heavily scrutinized to ensure that the uninitialized data is never read.

Skipping zero-initialization using this API only has a material performance benefit for large arrays, such as buffers of several kilobytes or more.

Applies to

Vara Útgáfur
.NET 5, 6, 7, 8, 9, 10