Utf8JsonWriter.WriteStringValue Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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)
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);public void WriteStringValue(string value);member this.WriteStringValue : string -> unitPublic 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
El valor especificado es demasiado grande.
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 .
Se aplica a
WriteStringValue(DateTime)
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 -> unitPublic 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
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.
Se aplica a
WriteStringValue(DateTimeOffset)
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 -> unitPublic 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
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.
Se aplica a
WriteStringValue(Guid)
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 -> unitPublic 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
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.
Se aplica a
WriteStringValue(ReadOnlySpan<Byte>)
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> -> unitPublic 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
El valor especificado es demasiado grande.
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.
Se aplica a
WriteStringValue(ReadOnlySpan<Char>)
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> -> unitPublic 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
El valor especificado es demasiado grande.
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.
Se aplica a
WriteStringValue(JsonEncodedText)
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 -> unitPublic 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
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 .
