QuicStream 类

定义

命名空间:

System.Net.Quic

程序集:

System.Net.Quic.dll

Source:

QuicStream.cs

表示 QUIC 流。 QuicStream 可以 单向，即对打开端仅写，或 双向，这允许双方写入。

public ref class QuicStream sealed : System::IO::Stream

public sealed class QuicStream : System.IO.Stream

type QuicStream = class
    inherit Stream

Public NotInheritable Class QuicStream
Inherits Stream

继承

Object

MarshalByRefObject

Stream

QuicStream

注解

QuicStream 可以与其他任何 Stream一样使用。

除了流 API，QuicStream 还公开了 QUIC 特定的功能：

• WriteAsync(ReadOnlyMemory<Byte>, Boolean, CancellationToken)：将流的写入端关闭为具有写入本身的单个操作。
• CompleteWrites()：关闭流的写入端。
• Abort(QuicAbortDirection, Int64)：中止流的写入或阅读端。
• WritesClosed：返回在流写入端关闭（正常或中止）时完成的 Task。
• ReadsClosed：返回在流读取端关闭（正常或中止）时完成的 Task。

属性

CanRead	获取一个值，该值指示 QuicStream 是否支持读取。
CanSeek	获取一个值，该值指示 QuicStream 是否支持查找。
CanTimeout	获取一个值，该值指示 QuicStream 是否可以超时。
CanWrite	获取一个值，该值指示 QuicStream 是否支持写入。
Id	获取流 ID。
Length	获取流上可用的数据的长度。 此属性当前不受支持，并且始终引发 NotSupportedException。
Position	获取或设置当前流中的位置。 此属性当前不受支持，并且始终引发 NotSupportedException。
ReadsClosed	获取一个 Task，该 Task 在阅读端关闭后完成。
ReadTimeout	获取或设置一个值（以毫秒为单位），该值确定流在超时前尝试读取的时间。
Type	获取流类型。
WritesClosed	获取一个 Task，该 Task 将在写入端关闭时完成。
WriteTimeout	获取或设置一个值（以毫秒为单位），该值确定流在超时之前尝试写入的时间。

方法

Abort(QuicAbortDirection, Int64)	中止 读取、写入或 流的两侧。
BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)	开始异步读取操作。 （请考虑改用 ReadAsync(Byte[], Int32, Int32)。
BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)	开始异步写入操作。 （请考虑改用 WriteAsync(Byte[], Int32, Int32)。
Close()	关闭当前流并释放与当前流关联的任何资源（如套接字和文件句柄）。 请确保流已正确释放，而不是调用此方法。 (继承自 Stream)
CompleteWrites()	优雅地完成流的写入端。
CopyTo(Stream)	从当前流中读取字节并将其写入另一个流。 这两个流位置都是按复制的字节数进行高级的。 (继承自 Stream)
CopyTo(Stream, Int32)	从当前流中读取字节，并使用指定的缓冲区大小将其写入另一个流。 这两个流位置都是按复制的字节数进行高级的。 (继承自 Stream)
CopyToAsync(Stream)	从当前流异步读取字节并将其写入另一个流。 这两个流位置都是按复制的字节数进行高级的。 (继承自 Stream)
CopyToAsync(Stream, CancellationToken)	使用指定的取消标记异步读取当前流中的字节并将其写入另一个流。 这两个流位置都是按复制的字节数进行高级的。 (继承自 Stream)
CopyToAsync(Stream, Int32)	使用指定的缓冲区大小异步读取当前流中的字节并将其写入另一个流。 这两个流位置都是按复制的字节数进行高级的。 (继承自 Stream)
CopyToAsync(Stream, Int32, CancellationToken)	使用指定的缓冲区大小和取消令牌异步读取当前流中的字节并将其写入另一个流。 这两个流位置都是按复制的字节数进行高级的。 (继承自 Stream)
CreateObjRef(Type)	创建一个对象，其中包含生成用于与远程对象通信的代理所需的所有相关信息。 (继承自 MarshalByRefObject)
CreateWaitHandle()	已过时. 分配 WaitHandle 对象。 (继承自 Stream)
Dispose()	释放 Stream使用的所有资源。 (继承自 Stream)
Dispose(Boolean)	释放 Stream 使用的非托管资源，并选择性地释放托管资源。 (继承自 Stream)
DisposeAsync()	如果读取端未完全使用，即未完成 ReadsClosed 或 ReadAsync(Memory<Byte>, CancellationToken) 未返回 0，则中止提供 DefaultStreamErrorCode的读取端。 如果写入端尚未关闭，则将其正常关闭，就好像调用了 CompleteWrites() 一样。 最后，将释放与流关联的所有资源。
EndRead(IAsyncResult)	等待挂起的异步读取完成。 （请考虑改用 ReadAsync(Byte[], Int32, Int32)。
EndWrite(IAsyncResult)	结束异步写入操作。 （请考虑改用 WriteAsync(Byte[], Int32, Int32)。
Equals(Object)	确定指定的对象是否等于当前对象。 (继承自 Object)
Flush()	在派生类中重写时，清除此流的所有缓冲区，并导致任何缓冲数据写入基础设备。
FlushAsync()	异步清除此流的所有缓冲区，并导致任何缓冲数据写入基础设备。 (继承自 Stream)
FlushAsync(CancellationToken)	异步清除此流的所有缓冲区，导致任何缓冲数据写入基础设备，并监视取消请求。
GetHashCode()	用作默认哈希函数。 (继承自 Object)
GetLifetimeService()	已过时. 检索控制此实例的生存期策略的当前生存期服务对象。 (继承自 MarshalByRefObject)
GetType()	获取当前实例的 Type。 (继承自 Object)
InitializeLifetimeService()	已过时. 获取生存期服务对象来控制此实例的生存期策略。 (继承自 MarshalByRefObject)
MemberwiseClone()	创建当前 Object的浅表副本。 (继承自 Object)
MemberwiseClone(Boolean)	创建当前 MarshalByRefObject 对象的浅表副本。 (继承自 MarshalByRefObject)
ObjectInvariant()	已过时. 为 Contract提供支持。 (继承自 Stream)
Read(Byte[], Int32, Int32)	在派生类中重写时，从当前流中读取字节序列，并通过读取的字节数推进流中的位置。
Read(Span<Byte>)	在派生类中重写时，从当前流中读取字节序列，并通过读取的字节数推进流中的位置。
ReadAsync(Byte[], Int32, Int32)	从当前流异步读取字节序列，并通过读取的字节数推进流中的位置。 (继承自 Stream)
ReadAsync(Byte[], Int32, Int32, CancellationToken)	从当前流异步读取字节序列，按读取的字节数推进流中的位置，并监视取消请求。
ReadAsync(Memory<Byte>, CancellationToken)	从当前流异步读取字节序列，按读取的字节数推进流中的位置，并监视取消请求。
ReadAtLeast(Span<Byte>, Int32, Boolean)	至少从当前流中读取最小字节数，并通过读取的字节数提升流中的位置。 (继承自 Stream)
ReadAtLeastAsync(Memory<Byte>, Int32, Boolean, CancellationToken)	异步读取当前流的最小字节数，按读取的字节数推进流中的位置，并监视取消请求。 (继承自 Stream)
ReadByte()	从流中读取字节，并将流中的位置向前推进一个字节，或者在流末尾返回 -1。
ReadExactly(Byte[], Int32, Int32)	从当前流中读取 count 字节数，并提升流中的位置。 (继承自 Stream)
ReadExactly(Span<Byte>)	从当前流中读取字节，并在填充 buffer 之前推进流中的位置。 (继承自 Stream)
ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken)	从当前流异步读取 count 字节数，推进流中的位置，并监视取消请求。 (继承自 Stream)
ReadExactlyAsync(Memory<Byte>, CancellationToken)	从当前流异步读取字节，在填充 buffer 之前先行流中的位置，并监视取消请求。 (继承自 Stream)
Seek(Int64, SeekOrigin)	将流的当前位置设置为给定值。 此方法目前不受支持，并且始终引发 NotSupportedException。
SetLength(Int64)	设置流的长度。 此方法目前不受支持，并且始终引发 NotSupportedException。
ToString()	返回一个表示当前对象的字符串。
Write(Byte[], Int32, Int32)	在派生类中重写时，将字节序列写入当前流，并通过写入的字节数推进此流中的当前位置。
Write(ReadOnlySpan<Byte>)	在派生类中重写时，将字节序列写入当前流，并通过写入的字节数推进此流中的当前位置。
WriteAsync(Byte[], Int32, Int32)	以异步方式将字节序列写入当前流，并通过写入的字节数推进此流中的当前位置。 (继承自 Stream)
WriteAsync(Byte[], Int32, Int32, CancellationToken)	将字节序列异步写入当前流，按写入的字节数推进此流中的当前位置，并监视取消请求。
WriteAsync(ReadOnlyMemory<Byte>, Boolean, CancellationToken)	将字节序列异步写入当前流，按写入的字节数推进此流中的当前位置，并监视取消请求。
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)	将字节序列异步写入当前流，按写入的字节数推进此流中的当前位置，并监视取消请求。
WriteByte(Byte)	将字节写入流中的当前位置，并将流中的位置向前推进一个字节。

扩展方法

CopyToAsync(Stream, PipeWriter, CancellationToken)	使用取消令牌从 Stream 异步读取字节并将其写入指定的 PipeWriter。
ConfigureAwait(IAsyncDisposable, Boolean)	配置如何执行从异步可释放项返回的任务的 await。

另请参阅

• RFC 9000：流