Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
Memory-related and span types
.NET includes a number of interrelated types that represent a contiguous, strongly typed region of arbitrary memory. These types are designed to allow the creation of algorithms that avoid copying memory or allocating on the managed heap more than necessary. Creating them (either via Slice, AsSpan(), a collection expression, or their constructors) does not involve duplicating the underlying buffers: only the relevant references and offsets, which represent the "view" of the wrapped memory, are updated. In high-performance code, spans are often used to avoid allocating strings unnecessarily.
The types include:
System.Span<T>, a type that's used to access a contiguous region of memory. A Span<T> instance can be backed by an array of type
T, a buffer allocated with stackalloc, or a pointer to unmanaged memory. Because it has to be allocated on the stack, it has a number of restrictions. For example, a field in a class cannot be of type Span<T>, nor can span be used in asynchronous operations.System.ReadOnlySpan<T>, an immutable version of the Span<T> structure. Instances can be also backed by a String.
System.Memory<T>, a wrapper over a contiguous region of memory. A Memory<T> instance can be backed by an array of type
Tor a memory manager. As it can be stored on the managed heap, Memory<T> has none of the limitations of Span<T>.System.ReadOnlyMemory<T>, an immutable version of the Memory<T> structure. Instances can also be backed by a String.
System.Buffers.MemoryPool<T>, which allocates strongly typed blocks of memory from a memory pool to an owner. IMemoryOwner<T> instances can be rented from the pool by calling MemoryPool<T>.Rent and released back to the pool by calling MemoryPool<T>.Dispose().
System.Buffers.IMemoryOwner<T>, which represents the owner of a block of memory and controls its lifetime management.
MemoryManager<T>, an abstract base class that can be used to replace the implementation of Memory<T> so that Memory<T> can be backed by additional types, such as safe handles. MemoryManager<T> is intended for advanced scenarios.
ArraySegment<T>, a wrapper for a particular number of array elements starting at a particular index.
System.MemoryExtensions, a collection of extension methods for converting strings, arrays, and array segments to Memory<T> blocks.
For more information, see the System.Buffers namespace.
Working with memory and span
Because the memory-related and span-related types are typically used to store data in a processing pipeline, it's important that you follow a set of best practices when using Span<T>, Memory<T>, and related types. These best practices are documented in Memory<T> and Span<T> usage guidelines.
See also
Feedback
Was this page helpful?