EncodingExtensions.Convert 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| Convert(Decoder, ReadOnlySequence<Byte>, IBufferWriter<Char>, Boolean, Int64, Boolean) |
將 ReadOnlySequence<T> 轉換成 UTF-16 編碼的字元，並將結果寫入到 |
| Convert(Decoder, ReadOnlySpan<Byte>, IBufferWriter<Char>, Boolean, Int64, Boolean) |
使用 |
| Convert(Encoder, ReadOnlySequence<Char>, IBufferWriter<Byte>, Boolean, Int64, Boolean) |
將 ReadOnlySequence<T> 轉換成編碼的位元組，並將結果寫入到 |
| Convert(Encoder, ReadOnlySpan<Char>, IBufferWriter<Byte>, Boolean, Int64, Boolean) |
使用 |
Convert(Decoder, ReadOnlySequence<Byte>, IBufferWriter<Char>, Boolean, Int64, Boolean)
將 ReadOnlySequence<T> 轉換成 UTF-16 編碼的字元，並將結果寫入到 writer。
public:
[System::Runtime::CompilerServices::Extension]
static void Convert(System::Text::Decoder ^ decoder, System::Buffers::ReadOnlySequence<System::Byte> % bytes, System::Buffers::IBufferWriter<char> ^ writer, bool flush, [Runtime::InteropServices::Out] long % charsUsed, [Runtime::InteropServices::Out] bool % completed);public static void Convert (this System.Text.Decoder decoder, in System.Buffers.ReadOnlySequence<byte> bytes, System.Buffers.IBufferWriter<char> writer, bool flush, out long charsUsed, out bool completed);static member Convert : System.Text.Decoder * ReadOnlySequence * System.Buffers.IBufferWriter<char> * bool * int64 * bool -> unit<Extension()>
Public Sub Convert (decoder As Decoder, ByRef bytes As ReadOnlySequence(Of Byte), writer As IBufferWriter(Of Char), flush As Boolean, ByRef charsUsed As Long, ByRef completed As Boolean)參數
- decoder
- Decoder
可以將位元組轉換成 char 值的解碼器執行個體。
- bytes
- ReadOnlySequence<Byte>
要解碼的位元組序列。
- writer
- IBufferWriter<Char>
將寫入解碼字元的緩衝區。
- flush
- Boolean
true 表示不再轉換任何資料；否則為 false。
- charsUsed
- Int64
當這個方法傳回時，包含已寫入到 writer 的字元計數。
- completed
- Boolean
當這個方法傳回時，如果 decoder 未包含任何部分內部狀態，即會包含 true，否則會包含 false。
如果 flush 為 true，當這個方法傳回時，一律會將此設定為 true。
例外狀況
bytes 包含無法解碼的資料，並將 decoder 設定為在看到此類資料時擲回。
適用於
Convert(Decoder, ReadOnlySpan<Byte>, IBufferWriter<Char>, Boolean, Int64, Boolean)
使用 decoder 來將 ReadOnlySpan<T> 轉換成字元，並將結果寫入到 writer。
public:
[System::Runtime::CompilerServices::Extension]
static void Convert(System::Text::Decoder ^ decoder, ReadOnlySpan<System::Byte> bytes, System::Buffers::IBufferWriter<char> ^ writer, bool flush, [Runtime::InteropServices::Out] long % charsUsed, [Runtime::InteropServices::Out] bool % completed);public static void Convert (this System.Text.Decoder decoder, ReadOnlySpan<byte> bytes, System.Buffers.IBufferWriter<char> writer, bool flush, out long charsUsed, out bool completed);static member Convert : System.Text.Decoder * ReadOnlySpan<byte> * System.Buffers.IBufferWriter<char> * bool * int64 * bool -> unit<Extension()>
Public Sub Convert (decoder As Decoder, bytes As ReadOnlySpan(Of Byte), writer As IBufferWriter(Of Char), flush As Boolean, ByRef charsUsed As Long, ByRef completed As Boolean)參數
- decoder
- Decoder
可以將位元組轉換成 char 值的解碼器執行個體。
- bytes
- ReadOnlySpan<Byte>
要解碼的位元組序列。
- writer
- IBufferWriter<Char>
將寫入解碼字元的緩衝區。
- flush
- Boolean
true 表示不再轉換任何資料；否則為 false。
- charsUsed
- Int64
當這個方法傳回時，包含寫入到 writer 的 char 計數。
- completed
- Boolean
當這個方法傳回時，如果 decoder 未包含任何部分內部狀態，即會包含 true，否則會包含 false。
如果 flush 為 true，當這個方法傳回時，一律會將此設定為 true。
例外狀況
bytes 包含無法編碼的資料，並將 decoder 設定為在看到此類資料時擲回。
適用於
Convert(Encoder, ReadOnlySequence<Char>, IBufferWriter<Byte>, Boolean, Int64, Boolean)
將 ReadOnlySequence<T> 轉換成編碼的位元組，並將結果寫入到 writer。
public:
[System::Runtime::CompilerServices::Extension]
static void Convert(System::Text::Encoder ^ encoder, System::Buffers::ReadOnlySequence<char> % chars, System::Buffers::IBufferWriter<System::Byte> ^ writer, bool flush, [Runtime::InteropServices::Out] long % bytesUsed, [Runtime::InteropServices::Out] bool % completed);public static void Convert (this System.Text.Encoder encoder, in System.Buffers.ReadOnlySequence<char> chars, System.Buffers.IBufferWriter<byte> writer, bool flush, out long bytesUsed, out bool completed);static member Convert : System.Text.Encoder * ReadOnlySequence * System.Buffers.IBufferWriter<byte> * bool * int64 * bool -> unit<Extension()>
Public Sub Convert (encoder As Encoder, ByRef chars As ReadOnlySequence(Of Char), writer As IBufferWriter(Of Byte), flush As Boolean, ByRef bytesUsed As Long, ByRef completed As Boolean)參數
- encoder
- Encoder
可以將 char 值轉換成位元組的編碼器執行個體。
- chars
- ReadOnlySequence<Char>
要編碼的字元序列。
- writer
- IBufferWriter<Byte>
將寫入編碼位元組的緩衝區。
- flush
- Boolean
true 表示不再轉換任何資料；否則為 false。
- bytesUsed
- Int64
當這個方法傳回時，包含寫入到 writer 的 byte 計數。
- completed
- Boolean
當這個方法傳回時，如果到 bytesUsed 為止的所有輸入都已轉換，即會包含 true，否則會包含 false。 如果 flush 為 true，當這個方法傳回時，一律會將此設定為 true。
例外狀況
chars 包含無法編碼的資料，並將 encoder 設定為在看到此類資料時擲回。
適用於
Convert(Encoder, ReadOnlySpan<Char>, IBufferWriter<Byte>, Boolean, Int64, Boolean)
使用 encoder 來將 ReadOnlySpan<T> 轉換成位元組，並將結果寫入到 writer。
public:
[System::Runtime::CompilerServices::Extension]
static void Convert(System::Text::Encoder ^ encoder, ReadOnlySpan<char> chars, System::Buffers::IBufferWriter<System::Byte> ^ writer, bool flush, [Runtime::InteropServices::Out] long % bytesUsed, [Runtime::InteropServices::Out] bool % completed);public static void Convert (this System.Text.Encoder encoder, ReadOnlySpan<char> chars, System.Buffers.IBufferWriter<byte> writer, bool flush, out long bytesUsed, out bool completed);static member Convert : System.Text.Encoder * ReadOnlySpan<char> * System.Buffers.IBufferWriter<byte> * bool * int64 * bool -> unit<Extension()>
Public Sub Convert (encoder As Encoder, chars As ReadOnlySpan(Of Char), writer As IBufferWriter(Of Byte), flush As Boolean, ByRef bytesUsed As Long, ByRef completed As Boolean)參數
- encoder
- Encoder
可以將 char 值轉換成位元組的編碼器執行個體。
- chars
- ReadOnlySpan<Char>
要編碼的字元序列。
- writer
- IBufferWriter<Byte>
將寫入編碼位元組的緩衝區。
- flush
- Boolean
true 表示不再轉換任何資料；否則為 false。
- bytesUsed
- Int64
當這個方法傳回時，包含寫入到 writer 的 byte 計數。
- completed
- Boolean
當這個方法傳回時，如果 encoder 未包含任何部分內部狀態，即會包含 true，否則會包含 false。
如果 flush 為 true，當這個方法傳回時，一律會將此設定為 true。
例外狀況
chars 包含無法編碼的資料，並將 encoder 設定為在看到此類資料時擲回。
適用於
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應