EncodingExtensions.Convert 方法

定義

命名空間:: System.Text

組件:: System.Memory.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

名稱	Description
Convert(Decoder, ReadOnlySequence<Byte>, IBufferWriter<Char>, Boolean, Int64, Boolean)	將 a ReadOnlySequence<T> 轉換為 UTF-16 編碼字元，並將結果寫入 `writer`。
Convert(Decoder, ReadOnlySpan<Byte>, IBufferWriter<Char>, Boolean, Int64, Boolean)	將 a ReadOnlySpan<T> 轉換成字元，並 `decoder` 將結果寫入 `writer`。
Convert(Encoder, ReadOnlySequence<Char>, IBufferWriter<Byte>, Boolean, Int64, Boolean)	將 a ReadOnlySequence<T> 轉換成編碼位元組，並將結果寫入 `writer`。
Convert(Encoder, ReadOnlySpan<Char>, IBufferWriter<Byte>, Boolean, Int64, Boolean)	將 a ReadOnlySpan<T> 轉換為位元組，並 `encoder` 寫入 `writer`。

Convert(Decoder, ReadOnlySequence<Byte>, IBufferWriter<Char>, Boolean, Int64, Boolean)

來源:: EncodingExtensions.cs

來源:: EncodingExtensions.cs

來源:: EncodingExtensions.cs

來源:: EncodingExtensions.cs

來源:: EncodingExtensions.cs

將 a 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

當此方法回傳時，若包含沒有部分內部狀態，則包含truedecoder;否則， false。若 flush ， true則方法返回時，此值將永遠設定為 true 。

例外狀況

DecoderFallbackException

bytes 包含無法解碼的資料，並 decoder 設定在看到此類資料時拋出。

適用於

Convert(Decoder, ReadOnlySpan<Byte>, IBufferWriter<Char>, Boolean, Int64, Boolean)

來源:: EncodingExtensions.cs

來源:: EncodingExtensions.cs

來源:: EncodingExtensions.cs

來源:: EncodingExtensions.cs

來源:: EncodingExtensions.cs

將 a ReadOnlySpan<T> 轉換成字元，並 decoder 將結果寫入 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的 s 計數char。

completed: Boolean

當此方法回傳時，若包含沒有部分內部狀態，則包含truedecoder;否則， false。若 flush ， true則方法返回時，此值將永遠設定為 true 。

例外狀況

DecoderFallbackException

bytes 包含無法編碼的資料，且 decoder 設定在看到此類資料時拋出。

適用於

Convert(Encoder, ReadOnlySequence<Char>, IBufferWriter<Byte>, Boolean, Int64, Boolean)

來源:: EncodingExtensions.cs

來源:: EncodingExtensions.cs

來源:: EncodingExtensions.cs

來源:: EncodingExtensions.cs

來源:: EncodingExtensions.cs

將 a 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的 s 計數byte。

completed: Boolean

當此方法回傳時，包含 true 若所有輸入直到為止 bytesUsed 皆已轉換;否則，則 false。若 flush ， true則方法返回時，此值將永遠設定為 true 。

例外狀況

EncoderFallbackException

chars 包含無法編碼的資料，且 encoder 設定在看到此類資料時拋出。

適用於

Convert(Encoder, ReadOnlySpan<Char>, IBufferWriter<Byte>, Boolean, Int64, Boolean)

來源:: EncodingExtensions.cs

來源:: EncodingExtensions.cs

來源:: EncodingExtensions.cs

來源:: EncodingExtensions.cs

來源:: EncodingExtensions.cs

將 a ReadOnlySpan<T> 轉換為位元組，並 encoder 寫入 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)