Utf8JsonWriter.WriteRawValue 方法

定义

命名空间:

System.Text.Json

程序集:

System.Text.Json.dll

包:

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

重载

WriteRawValue(ReadOnlySequence<Byte>, Boolean)	将输入写入 JSON 内容。 输入内容应为单个完整的 JSON 值。
WriteRawValue(ReadOnlySpan<Char>, Boolean)	将输入写入 JSON 内容。 输入内容应为单个完整的 JSON 值。
WriteRawValue(String, Boolean)	将输入写入 JSON 内容。 输入内容应为单个完整的 JSON 值。
WriteRawValue(ReadOnlySpan<Byte>, Boolean)	将输入写入 JSON 内容。 输入内容应为单个完整的 JSON 值。

WriteRawValue(ReadOnlySequence<Byte>, Boolean)

Source:

Utf8JsonWriter.WriteValues.Raw.cs

将输入写入 JSON 内容。 输入内容应为单个完整的 JSON 值。

public void WriteRawValue (System.Buffers.ReadOnlySequence<byte> utf8Json, bool skipInputValidation = false);

member this.WriteRawValue : System.Buffers.ReadOnlySequence<byte> * bool -> unit

Public Sub WriteRawValue (utf8Json As ReadOnlySequence(Of Byte), Optional skipInputValidation As Boolean = false)

参数

utf8Json

ReadOnlySequence<Byte>

要写入的原始 JSON 内容。

skipInputValidation

Boolean

false 验证输入是否为符合 RFC 8259 的 JSON 有效负载; true 跳过验证。

例外

ArgumentException

输入的长度为零或等于 Int32.MaxValue。

JsonException

skipInputValidation 为 false，根据 JSON RFC ，输入不是有效、完整的单个 JSON 值，或者输入 JSON 超过递归深度 64。

注解

写入不受信任的 JSON 值时，不要将 设置为 skipInputValidationtrue ，因为这样可能会导致写入无效的 JSON 或写入编写器实例的总体有效负载无效。

使用此方法时，输入内容将按原样写入编写器目标，除非验证在启用) 时 (失败。

SkipValidation使用此方法时，将遵循编写器实例的值。

Indented使用此方法时，不会应用编写器实例的 和 Encoder 值。

WriteRawValue(ReadOnlySpan<Char>, Boolean)

Source:

Utf8JsonWriter.WriteValues.Raw.cs

将输入写入 JSON 内容。 输入内容应为单个完整的 JSON 值。

public void WriteRawValue (ReadOnlySpan<char> json, bool skipInputValidation = false);

member this.WriteRawValue : ReadOnlySpan<char> * bool -> unit

Public Sub WriteRawValue (json As ReadOnlySpan(Of Char), Optional skipInputValidation As Boolean = false)

参数

json

ReadOnlySpan<Char>

要写入的原始 JSON 内容。

skipInputValidation

Boolean

false 验证输入是否为符合 RFC 8259 的 JSON 有效负载; true 否则。

例外

ArgumentException

输入的长度为零或大于 715，827，882 (Int32.MaxValue / 3) 。

JsonException

skipInputValidation 为 false，根据 JSON RFC，输入不是有效、完整的单个 JSON 值，或者输入 JSON 超过递归深度 64。

注解

写入不受信任的 JSON 值时，不要将 设置为 skipInputValidationtrue ，因为这样可能会导致写入无效的 JSON 或写入写入器实例的总体有效负载无效。

使用此方法时，输入内容将按原样写入编写器目标，除非验证在启用) 时 (失败。

SkipValidation使用此方法时，将遵循编写器实例的值。

Indented使用此方法时，不会应用编写器实例的 和 Encoder 值。

WriteRawValue(String, Boolean)

Source:

Utf8JsonWriter.WriteValues.Raw.cs

将输入写入 JSON 内容。 输入内容应为单个完整的 JSON 值。

public void WriteRawValue (string json, bool skipInputValidation = false);

member this.WriteRawValue : string * bool -> unit

Public Sub WriteRawValue (json As String, Optional skipInputValidation As Boolean = false)

参数

json

String

要写入的原始 JSON 内容。

skipInputValidation

Boolean

false 验证输入是否为符合 RFC 8259 的 JSON 有效负载; true 否则。

例外

ArgumentNullException

json 为 null。

ArgumentException

输入的长度为零或大于 715，827，882 (Int32.MaxValue / 3) 。

JsonException

skipInputValidation 为 false，根据 JSON RFC，输入不是有效、完整的单个 JSON 值，或者输入 JSON 超过递归深度 64。

注解

写入不受信任的 JSON 值时，不要将 设置为 skipInputValidationtrue ，因为这样可能会导致写入无效的 JSON 或写入写入器实例的总体有效负载无效。

使用此方法时，输入内容将按原样写入编写器目标，除非验证在启用) 时 (失败。

SkipValidation使用此方法时，将遵循编写器实例的值。

Indented使用此方法时，不会应用编写器实例的 和 Encoder 值。

WriteRawValue(ReadOnlySpan<Byte>, Boolean)

Source:

Utf8JsonWriter.WriteValues.Raw.cs

将输入写入 JSON 内容。 输入内容应为单个完整的 JSON 值。

public void WriteRawValue (ReadOnlySpan<byte> utf8Json, bool skipInputValidation = false);

member this.WriteRawValue : ReadOnlySpan<byte> * bool -> unit

Public Sub WriteRawValue (utf8Json As ReadOnlySpan(Of Byte), Optional skipInputValidation As Boolean = false)

参数

utf8Json

ReadOnlySpan<Byte>

要写入的原始 JSON 内容。

skipInputValidation

Boolean

false 验证输入是否为符合 RFC 8259 的 JSON 有效负载; true 否则。

例外

ArgumentException

输入的长度为零或等于 Int32.MaxValue。

JsonException

skipInputValidation 为 false，根据 JSON RFC，输入不是有效、完整的单个 JSON 值，或者输入 JSON 超过递归深度 64。

注解

写入不受信任的 JSON 值时，不要将 设置为 skipInputValidationtrue ，因为这样可能会导致写入无效的 JSON 或写入编写器的总体有效负载无效。

使用此方法时，输入内容将按原样写入编写器目标，除非验证在启用) 时 (失败。

SkipValidation使用此方法时，将遵循编写器实例的值。

Indented使用此方法时，不会应用编写器实例的 和 Encoder 值。