QuicStream 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
表示 QUIC 數據流。 QuicStream 可以 單向，也就是只針對開頭端寫入，或 雙向，這可讓兩端寫入。
public ref class QuicStream sealed : System::IO::Streampublic sealed class QuicStream : System.IO.Streamtype QuicStream = class
inherit StreamPublic NotInheritable Class QuicStream
Inherits Stream- 繼承
備註
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 |
取得數據流標識碼。 |
| Length |
取得數據流上可用的數據長度。 目前不支援這個屬性，而且一律會擲回 NotSupportedException。 |
| Position |
取得或設定目前數據流中的位置。 目前不支援這個屬性，而且一律會擲回 NotSupportedException。 |
| ReadsClosed |
取得 Task，一旦讀取端關閉，就會完成。 |
| ReadTimeout |
取得或設定值，以毫秒為單位，決定數據流在逾時之前嘗試讀取的時間長度。 |
| Type |
取得數據流類型。 |
| WritesClosed |
取得在寫入端關閉時完成的 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) |
建立物件，其中包含產生用來與遠端物件通訊之 Proxy 所需的所有相關信息。 (繼承來源 MarshalByRefObject) |
| CreateWaitHandle() |
已淘汰.
已淘汰.
已淘汰.
配置 WaitHandle 物件。 (繼承來源 Stream) |
| Dispose() |
釋放 Stream所使用的所有資源。 (繼承來源 Stream) |
| Dispose(Boolean) |
釋放 Stream 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。 (繼承來源 Stream) |
| DisposeAsync() |
如果讀取端未完全取用，也就是說，ReadsClosed 未完成或 ReadAsync(Memory<Byte>, CancellationToken) 尚未傳回 |
| 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) |
從目前數據流讀取 |
| ReadExactly(Span<Byte>) |
從目前的數據流讀取位元組，並將位置往前移，直到填入 |
| ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken) |
以異步方式從目前數據流讀取 |
| ReadExactlyAsync(Memory<Byte>, CancellationToken) |
以異步方式從目前數據流讀取位元組、將數據流中的位置往前移，直到填入 |
| Seek(Int64, SeekOrigin) |
將數據流的目前位置設定為指定的值。 目前不支援這個方法，而且一律會擲回 NotSupportedException。 |
| SetLength(Int64) |
設定數據流的長度。 目前不支援這個方法，而且一律會擲回 NotSupportedException。 |
| ToString() |
傳回表示目前 物件的字串。 |
| ToString() |
傳回表示目前 物件的字串。 (繼承來源 Object) |
| 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) |
設定如何執行從異步可處置專案傳回的工作等候。 |
