Utf8JsonWriter.WriteStringValue Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Sobrecargas
| Name | Description |
|---|---|
| WriteStringValue(DateTime) |
Escreve um DateTime valor (como uma string JSON). |
| WriteStringValue(DateTimeOffset) |
Escreve um DateTimeOffset valor (como uma string JSON). |
| WriteStringValue(Guid) |
Escreve um Guid valor (como uma string JSON). |
| WriteStringValue(ReadOnlySpan<Byte>) |
Escreve um valor de texto UTF-8 (como uma string JSON). |
| WriteStringValue(ReadOnlySpan<Char>) |
Escreve um valor de texto UTF-16 (como uma cadeia JSON). |
| WriteStringValue(String) |
Escreve um valor de texto em cadeia (como uma cadeia JSON). |
| WriteStringValue(JsonEncodedText) |
Escreve o valor do texto pré-codificado (como uma cadeia JSON). |
WriteStringValue(DateTime)
Escreve um DateTime valor (como uma string 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
O valor a ser escrito como uma string JSON.
Exceções
A validação está ativada, e a operação resultaria na escrita de JSON inválida.
Observações
Este método escreve usando DateTime o formato estendido ISO 8601-1 (ver suporte DateTimeTime e DateTimeOffset no System.Text.Json); por exemplo, 2017-06-12T05:30:45.7680000.
Aplica-se a
WriteStringValue(DateTimeOffset)
Escreve um DateTimeOffset valor (como uma string 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
O valor a ser escrito como uma string JSON.
Exceções
A validação está ativada, e a operação resultaria na escrita de JSON inválida.
Observações
Este método escreve usando DateTimeOffset o formato estendido ISO 8601-1 (ver suporte DateTimeTime e DateTimeOffset no System.Text.Json); por exemplo, 2017-06-12T05:30:45.7680000-07:00.
Aplica-se a
WriteStringValue(Guid)
Escreve um Guid valor (como uma string 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
O valor a ser escrito como uma string JSON.
Exceções
A validação está ativada, e a operação resultaria na escrita de JSON inválida.
Observações
Este método escreve o Guid valor usando o padrão StandardFormat (isto é, 'D'), como a forma: nnn-n-nn-nn-n.
Aplica-se a
WriteStringValue(ReadOnlySpan<Byte>)
Escreve um valor de texto UTF-8 (como uma string 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>
O valor codificado em UTF-8 para ser escrito como uma string JSON.
Exceções
O valor especificado é demasiado elevado.
A validação está ativada, e a operação de escrita produziria JSON inválido.
Observações
O valor é escapado antes de escrever.
Aplica-se a
WriteStringValue(ReadOnlySpan<Char>)
Escreve um valor de texto UTF-16 (como uma cadeia 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>
O valor codificado em UTF-16 para ser escrito como uma cadeia JSON transcodificada por UTF-8.
Exceções
O valor especificado é demasiado elevado.
A validação está ativada, e a operação de escrita produziria JSON inválido.
Observações
O valor é escapado antes de escrever.
Aplica-se a
WriteStringValue(String)
Escreve um valor de texto em cadeia (como uma cadeia 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
O valor codificado em UTF-16 para ser escrito como uma cadeia JSON transcodificada por UTF-8.
Exceções
O valor especificado é demasiado elevado.
A validação está ativada, e a operação de escrita produziria JSON inválido.
Observações
O valor é escapado antes de escrever.
Se value for null, o valor nulo JSON é escrito, como se o WriteNullValue() método fosse chamado.
Aplica-se a
WriteStringValue(JsonEncodedText)
Escreve o valor do texto pré-codificado (como uma cadeia 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
O valor codificado em JSON para ser escrito como uma cadeia JSON transcodificada por UTF-8.
Exceções
A validação está ativada, e a operação de escrita produziria JSON inválido.
Observações
O valor já deve ter sido escapado quando a instância de JsonEncodedText foi criada.
