Span<T> is stack-only in nature while Memory<T> can exist on the heap.
Span<T>is a new type we are adding to the platform to represent
contiguous regions of arbitrary memory, with performance
characteristics on par with T[]. Its APIs are similar to the array,
but unlike arrays, it can point to either managed or native memory, or
to memory allocated on the stack.
Memory <T>is a type complementingSpan<T>. As discussed in its design
document,Span<T>is a stack-only type. The stack-only nature of
Span<T>makes it unsuitable for many scenarios that require storing
references to buffers (represented withSpan<T>) on the heap, e.g. for
routines doing asynchronous calls.
async Task DoSomethingAsync(Span<byte> buffer) {
buffer[0] = 0;
await Something(); // Oops! The stack unwinds here, but the buffer below
// cannot survive the continuation.
buffer[0] = 1;
}
To address this problem, we will provide a set of complementary types,
intended to be used as general purpose exchange types representing,
just likeSpan <T>, a range of arbitrary memory, but unlikeSpan <T>
these types will not be stack-only, at the cost of significant
performance penalties for reading and writing to the memory.
async Task DoSomethingAsync(Memory<byte> buffer) {
buffer.Span[0] = 0;
await Something(); // The stack unwinds here, but it's OK as Memory<T> is
// just like any other type.
buffer.Span[0] = 1;
}
In the sample above, the
Memory <byte>is used to represent the buffer.
It is a regular type and can be used in methods doing asynchronous
calls. Its Span property returnsSpan<byte>, but the returned value
does not get stored on the heap during asynchronous calls, but rather
new values are produced from theMemory<T>value. In a sense,
Memory<T>is a factory ofSpan<T>.
Reference Document: here