Utf8JsonWriter.WriteRawValue Method

Definition

Namespace:

System.Text.Json

Assembly:

System.Text.Json.dll

Package:

System.Text.Json v9.0.0-rc.2.24473.5

Overloads

WriteRawValue(ReadOnlySequence<Byte>, Boolean)	Writes the input as JSON content. It is expected that the input content is a single complete JSON value.
WriteRawValue(ReadOnlySpan<Char>, Boolean)	Writes the input as JSON content. It is expected that the input content is a single complete JSON value.
WriteRawValue(String, Boolean)	Writes the input as JSON content. It is expected that the input content is a single complete JSON value.
WriteRawValue(ReadOnlySpan<Byte>, Boolean)	Writes the input as JSON content. It is expected that the input content is a single complete JSON value.

WriteRawValue(ReadOnlySequence<Byte>, Boolean)

Source:

Utf8JsonWriter.WriteValues.Raw.cs

Writes the input as JSON content. It is expected that the input content is a single complete JSON value.

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)

Parameters

utf8Json

ReadOnlySequence<Byte>

The raw JSON content to write.

skipInputValidation

Boolean

false to validate if the input is an RFC 8259-compliant JSON payload; true to skip validation.

Exceptions

ArgumentException

The length of the input is zero or equal to Int32.MaxValue.

JsonException

skipInputValidation is false, and the input is not a valid, complete, single JSON value according to the JSON RFC or the input JSON exceeds a recursive depth of 64.

Remarks

When writing untrusted JSON values, don't set skipInputValidation to true as this can result in invalid JSON being written or an invalid overall payload being written to the writer instance.

When using this method, the input content will be written to the writer destination as-is, unless validation fails (when it is enabled).

The SkipValidation value for the writer instance is honored when using this method.

The Indented and Encoder values for the writer instance are not applied when using this method.

WriteRawValue(ReadOnlySpan<Char>, Boolean)

Source:

Utf8JsonWriter.WriteValues.Raw.cs

Writes the input as JSON content. It is expected that the input content is a single complete JSON value.

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)

Parameters

json

ReadOnlySpan<Char>

The raw JSON content to write.

skipInputValidation

Boolean

false to validate if the input is an RFC 8259-compliant JSON payload; true otherwise.

Exceptions

ArgumentException

The length of the input is zero or greater than 715,827,882 (Int32.MaxValue / 3).

JsonException

skipInputValidation is false, and the input is not a valid, complete, single JSON value according to the JSON RFC, or the input JSON exceeds a recursive depth of 64.

Remarks

When writing untrusted JSON values, do not set skipInputValidation to true as this can result in invalid JSON being written, or an invalid overall payload being written to the writer instance.

When using this method, the input content will be written to the writer destination as-is, unless validation fails (when it is enabled).

The SkipValidation value for the writer instance is honored when using this method.

The Indented and Encoder values for the writer instance are not applied when using this method.

WriteRawValue(String, Boolean)

Source:

Utf8JsonWriter.WriteValues.Raw.cs

Writes the input as JSON content. It is expected that the input content is a single complete JSON value.

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)

Parameters

json

String

The raw JSON content to write.

skipInputValidation

Boolean

false to validate if the input is an RFC 8259-compliant JSON payload; true otherwise.

Exceptions

ArgumentNullException

json is null.

ArgumentException

The length of the input is zero or greater than 715,827,882 (Int32.MaxValue / 3).

JsonException

skipInputValidation is false, and the input is not a valid, complete, single JSON value according to the JSON RFC, or the input JSON exceeds a recursive depth of 64.

Remarks

When writing untrusted JSON values, do not set skipInputValidation to true as this can result in invalid JSON being written, or an invalid overall payload being written to the writer instance.

When using this method, the input content will be written to the writer destination as-is, unless validation fails (when it is enabled).

The SkipValidation value for the writer instance is honored when using this method.

The Indented and Encoder values for the writer instance are not applied when using this method.

WriteRawValue(ReadOnlySpan<Byte>, Boolean)

Source:

Utf8JsonWriter.WriteValues.Raw.cs

Writes the input as JSON content. It is expected that the input content is a single complete JSON value.

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)

Parameters

utf8Json

ReadOnlySpan<Byte>

The raw JSON content to write.

skipInputValidation

Boolean

false to validate if the input is an RFC 8259-compliant JSON payload; true otherwise.

Exceptions

ArgumentException

The length of the input is zero or equal to Int32.MaxValue.

JsonException

skipInputValidation is false, and the input is not a valid, complete, single JSON value according to the JSON RFC, or the input JSON exceeds a recursive depth of 64.

Remarks

When writing untrusted JSON values, do not set skipInputValidation to true as this can result in invalid JSON being written, or an invalid overall payload being written to the writer.

When using this method, the input content will be written to the writer destination as-is, unless validation fails (when it is enabled).

The SkipValidation value for the writer instance is honored when using this method.

The Indented and Encoder values for the writer instance are not applied when using this method.