EncodingExtensions.Convert 方法

定义

命名空间:

System.Text

程序集:

System.Memory.dll

重载

Convert(Decoder, ReadOnlySequence<Byte>, IBufferWriter<Char>, Boolean, Int64, Boolean)	将 ReadOnlySequence<T> 转换为 UTF-16 编码字符，并将结果写入 writer。
Convert(Decoder, ReadOnlySpan<Byte>, IBufferWriter<Char>, Boolean, Int64, Boolean)	使用 decoder 将 ReadOnlySpan<T> 转换为字符，并将结果写入 writer。
Convert(Encoder, ReadOnlySequence<Char>, IBufferWriter<Byte>, Boolean, Int64, Boolean)	将 ReadOnlySequence<T> 转换为已编码的字节，并将结果写入 writer。
Convert(Encoder, ReadOnlySpan<Char>, IBufferWriter<Byte>, Boolean, Int64, Boolean)	使用 encoder 将 ReadOnlySpan<T> 转换为字节，并将结果写入 writer。

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。

例外

DecoderFallbackException

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。

例外

DecoderFallbackException

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。

例外

EncoderFallbackException

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。

例外

EncoderFallbackException

chars 包含无法编码的数据，encoder 配置为在显示此类数据时引发。