当前位置: 首页 > 文档资料 > CatLib 中文文档 >

组合流

优质
小牛编辑
135浏览
2023-12-01

组合流允许将多个不同的流组合成一个流,这两个流可以分别为流式传输和非流式传输。

构建组合流

var combineStream = new CombineStream()
函数原型
CombineStream(Stream left, Stream right, bool closed = false);
参数描述
left左侧的流
right右侧的流
closed是否在流读取完成后自动关闭流
CombineStream(Stream[] source, bool closed = false);
参数描述
source多个流的数组,按照数组顺序排列
closed是否在流读取完成后自动关闭流

Length

获取组合流的总长度,如果组合流中的任意一个流不能被获取长度,那么将会引发一个NotSupportedException

var length = combineStream.Length;
函数原型
long Length { get; }

CanSeek

判断组合流是否能够偏移,如果组合流中的任意一个流不能够偏移,那么返回false

var canSeek = combineStream.CanSeek;
函数原型
bool CanSeek { get; }

Position

获取组合流全局的偏移量

var position = combineStream.Position;
函数原型
long Position { get; }

CanRead

判断管道流是否可以被读取,如果组合流中的任意一个流不能够读取,那么返回false

var readable = combineStream.CanRead;
函数原型
bool CanRead { get; }

CanWrite

判断管道流是否可以被写入。管道流永远返回false

var writeable = combineStream.CanWrite;
函数原型
bool CanWrite { get; }

Seek

偏移游标到指定位置。

combineStream.Seek(0, SeekOrigin.Begin);
函数原型
long Seek(long offset, SeekOrigin origin);
参数描述
offset指定的偏移位置
origin偏移方向

Read

读取组合流中的数据,返回值为实际读取的长度。

var read = combineStream.Read(buffer, 0, buffer.Length);
函数原型
int Read(byte[] buffer, int offset, int count)
参数描述
buffer读取的缓冲区
offset读取缓冲区起始偏移量
count期望读取的长度

Write

组合流不支持写入,会引发一个NotSupportedException异常。

SetLength

组合流不支持设定长度,会引发一个NotSupportedException异常。

Flush

组合流不支持Flush,会引发一个NotSupportedException异常。