Partilhar via


Utf8JsonWriter.WriteStringValue Método

Definição

Sobrecargas

WriteStringValue(String)

Grava um valor de texto de cadeia de caracteres (como uma cadeia de caracteres JSON) como um elemento de uma matriz JSON.

WriteStringValue(DateTime)

Grava um valor de DateTime (como uma cadeia de caracteres JSON) como um elemento de uma matriz JSON.

WriteStringValue(DateTimeOffset)

Grava um valor de DateTimeOffset (como uma cadeia de caracteres JSON) como um elemento de uma matriz JSON.

WriteStringValue(Guid)

Grava um valor de Guid (como uma cadeia de caracteres JSON) como um elemento de uma matriz JSON.

WriteStringValue(ReadOnlySpan<Byte>)

Grava um valor de texto UTF-8 (como uma cadeia de caracteres JSON) como um elemento de uma matriz JSON.

WriteStringValue(ReadOnlySpan<Char>)

Grava um valor de texto UTF-16 (como uma cadeia de caracteres JSON) como um elemento de uma matriz JSON.

WriteStringValue(JsonEncodedText)

Grava o valor de texto pré-codificado (como uma cadeia de caracteres JSON) como um elemento de uma matriz JSON.

WriteStringValue(String)

Grava um valor de texto de cadeia de caracteres (como uma cadeia de caracteres JSON) como um elemento de uma matriz JSON.

public:
 void WriteStringValue(System::String ^ value);
public void WriteStringValue (string? value);
public void WriteStringValue (string value);
member this.WriteStringValue : string -> unit
Public Sub WriteStringValue (value As String)

Parâmetros

value
String

O valor codificado em UTF-16 a ser gravado como um elemento de cadeia de caracteres JSON transcodificado em UTF-8 de uma matriz JSON.

Exceções

O valor especificado é muito grande.

A validação está habilitada e a operação de gravação produziria JSON inválido.

Comentários

O valor é escapado antes da gravação.

Se value for null, o valor nulo JSON será gravado, como se o WriteNullValue() método fosse chamado.

Aplica-se a

WriteStringValue(DateTime)

Grava um valor de DateTime (como uma cadeia de caracteres JSON) como um elemento de uma 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

O valor a ser gravado como uma cadeia de caracteres JSON como um elemento de uma matriz JSON.

Exceções

A validação está habilitada e a operação resultaria na escrita de JSON inválido.

Comentários

Esse método grava o DateTime formato estendido ISO 8601-1 (consulte o suporte a DateTime e DateTimeOffset em System.Text.Json); por exemplo, 2017-06-12T05:30:45.76800000.

Aplica-se a

WriteStringValue(DateTimeOffset)

Grava um valor de DateTimeOffset (como uma cadeia de caracteres JSON) como um elemento de uma 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

O valor a ser gravado como uma cadeia de caracteres JSON como um elemento de uma matriz JSON.

Exceções

A validação está habilitada e a operação resultaria na escrita de JSON inválido.

Comentários

Esse método grava o DateTimeOffset formato estendido iso 8601-1 (consulte o suporte a DateTime e DateTimeOffset em System.Text.Json); por exemplo, 2017-06-12T05:30:45.7680000-07:00.

Aplica-se a

WriteStringValue(Guid)

Grava um valor de Guid (como uma cadeia de caracteres JSON) como um elemento de uma 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

O valor a ser gravado como uma cadeia de caracteres JSON como um elemento de uma matriz JSON.

Exceções

A validação está habilitada e a operação resultaria na escrita de JSON inválido.

Comentários

Esse método grava o Guid valor usando o padrão StandardFormat (ou seja, 'D'), como o formulário: nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnnnn.

Aplica-se a

WriteStringValue(ReadOnlySpan<Byte>)

Grava um valor de texto UTF-8 (como uma cadeia de caracteres JSON) como um elemento de uma 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>

O valor codificado em UTF-8 a ser gravado como um elemento de cadeia de caracteres JSON de uma matriz JSON.

Exceções

O valor especificado é muito grande.

A validação está habilitada e a operação de gravação produziria JSON inválido.

Comentários

O valor é escapado antes da gravação.

Aplica-se a

WriteStringValue(ReadOnlySpan<Char>)

Grava um valor de texto UTF-16 (como uma cadeia de caracteres JSON) como um elemento de uma 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>

O valor codificado em UTF-16 a ser gravado como um elemento de cadeia de caracteres JSON transcodificado em UTF-8 de uma matriz JSON.

Exceções

O valor especificado é muito grande.

A validação está habilitada e a operação de gravação produziria JSON inválido.

Comentários

O valor é escapado antes da gravação.

Aplica-se a

WriteStringValue(JsonEncodedText)

Grava o valor de texto pré-codificado (como uma cadeia de caracteres JSON) como um elemento de uma 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

O valor codificado em JSON a ser gravado como um elemento de cadeia de caracteres JSON transcodificado em UTF-8 de uma matriz JSON.

Exceções

A validação está habilitada e a operação de gravação produziria JSON inválido.

Comentários

O valor já deve ser escapado quando a instância foi JsonEncodedText criada.

Aplica-se a