Utf8JsonWriter.WriteRawValue 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
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)
将输入写入 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
跳过验证。
例外
输入的长度为零或等于 Int32.MaxValue。
skipInputValidation
为 false
,根据 JSON RFC ,输入不是有效、完整的单个 JSON 值,或者输入 JSON 超过递归深度 64。
注解
写入不受信任的 JSON 值时,不要将 设置为 skipInputValidation
true
,因为这样可能会导致写入无效的 JSON 或写入编写器实例的总体有效负载无效。
使用此方法时,输入内容将按原样写入编写器目标,除非验证在启用) 时 (失败。
SkipValidation使用此方法时,将遵循编写器实例的值。
Indented使用此方法时,不会应用编写器实例的 和 Encoder 值。
适用于
WriteRawValue(ReadOnlySpan<Char>, Boolean)
将输入写入 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
否则。
例外
输入的长度为零或大于 715,827,882 (Int32.MaxValue / 3) 。
skipInputValidation
为 false
,根据 JSON RFC,输入不是有效、完整的单个 JSON 值,或者输入 JSON 超过递归深度 64。
注解
写入不受信任的 JSON 值时,不要将 设置为 skipInputValidation
true
,因为这样可能会导致写入无效的 JSON 或写入写入器实例的总体有效负载无效。
使用此方法时,输入内容将按原样写入编写器目标,除非验证在启用) 时 (失败。
SkipValidation使用此方法时,将遵循编写器实例的值。
Indented使用此方法时,不会应用编写器实例的 和 Encoder 值。
适用于
WriteRawValue(String, Boolean)
将输入写入 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
否则。
例外
json
为 null
。
输入的长度为零或大于 715,827,882 (Int32.MaxValue / 3) 。
skipInputValidation
为 false
,根据 JSON RFC,输入不是有效、完整的单个 JSON 值,或者输入 JSON 超过递归深度 64。
注解
写入不受信任的 JSON 值时,不要将 设置为 skipInputValidation
true
,因为这样可能会导致写入无效的 JSON 或写入写入器实例的总体有效负载无效。
使用此方法时,输入内容将按原样写入编写器目标,除非验证在启用) 时 (失败。
SkipValidation使用此方法时,将遵循编写器实例的值。
Indented使用此方法时,不会应用编写器实例的 和 Encoder 值。
适用于
WriteRawValue(ReadOnlySpan<Byte>, Boolean)
将输入写入 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
否则。
例外
输入的长度为零或等于 Int32.MaxValue。
skipInputValidation
为 false
,根据 JSON RFC,输入不是有效、完整的单个 JSON 值,或者输入 JSON 超过递归深度 64。
注解
写入不受信任的 JSON 值时,不要将 设置为 skipInputValidation
true
,因为这样可能会导致写入无效的 JSON 或写入编写器的总体有效负载无效。
使用此方法时,输入内容将按原样写入编写器目标,除非验证在启用) 时 (失败。
SkipValidation使用此方法时,将遵循编写器实例的值。
Indented使用此方法时,不会应用编写器实例的 和 Encoder 值。