Utf8JsonWriter.WriteStringValue Método

Definición

Espacio de nombres:

System.Text.Json

Ensamblado:

System.Text.Json.dll

Paquete:

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

Sobrecargas

WriteStringValue(String)	Escribe el valor de texto de cadena (como una cadena JSON) como elemento de una matriz JSON.
WriteStringValue(DateTime)	Escribe el valor DateTime (como una cadena JSON) como elemento de una matriz JSON.
WriteStringValue(DateTimeOffset)	Escribe el valor DateTimeOffset (como una cadena JSON) como elemento de una matriz JSON.
WriteStringValue(Guid)	Escribe el valor Guid (como una cadena JSON) como elemento de una matriz JSON.
WriteStringValue(ReadOnlySpan<Byte>)	Escribe el valor de texto UTF-8 (como una cadena JSON) como elemento de una matriz JSON.
WriteStringValue(ReadOnlySpan<Char>)	Escribe el valor de texto UTF-16 (como una cadena JSON) como elemento de una matriz JSON.
WriteStringValue(JsonEncodedText)	Escribe el valor de texto codificado previamente (como cadena JSON) como elemento de una matriz JSON.

WriteStringValue(String)

Source:

Utf8JsonWriter.WriteValues.String.cs

Escribe el valor de texto de cadena (como una cadena JSON) como elemento de una matriz JSON.

public:
 void WriteStringValue(System::String ^ value);

public void WriteStringValue (string? value);

member this.WriteStringValue : string -> unit

Public Sub WriteStringValue (value As String)

Parámetros

value

String

Valor con codificación UTF-16 que se va a escribir como un elemento de cadena de JSON transcodificado a UTF-8 de una matriz de JSON.

Excepciones

ArgumentException

El valor especificado es demasiado grande.

InvalidOperationException

La validación está habilitada y la operación de escritura generaría un JSON no válido.

Comentarios

El valor se escapa antes de escribir.

Si value es null, se escribe el valor NULL JSON, como si se llamara al WriteNullValue() método .

WriteStringValue(DateTime)

Source:

Utf8JsonWriter.WriteValues.DateTime.cs

Escribe el valor DateTime (como una cadena JSON) como elemento de una matriz JSON.

public:
 void WriteStringValue(DateTime value);

public void WriteStringValue (DateTime value);

member this.WriteStringValue : DateTime -> unit

Public Sub WriteStringValue (value As DateTime)

Parámetros

value

DateTime

Valor que se va a escribir como una cadena de JSON como un elemento de una matriz de JSON.

Excepciones

InvalidOperationException

La validación está habilitada y la operación daría lugar a la escritura de JSON no válido.

Comentarios

Este método escribe el DateTime mediante el formato extendido ISO 8601-1 (consulte Compatibilidad con DateTime y DateTimeOffset en System.Text.Json); por ejemplo, 2017-06-12T05:30:45.7680000.

WriteStringValue(DateTimeOffset)

Source:

Utf8JsonWriter.WriteValues.DateTimeOffset.cs

Escribe el valor DateTimeOffset (como una cadena JSON) como elemento de una matriz JSON.

public:
 void WriteStringValue(DateTimeOffset value);

public void WriteStringValue (DateTimeOffset value);

member this.WriteStringValue : DateTimeOffset -> unit

Public Sub WriteStringValue (value As DateTimeOffset)

Parámetros

value

DateTimeOffset

Valor que se va a escribir como una cadena de JSON como un elemento de una matriz de JSON.

Excepciones

InvalidOperationException

La validación está habilitada y la operación daría lugar a la escritura de JSON no válido.

Comentarios

Este método escribe el DateTimeOffset uso del formato extendido ISO 8601-1 (consulte compatibilidad con DateTime y DateTimeOffset en System.Text.Json); por ejemplo, 2017-06-12T05:30:45.7680000-07:00.

WriteStringValue(Guid)

Source:

Utf8JsonWriter.WriteValues.Guid.cs

Escribe el valor Guid (como una cadena JSON) como elemento de una matriz JSON.

public:
 void WriteStringValue(Guid value);

public void WriteStringValue (Guid value);

member this.WriteStringValue : Guid -> unit

Public Sub WriteStringValue (value As Guid)

Parámetros

value

Guid

Valor que se va a escribir como una cadena de JSON como un elemento de una matriz de JSON.

Excepciones

InvalidOperationException

La validación está habilitada y la operación daría lugar a la escritura de JSON no válido.

Comentarios

Este método escribe el Guid valor con el valor predeterminado StandardFormat (es decir, 'D'), como el formato: nnnnnnnn-n-n-n-n.

WriteStringValue(ReadOnlySpan<Byte>)

Source:

Utf8JsonWriter.WriteValues.String.cs

Escribe el valor de texto UTF-8 (como una cadena JSON) como elemento de una matriz JSON.

public:
 void WriteStringValue(ReadOnlySpan<System::Byte> utf8Value);

public void WriteStringValue (ReadOnlySpan<byte> utf8Value);

member this.WriteStringValue : ReadOnlySpan<byte> -> unit

Public Sub WriteStringValue (utf8Value As ReadOnlySpan(Of Byte))

Parámetros

utf8Value

ReadOnlySpan<Byte>

El valor con codificación UTF-8 que se va a escribir como un elemento de cadena de JSON de una matriz de JSON.

Excepciones

ArgumentException

El valor especificado es demasiado grande.

InvalidOperationException

La validación está habilitada y la operación de escritura generaría un JSON no válido.

Comentarios

El valor se escapa antes de escribir.

WriteStringValue(ReadOnlySpan<Char>)

Source:

Utf8JsonWriter.WriteValues.String.cs

Escribe el valor de texto UTF-16 (como una cadena JSON) como elemento de una matriz JSON.

public:
 void WriteStringValue(ReadOnlySpan<char> value);

public void WriteStringValue (ReadOnlySpan<char> value);

member this.WriteStringValue : ReadOnlySpan<char> -> unit

Public Sub WriteStringValue (value As ReadOnlySpan(Of Char))

Parámetros

value

ReadOnlySpan<Char>

Valor con codificación UTF-16 que se va a escribir como un elemento de cadena de JSON transcodificado a UTF-8 de una matriz de JSON.

Excepciones

ArgumentException

El valor especificado es demasiado grande.

InvalidOperationException

La validación está habilitada y la operación de escritura generaría un JSON no válido.

Comentarios

El valor se escapa antes de escribir.

WriteStringValue(JsonEncodedText)

Source:

Utf8JsonWriter.WriteValues.String.cs

Escribe el valor de texto codificado previamente (como cadena JSON) como elemento de una matriz JSON.

public:
 void WriteStringValue(System::Text::Json::JsonEncodedText value);

public void WriteStringValue (System.Text.Json.JsonEncodedText value);

member this.WriteStringValue : System.Text.Json.JsonEncodedText -> unit

Public Sub WriteStringValue (value As JsonEncodedText)

Parámetros

value

JsonEncodedText

Valor con codificación JSON que se va a escribir como elemento de cadena JSON transcodificado a UTF-8 de una matriz JSON.

Excepciones

InvalidOperationException

La validación está habilitada y la operación de escritura generaría un JSON no válido.

Comentarios

El valor ya debe ser de escape cuando se creó la instancia de JsonEncodedText .