title: 内存存储

内存存储

内存存储避免了传统MemoryStream对于大块内存的连续占用，内存存储实现接口IStorage。

var storage = new MemoryStorage();

MemoryStorage(int blockBuffer = 4096, int capacity = 16)
        : this(long.MaxValue, blockBuffer, capacity);

MemoryStorage(long maxMemoryUsable, int blockBuffer = 4096, int capacity = 16);

参数	描述
`blockBuffer`	每个区块的内存块大小
`capacity`	默认的区块数量，超过这个数量将会以2的次方扩容。
`maxMemoryUsable`	最大内存使用限制，超出后将会引发`OutOfMemoryException`异常。

存储数据的长度。

var length = storage.Length;

long Length { get; };

读写锁

var locker = storage.Locker;

ReaderWriterLockSlim Locker { get; };

内存存储是否已经被释放了。

var disabled = storage.Disabled;

bool Disabled { get; };

var storage = new MemoryStorage();

将指定缓冲区的数据写入到内存存储,数据必定全部写入，如果引发了异常则表示无法被写入。

storage.Write(buffer, 0, buffer.Length, 0);

void Write(byte[] buffer, int offset, int count, long index = 0);

将指定缓冲区的数据追加到内存存储,数据必定全部写入，如果引发了异常则表示无法被写入。

storage.Append(buffer, 0, buffer.Length);

void Append(byte[] buffer, int offset, int count);

读取内存存储的数据到指定缓冲区，返回值为实际读取的长度。

var read = storage.Read(buffer, 0, buffer.Length, 0);

int Read(byte[] buffer, int offset, int count, long index = 0);