JsonSerializer.SerializeToUtf8Bytes 方法

定义

命名空间:

System.Text.Json

程序集:

System.Text.Json.dll

包:

System.Text.Json v9.0.0-preview.3.24172.9

重载

SerializeToUtf8Bytes(Object, JsonTypeInfo)	将提供的值转换为 Byte 数组。
SerializeToUtf8Bytes(Object, Type, JsonSerializerOptions)	将指定类型的值转换为编码为 UTF-8 字节的 JSON 字符串。
SerializeToUtf8Bytes(Object, Type, JsonSerializerContext)	将提供的值转换为 Byte 数组。
SerializeToUtf8Bytes<TValue>(TValue, JsonSerializerOptions)	将泛型类型参数指定的类型的值转换为编码为 UTF-8 字节的 JSON 字符串。
SerializeToUtf8Bytes<TValue>(TValue, JsonTypeInfo<TValue>)	将提供的值转换为 Byte 数组。

SerializeToUtf8Bytes(Object, JsonTypeInfo)

Source:

JsonSerializer.Write.ByteArray.cs

将提供的值转换为 Byte 数组。

public:
 static cli::array <System::Byte> ^ SerializeToUtf8Bytes(System::Object ^ value, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);

public static byte[] SerializeToUtf8Bytes (object? value, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);

static member SerializeToUtf8Bytes : obj * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> byte[]

Public Function SerializeToUtf8Bytes (value As Object, jsonTypeInfo As JsonTypeInfo) As Byte()

参数

value

Object

要转换的值。

jsonTypeInfo

JsonTypeInfo

有关要转换的类型的元数据。

返回

Byte[]

值的 UTF-8 表示形式。

例外

ArgumentNullException

jsonTypeInfo 为 null。

InvalidCastException

value 与 的类型 jsonTypeInfo不匹配。

SerializeToUtf8Bytes(Object, Type, JsonSerializerOptions)

Source:

JsonSerializer.Write.ByteArray.cs

将指定类型的值转换为编码为 UTF-8 字节的 JSON 字符串。

public static byte[] SerializeToUtf8Bytes (object? value, Type inputType, System.Text.Json.JsonSerializerOptions? options = default);

static member SerializeToUtf8Bytes : obj * Type * System.Text.Json.JsonSerializerOptions -> byte[]

Public Function SerializeToUtf8Bytes (value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing) As Byte()

参数

value

Object

要转换的值。

inputType

Type

要转换的 value 的类型。

options

JsonSerializerOptions

用于控制转换行为的选项。

返回

Byte[]

值的 JSON 字符串表示形式，编码为 UTF-8 字节。

例外

ArgumentException

inputType 与 value 不兼容。

ArgumentNullException

inputType 为 null。

NotSupportedException

inputType 或其可序列化成员没有兼容的 JsonConverter。

注解

有关详细信息，请参阅 如何序列化和反序列化 JSON。

SerializeToUtf8Bytes(Object, Type, JsonSerializerContext)

Source:

JsonSerializer.Write.ByteArray.cs

将提供的值转换为 Byte 数组。

public:
 static cli::array <System::Byte> ^ SerializeToUtf8Bytes(System::Object ^ value, Type ^ inputType, System::Text::Json::Serialization::JsonSerializerContext ^ context);

public static byte[] SerializeToUtf8Bytes (object? value, Type inputType, System.Text.Json.Serialization.JsonSerializerContext context);

static member SerializeToUtf8Bytes : obj * Type * System.Text.Json.Serialization.JsonSerializerContext -> byte[]

Public Function SerializeToUtf8Bytes (value As Object, inputType As Type, context As JsonSerializerContext) As Byte()

参数

value

Object

要转换的值。

inputType

Type

要转换的 value 的类型。

context

JsonSerializerContext

可序列化类型的元数据提供程序。

返回

Byte[]

值的 UTF-8 表示形式。

例外

ArgumentException

inputType 与 value 不兼容。

ArgumentNullException

inputType 为 null。

NotSupportedException

inputType 或其可序列化成员没有兼容的 JsonConverter。

InvalidOperationException

GetTypeInfo(Type)提供的 context 方法返回null要转换的类型。

SerializeToUtf8Bytes<TValue>(TValue, JsonSerializerOptions)

Source:

JsonSerializer.Write.ByteArray.cs

将泛型类型参数指定的类型的值转换为编码为 UTF-8 字节的 JSON 字符串。

public static byte[] SerializeToUtf8Bytes<TValue> (TValue value, System.Text.Json.JsonSerializerOptions? options = default);

static member SerializeToUtf8Bytes : 'Value * System.Text.Json.JsonSerializerOptions -> byte[]

Public Function SerializeToUtf8Bytes(Of TValue) (value As TValue, Optional options As JsonSerializerOptions = Nothing) As Byte()

类型参数

TValue

值的类型。

参数

value

TValue

要转换的值。

options

JsonSerializerOptions

用于控制转换行为的选项。

返回

Byte[]

值的 JSON 字符串表示形式，编码为 UTF-8 字节。

例外

NotSupportedException

TValue 或其可序列化成员没有兼容的 JsonConverter。

注解

有关详细信息，请参阅 如何序列化和反序列化 JSON。

SerializeToUtf8Bytes<TValue>(TValue, JsonTypeInfo<TValue>)

Source:

JsonSerializer.Write.ByteArray.cs

将提供的值转换为 Byte 数组。

public:
generic <typename TValue>
 static cli::array <System::Byte> ^ SerializeToUtf8Bytes(TValue value, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);

public static byte[] SerializeToUtf8Bytes<TValue> (TValue value, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);

static member SerializeToUtf8Bytes : 'Value * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> byte[]

Public Function SerializeToUtf8Bytes(Of TValue) (value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue)) As Byte()

类型参数

TValue

要序列化的值的类型。

参数

value

TValue

要转换的值。

jsonTypeInfo

JsonTypeInfo<TValue>

有关要转换的类型的元数据。

返回

Byte[]

值的 UTF-8 表示形式。

例外

NotSupportedException

TValue 或其可序列化成员没有兼容的 JsonConverter。

ArgumentNullException

jsonTypeInfo 为 null。