Utf8JsonWriter.WriteStringValue Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> unitPublic 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 -> unitPublic 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 -> unitPublic 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 -> unitPublic 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> -> unitPublic 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> -> unitPublic 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 -> unitPublic 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.