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)

來源:

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 值時，請勿設定 skipInputValidation 為 true ，因為這可能會造成寫入不正確 JSON，或寫入寫入器實例的整體承載無效。

使用此方法時，輸入內容會依原樣寫入寫入器目的地，除非驗證在啟用時 (失敗) 。

SkipValidation使用此方法時，會接受寫入器實例的值。

Indented使用此方法時，不會套用寫入器實例的 和 Encoder 值。

WriteRawValue(ReadOnlySpan<Char>, Boolean)

來源:

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 值時，請勿設定 skipInputValidation 為 true ，因為這可能會造成寫入不正確 JSON，或寫入寫入器實例的整體承載無效。

使用此方法時，輸入內容會依原樣寫入寫入器目的地，除非驗證在啟用時 (失敗) 。

SkipValidation使用此方法時，會接受寫入器實例的值。

Indented使用此方法時，不會套用寫入器實例的 和 Encoder 值。

WriteRawValue(String, Boolean)

來源:

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 值時，請勿設定 skipInputValidation 為 true ，因為這可能會造成寫入不正確 JSON，或寫入寫入器實例的整體承載無效。

使用此方法時，輸入內容會依原樣寫入寫入器目的地，除非驗證在啟用時 (失敗) 。

SkipValidation使用此方法時，會接受寫入器實例的值。

Indented使用此方法時，不會套用寫入器實例的 和 Encoder 值。

WriteRawValue(ReadOnlySpan<Byte>, Boolean)

來源:

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 值時，請勿設定 skipInputValidation 為 true ，因為這可能會造成寫入的 JSON 無效，或寫入寫入器的整體承載無效。

使用此方法時，輸入內容會依原樣寫入寫入器目的地，除非驗證在啟用時 (失敗) 。

SkipValidation使用此方法時，會接受寫入器實例的值。

Indented使用此方法時，不會套用寫入器實例的 和 Encoder 值。