Utf8JsonWriter.WriteString 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 |
|---|---|
| WriteString(JsonEncodedText, JsonEncodedText) |
Escreve o nome da propriedade pré-codificada e o valor pré-codificado (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON. |
| WriteString(JsonEncodedText, String) |
Escreve o nome pré-codificado da propriedade e o valor do texto da cadeia (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON. |
| WriteString(JsonEncodedText, ReadOnlySpan<Char>) |
Escreve o nome da propriedade pré-codificada e o valor do texto (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON. |
| WriteString(JsonEncodedText, ReadOnlySpan<Byte>) |
Escreve o nome pré-codificado da propriedade e o valor do texto UTF-8 (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON. |
| WriteString(JsonEncodedText, Guid) |
Escreve o nome Guid e valor pré-codificados da propriedade (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON. |
| WriteString(JsonEncodedText, DateTimeOffset) |
Escreve o nome DateTimeOffset e valor pré-codificados da propriedade (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON. |
| WriteString(JsonEncodedText, DateTime) |
Escreve o nome DateTime e valor pré-codificados da propriedade (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON. |
| WriteString(String, JsonEncodedText) |
Escreve o nome da propriedade e o valor pré-codificado (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON. |
| WriteString(String, String) |
Escreve um nome de propriedade especificado como uma cadeia e um valor de texto de cadeia (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON. |
| WriteString(String, ReadOnlySpan<Char>) |
Escreve um nome de propriedade especificado como uma cadeia e um valor de texto UTF-16 (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON. |
| WriteString(String, Guid) |
Escreve um nome de propriedade especificado como uma cadeia e um Guid valor (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON. |
| WriteString(String, DateTimeOffset) |
Escreve um nome de propriedade especificado como uma cadeia e um DateTimeOffset valor (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON. |
| WriteString(String, DateTime) |
Escreve um nome de propriedade especificado como uma cadeia e um DateTime valor (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON. |
| WriteString(String, ReadOnlySpan<Byte>) |
Escreve um nome de propriedade especificado como uma cadeia e um valor de texto UTF-8 (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON. |
| WriteString(ReadOnlySpan<Char>, String) |
Escreve um nome de propriedade UTF-16 e um valor de texto em cadeia (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON. |
| WriteString(ReadOnlySpan<Byte>, DateTime) |
Escreve um nome de propriedade UTF-8 e um DateTime valor (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON. |
| WriteString(ReadOnlySpan<Char>, JsonEncodedText) |
Escreve o nome da propriedade e o valor pré-codificado (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON. |
| WriteString(ReadOnlySpan<Byte>, Guid) |
Escreve um nome de propriedade UTF-8 e um Guid valor (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON. |
| WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>) |
Escreve um nome de propriedade UTF-8 e um valor de texto UTF-8 (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON. |
| WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Char>) |
Escreve um nome de propriedade UTF-8 e um valor de texto UTF-16 (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON. |
| WriteString(ReadOnlySpan<Byte>, String) |
Escreve um nome de propriedade UTF-8 e um valor de texto de string (como uma string JSON) como parte de um par nome/valor de um objeto JSON. |
| WriteString(ReadOnlySpan<Byte>, DateTimeOffset) |
Escreve um nome de propriedade UTF-8 e um DateTimeOffset valor (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON. |
| WriteString(ReadOnlySpan<Char>, DateTime) |
Escreve um nome de propriedade especificado como um espaço de caracteres de apenas leitura e um DateTime valor (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON. |
| WriteString(ReadOnlySpan<Char>, DateTimeOffset) |
Escreve um nome de propriedade especificado como um espaço de caracteres de apenas leitura e um DateTimeOffset valor (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON. |
| WriteString(ReadOnlySpan<Char>, Guid) |
Escreve um nome de propriedade especificado como um espaço de caracteres de apenas leitura e um Guid valor (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON. |
| WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Byte>) |
Escreve um nome de propriedade UTF-16 e um valor de texto UTF-8 (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON. |
| WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Char>) |
Escreve um nome de propriedade UTF-16 e um valor de texto UTF-16 (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON. |
| WriteString(ReadOnlySpan<Byte>, JsonEncodedText) |
Escreve o nome da propriedade UTF-8 e o valor pré-codificado (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON. |
WriteString(JsonEncodedText, JsonEncodedText)
Escreve o nome da propriedade pré-codificada e o valor pré-codificado (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
public:
void WriteString(System::Text::Json::JsonEncodedText propertyName, System::Text::Json::JsonEncodedText value);public void WriteString(System.Text.Json.JsonEncodedText propertyName, System.Text.Json.JsonEncodedText value);member this.WriteString : System.Text.Json.JsonEncodedText * System.Text.Json.JsonEncodedText -> unitPublic Sub WriteString (propertyName As JsonEncodedText, value As JsonEncodedText)Parâmetros
- propertyName
- JsonEncodedText
O nome da propriedade codificada JSON do objeto JSON a transcodificar e escrever como UTF-8.
- value
- JsonEncodedText
O valor codificado em JSON para ser escrito como uma cadeia JSON transcodificada por UTF-8 como parte do par nome/valor.
Exceções
A validação está ativada, e a operação de escrita produziria JSON inválido.
Observações
O nome e o valor da propriedade já devem ter sido ignorados quando a instância de JsonEncodedText foi criada.
Aplica-se a
WriteString(JsonEncodedText, String)
Escreve o nome pré-codificado da propriedade e o valor do texto da cadeia (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
public:
void WriteString(System::Text::Json::JsonEncodedText propertyName, System::String ^ value);public void WriteString(System.Text.Json.JsonEncodedText propertyName, string? value);public void WriteString(System.Text.Json.JsonEncodedText propertyName, string value);member this.WriteString : System.Text.Json.JsonEncodedText * string -> unitPublic Sub WriteString (propertyName As JsonEncodedText, value As String)Parâmetros
- propertyName
- JsonEncodedText
O nome da propriedade codificada JSON do objeto JSON a transcodificar e escrever como UTF-8.
- value
- String
O valor a ser escrito como uma cadeia JSON transcodificada por UTF-8 como parte do par nome/valor.
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 nome da propriedade já deve ter sido eliminado quando a instância de JsonEncodedText foi criada.
O valor é escapado antes de escrever.
Se value for null, o valor nulo JSON é escrito, como se o WriteNull(JsonEncodedText) método fosse chamado.
Aplica-se a
WriteString(JsonEncodedText, ReadOnlySpan<Char>)
Escreve o nome da propriedade pré-codificada e o valor do texto (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
public:
void WriteString(System::Text::Json::JsonEncodedText propertyName, ReadOnlySpan<char> value);public void WriteString(System.Text.Json.JsonEncodedText propertyName, ReadOnlySpan<char> value);member this.WriteString : System.Text.Json.JsonEncodedText * ReadOnlySpan<char> -> unitPublic Sub WriteString (propertyName As JsonEncodedText, value As ReadOnlySpan(Of Char))Parâmetros
- propertyName
- JsonEncodedText
O nome da propriedade codificada JSON do objeto JSON a transcodificar e escrever como UTF-8.
- value
- ReadOnlySpan<Char>
O valor a ser escrito como uma cadeia JSON transcodificada por UTF-8 como parte do par nome/valor.
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 nome da propriedade já deve ter sido eliminado quando a instância de JsonEncodedText foi criada.
O valor é escapado antes de escrever.
Se value for null, o valor nulo JSON é escrito, como se o WriteNull(JsonEncodedText) método fosse chamado.
Aplica-se a
WriteString(JsonEncodedText, ReadOnlySpan<Byte>)
Escreve o nome pré-codificado da propriedade e o valor do texto UTF-8 (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
public:
void WriteString(System::Text::Json::JsonEncodedText propertyName, ReadOnlySpan<System::Byte> utf8Value);public void WriteString(System.Text.Json.JsonEncodedText propertyName, ReadOnlySpan<byte> utf8Value);member this.WriteString : System.Text.Json.JsonEncodedText * ReadOnlySpan<byte> -> unitPublic Sub WriteString (propertyName As JsonEncodedText, utf8Value As ReadOnlySpan(Of Byte))Parâmetros
- propertyName
- JsonEncodedText
O nome da propriedade codificada JSON do objeto JSON a transcodificar e escrever como UTF-8.
- utf8Value
- ReadOnlySpan<Byte>
O valor codificado em UTF-8 para ser escrito como uma string JSON como parte do par nome/valor.
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 nome da propriedade já deve ter sido eliminado quando a instância de JsonEncodedText foi criada.
O valor é escapado antes de escrever.
Aplica-se a
WriteString(JsonEncodedText, Guid)
Escreve o nome Guid e valor pré-codificados da propriedade (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
public:
void WriteString(System::Text::Json::JsonEncodedText propertyName, Guid value);public void WriteString(System.Text.Json.JsonEncodedText propertyName, Guid value);member this.WriteString : System.Text.Json.JsonEncodedText * Guid -> unitPublic Sub WriteString (propertyName As JsonEncodedText, value As Guid)Parâmetros
- propertyName
- JsonEncodedText
O nome da propriedade codificada JSON do objeto JSON a transcodificar e escrever como UTF-8.
- value
- Guid
O valor a ser escrito como uma cadeia JSON como parte do par nome/valor.
Exceções
A validação está ativada, e a operação de escrita produziria JSON inválido.
Observações
Escreve usando Guid o padrão StandardFormat (ou seja, 'D'), na forma: nn-nn-nn-nn-n-n.
O nome da propriedade já deve ter sido eliminado quando a instância de JsonEncodedText foi criada.
Aplica-se a
WriteString(JsonEncodedText, DateTimeOffset)
Escreve o nome DateTimeOffset e valor pré-codificados da propriedade (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
public:
void WriteString(System::Text::Json::JsonEncodedText propertyName, DateTimeOffset value);public void WriteString(System.Text.Json.JsonEncodedText propertyName, DateTimeOffset value);member this.WriteString : System.Text.Json.JsonEncodedText * DateTimeOffset -> unitPublic Sub WriteString (propertyName As JsonEncodedText, value As DateTimeOffset)Parâmetros
- propertyName
- JsonEncodedText
O nome da propriedade codificada JSON do objeto JSON a transcodificar e escrever como UTF-8.
- value
- DateTimeOffset
O valor a ser escrito como uma cadeia JSON como parte do par nome/valor.
Exceções
A validação está ativada, e a operação de escrita produziria JSON inválido.
Observações
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.
O nome da propriedade já deve ter sido eliminado quando a instância de JsonEncodedText foi criada.
Aplica-se a
WriteString(JsonEncodedText, DateTime)
Escreve o nome DateTime e valor pré-codificados da propriedade (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
public:
void WriteString(System::Text::Json::JsonEncodedText propertyName, DateTime value);public void WriteString(System.Text.Json.JsonEncodedText propertyName, DateTime value);member this.WriteString : System.Text.Json.JsonEncodedText * DateTime -> unitPublic Sub WriteString (propertyName As JsonEncodedText, value As DateTime)Parâmetros
- propertyName
- JsonEncodedText
O nome da propriedade codificada JSON do objeto JSON a transcodificar e escrever como UTF-8.
- value
- DateTime
O valor a ser escrito como uma cadeia JSON como parte do par nome/valor.
Exceções
A validação está ativada, e a operação de escrita produziria JSON inválido.
Observações
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.
O nome da propriedade já deve ter sido eliminado quando a instância de JsonEncodedText foi criada.
Aplica-se a
WriteString(String, JsonEncodedText)
Escreve o nome da propriedade e o valor pré-codificado (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
public:
void WriteString(System::String ^ propertyName, System::Text::Json::JsonEncodedText value);public void WriteString(string propertyName, System.Text.Json.JsonEncodedText value);member this.WriteString : string * System.Text.Json.JsonEncodedText -> unitPublic Sub WriteString (propertyName As String, value As JsonEncodedText)Parâmetros
- propertyName
- String
O nome da propriedade do objeto JSON a ser transcodificado e escrito como UTF-8.
- value
- JsonEncodedText
O valor codificado em JSON para ser escrito como uma cadeia JSON transcodificada por UTF-8 como parte do par nome/valor.
Exceções
O nome especificado da propriedade é demasiado grande.
A validação está ativada, e a operação de escrita produziria JSON inválido.
O propertyName parâmetro é null.
Observações
O valor já deve ter sido escapado quando a instância de JsonEncodedText foi criada.
O nome da propriedade é ignorado antes de ser escrito.
Aplica-se a
WriteString(String, String)
Escreve um nome de propriedade especificado como uma cadeia e um valor de texto de cadeia (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
public:
void WriteString(System::String ^ propertyName, System::String ^ value);public void WriteString(string propertyName, string? value);public void WriteString(string propertyName, string value);member this.WriteString : string * string -> unitPublic Sub WriteString (propertyName As String, value As String)Parâmetros
- propertyName
- String
O nome da propriedade codificada em UTF-16 do objeto JSON a ser transcodificado e escrito como UTF-8.
- value
- String
O valor codificado em UTF-16 para ser escrito como uma cadeia JSON transcodificada por UTF-8 como parte do par nome/valor.
Exceções
O nome ou valor especificado da propriedade é demasiado elevado.
A validação está ativada, e a operação de escrita produziria JSON inválido.
O propertyName parâmetro é null.
Observações
O nome e o valor da propriedade são ignorados antes de serem escritos.
Se value for null, o valor nulo JSON é escrito, como se o WriteNull(String) método fosse chamado.
Aplica-se a
WriteString(String, ReadOnlySpan<Char>)
Escreve um nome de propriedade especificado como uma cadeia e um valor de texto UTF-16 (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
public:
void WriteString(System::String ^ propertyName, ReadOnlySpan<char> value);public void WriteString(string propertyName, ReadOnlySpan<char> value);member this.WriteString : string * ReadOnlySpan<char> -> unitPublic Sub WriteString (propertyName As String, value As ReadOnlySpan(Of Char))Parâmetros
- propertyName
- String
O nome da propriedade codificada em UTF-16 do objeto JSON a ser transcodificado e escrito como UTF-8.
- value
- ReadOnlySpan<Char>
O valor codificado em UTF-16 para ser escrito como uma cadeia JSON transcodificada por UTF-8 como parte do par nome/valor.
Exceções
O nome ou valor especificado da propriedade é demasiado elevado.
A validação está ativada, e a operação de escrita produziria JSON inválido.
O propertyName parâmetro é null.
Observações
O nome e o valor da propriedade são ignorados antes de serem escritos.
Aplica-se a
WriteString(String, Guid)
Escreve um nome de propriedade especificado como uma cadeia e um Guid valor (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
public:
void WriteString(System::String ^ propertyName, Guid value);public void WriteString(string propertyName, Guid value);member this.WriteString : string * Guid -> unitPublic Sub WriteString (propertyName As String, value As Guid)Parâmetros
- propertyName
- String
O nome da propriedade codificada em UTF-16 do objeto JSON a ser transcodificado e escrito como UTF-8.
- value
- Guid
O valor a ser escrito como uma cadeia JSON como parte do par nome/valor.
Exceções
O nome especificado da propriedade é demasiado grande.
A validação está ativada, e a operação de escrita produziria JSON inválido.
O propertyName parâmetro é null.
Observações
Escreve usando Guid o padrão StandardFormat (ou seja, 'D'), na forma: nn-nn-nn-nn-n-n. O nome da propriedade é ignorado antes de ser escrito.
Aplica-se a
WriteString(String, DateTimeOffset)
Escreve um nome de propriedade especificado como uma cadeia e um DateTimeOffset valor (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
public:
void WriteString(System::String ^ propertyName, DateTimeOffset value);public void WriteString(string propertyName, DateTimeOffset value);member this.WriteString : string * DateTimeOffset -> unitPublic Sub WriteString (propertyName As String, value As DateTimeOffset)Parâmetros
- propertyName
- String
O nome da propriedade codificada em UTF-16 do objeto JSON a ser transcodificado e escrito como UTF-8.
- value
- DateTimeOffset
O valor a ser escrito como uma cadeia JSON como parte do par nome/valor.
Exceções
O nome especificado da propriedade é demasiado grande.
A validação está ativada, e a operação de escrita produziria JSON inválido.
O propertyName parâmetro é null.
Observações
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.
O nome da propriedade é ignorado antes de ser escrito.
Aplica-se a
WriteString(String, DateTime)
Escreve um nome de propriedade especificado como uma cadeia e um DateTime valor (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
public:
void WriteString(System::String ^ propertyName, DateTime value);public void WriteString(string propertyName, DateTime value);member this.WriteString : string * DateTime -> unitPublic Sub WriteString (propertyName As String, value As DateTime)Parâmetros
- propertyName
- String
O nome da propriedade codificada em UTF-16 do objeto JSON a ser transcodificado e escrito como UTF-8.
- value
- DateTime
O valor a ser escrito como uma cadeia JSON como parte do par nome/valor.
Exceções
O nome especificado da propriedade é demasiado grande.
A validação está ativada, e a operação de escrita produziria JSON inválido.
O propertyName parâmetro é null.
Observações
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.
O nome da propriedade é ignorado antes de ser escrito.
Aplica-se a
WriteString(String, ReadOnlySpan<Byte>)
Escreve um nome de propriedade especificado como uma cadeia e um valor de texto UTF-8 (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
public:
void WriteString(System::String ^ propertyName, ReadOnlySpan<System::Byte> utf8Value);public void WriteString(string propertyName, ReadOnlySpan<byte> utf8Value);member this.WriteString : string * ReadOnlySpan<byte> -> unitPublic Sub WriteString (propertyName As String, utf8Value As ReadOnlySpan(Of Byte))Parâmetros
- propertyName
- String
O nome da propriedade codificada em UTF-16 do objeto JSON a ser transcodificado e escrito como UTF-8.
- utf8Value
- ReadOnlySpan<Byte>
O valor codificado em UTF-8 para ser escrito como uma string JSON como parte do par nome/valor.
Exceções
O nome ou valor especificado da propriedade é demasiado elevado.
A validação está ativada, e a operação de escrita produziria JSON inválido.
O propertyName parâmetro é null.
Observações
O nome e o valor da propriedade são ignorados antes de serem escritos.
Aplica-se a
WriteString(ReadOnlySpan<Char>, String)
Escreve um nome de propriedade UTF-16 e um valor de texto em cadeia (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
public:
void WriteString(ReadOnlySpan<char> propertyName, System::String ^ value);public void WriteString(ReadOnlySpan<char> propertyName, string? value);public void WriteString(ReadOnlySpan<char> propertyName, string value);member this.WriteString : ReadOnlySpan<char> * string -> unitPublic Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As String)Parâmetros
- propertyName
- ReadOnlySpan<Char>
O nome da propriedade codificada em UTF-16 do objeto JSON a ser transcodificado e escrito como UTF-8.
- value
- String
O valor codificado em UTF-16 para ser escrito como uma cadeia JSON transcodificada por UTF-8 como parte do par nome/valor.
Exceções
O nome ou valor especificado da propriedade é demasiado elevado.
A validação está ativada, e a operação de escrita produziria JSON inválido.
Observações
O nome e o valor da propriedade são ignorados antes de serem escritos.
Se value for null, o valor nulo JSON é escrito, como se o WriteNull(ReadOnlySpan<Char>) método fosse chamado.
Aplica-se a
WriteString(ReadOnlySpan<Byte>, DateTime)
Escreve um nome de propriedade UTF-8 e um DateTime valor (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
public:
void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, DateTime value);public void WriteString(ReadOnlySpan<byte> utf8PropertyName, DateTime value);member this.WriteString : ReadOnlySpan<byte> * DateTime -> unitPublic Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As DateTime)Parâmetros
- utf8PropertyName
- ReadOnlySpan<Byte>
O nome de propriedade codificado por UTF-8 do objeto JSON a ser escrito.
- value
- DateTime
O valor a ser escrito como uma cadeia JSON como parte do par nome/valor.
Exceções
O nome especificado da propriedade é demasiado grande.
A validação está ativada, e a operação de escrita produziria JSON inválido.
Observações
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.
O nome da propriedade é ignorado antes de ser escrito.
Aplica-se a
WriteString(ReadOnlySpan<Char>, JsonEncodedText)
Escreve o nome da propriedade e o valor pré-codificado (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
public:
void WriteString(ReadOnlySpan<char> propertyName, System::Text::Json::JsonEncodedText value);public void WriteString(ReadOnlySpan<char> propertyName, System.Text.Json.JsonEncodedText value);member this.WriteString : ReadOnlySpan<char> * System.Text.Json.JsonEncodedText -> unitPublic Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As JsonEncodedText)Parâmetros
- propertyName
- ReadOnlySpan<Char>
O nome da propriedade do objeto JSON a ser transcodificado e escrito como UTF-8.
- value
- JsonEncodedText
O valor codificado em JSON para ser escrito como uma cadeia JSON transcodificada por UTF-8 como parte do par nome/valor.
Exceções
O nome especificado da propriedade é demasiado grande.
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.
O nome da propriedade é ignorado antes de ser escrito.
Aplica-se a
WriteString(ReadOnlySpan<Byte>, Guid)
Escreve um nome de propriedade UTF-8 e um Guid valor (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
public:
void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, Guid value);public void WriteString(ReadOnlySpan<byte> utf8PropertyName, Guid value);member this.WriteString : ReadOnlySpan<byte> * Guid -> unitPublic Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As Guid)Parâmetros
- utf8PropertyName
- ReadOnlySpan<Byte>
O nome de propriedade codificado por UTF-8 do objeto JSON a ser escrito.
- value
- Guid
O valor a ser escrito como uma cadeia JSON como parte do par nome/valor.
Exceções
O nome especificado da propriedade é demasiado grande.
A validação está ativada, e a operação de escrita produziria JSON inválido.
Observações
Escreve usando Guid o padrão StandardFormat (ou seja, 'D'), na forma: nn-nn-nn-nn-n-n. O nome da propriedade é ignorado antes de ser escrito.
Aplica-se a
WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)
Escreve um nome de propriedade UTF-8 e um valor de texto UTF-8 (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
public:
void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, ReadOnlySpan<System::Byte> utf8Value);public void WriteString(ReadOnlySpan<byte> utf8PropertyName, ReadOnlySpan<byte> utf8Value);member this.WriteString : ReadOnlySpan<byte> * ReadOnlySpan<byte> -> unitPublic Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), utf8Value As ReadOnlySpan(Of Byte))Parâmetros
- utf8PropertyName
- ReadOnlySpan<Byte>
O nome de propriedade codificado por UTF-8 do objeto JSON a ser escrito.
- utf8Value
- ReadOnlySpan<Byte>
O valor codificado em UTF-8 para ser escrito como uma string JSON como parte do par nome/valor.
Exceções
O nome ou valor especificado da propriedade é demasiado elevado.
A validação está ativada, e a operação de escrita produziria JSON inválido.
Observações
O nome e o valor da propriedade são ignorados antes de serem escritos.
Aplica-se a
WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Char>)
Escreve um nome de propriedade UTF-8 e um valor de texto UTF-16 (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
public:
void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, ReadOnlySpan<char> value);public void WriteString(ReadOnlySpan<byte> utf8PropertyName, ReadOnlySpan<char> value);member this.WriteString : ReadOnlySpan<byte> * ReadOnlySpan<char> -> unitPublic Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As ReadOnlySpan(Of Char))Parâmetros
- utf8PropertyName
- ReadOnlySpan<Byte>
O nome de propriedade codificado por UTF-8 do objeto JSON a ser escrito.
- value
- ReadOnlySpan<Char>
O valor codificado em UTF-16 para ser escrito como uma cadeia JSON transcodificada por UTF-8 como parte do par nome/valor.
Exceções
O nome ou valor especificado da propriedade é demasiado elevado.
A validação está ativada, e a operação de escrita produziria JSON inválido.
Observações
O nome e o valor da propriedade são ignorados antes de serem escritos.
Aplica-se a
WriteString(ReadOnlySpan<Byte>, String)
Escreve um nome de propriedade UTF-8 e um valor de texto de string (como uma string JSON) como parte de um par nome/valor de um objeto JSON.
public:
void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, System::String ^ value);public void WriteString(ReadOnlySpan<byte> utf8PropertyName, string? value);public void WriteString(ReadOnlySpan<byte> utf8PropertyName, string value);member this.WriteString : ReadOnlySpan<byte> * string -> unitPublic Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As String)Parâmetros
- utf8PropertyName
- ReadOnlySpan<Byte>
O nome de propriedade codificado por UTF-8 do objeto JSON a ser escrito.
- value
- String
O valor codificado em UTF-16 para ser escrito como uma cadeia JSON transcodificada por UTF-8 como parte do par nome/valor.
Exceções
O nome ou valor especificado da propriedade é demasiado elevado.
A validação está ativada, e a operação de escrita produziria JSON inválido.
Observações
O nome e o valor da propriedade são ignorados antes de serem escritos.
Se value for null, o valor nulo JSON é escrito, como se o WriteNull(ReadOnlySpan<Byte>) método fosse chamado.
Aplica-se a
WriteString(ReadOnlySpan<Byte>, DateTimeOffset)
Escreve um nome de propriedade UTF-8 e um DateTimeOffset valor (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
public:
void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, DateTimeOffset value);public void WriteString(ReadOnlySpan<byte> utf8PropertyName, DateTimeOffset value);member this.WriteString : ReadOnlySpan<byte> * DateTimeOffset -> unitPublic Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As DateTimeOffset)Parâmetros
- utf8PropertyName
- ReadOnlySpan<Byte>
O nome de propriedade codificado por UTF-8 do objeto JSON a ser escrito.
- value
- DateTimeOffset
O valor a ser escrito como uma cadeia JSON como parte do par nome/valor.
Exceções
O nome especificado da propriedade é demasiado grande.
A validação está ativada, e a operação de escrita produziria JSON inválido.
Observações
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.
O nome da propriedade é ignorado antes de ser escrito.
Aplica-se a
WriteString(ReadOnlySpan<Char>, DateTime)
Escreve um nome de propriedade especificado como um espaço de caracteres de apenas leitura e um DateTime valor (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
public:
void WriteString(ReadOnlySpan<char> propertyName, DateTime value);public void WriteString(ReadOnlySpan<char> propertyName, DateTime value);member this.WriteString : ReadOnlySpan<char> * DateTime -> unitPublic Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As DateTime)Parâmetros
- propertyName
- ReadOnlySpan<Char>
O nome da propriedade codificada em UTF-16 do objeto JSON a ser transcodificado e escrito como UTF-8.
- value
- DateTime
O valor a ser escrito como uma cadeia JSON como parte do par nome/valor.
Exceções
O nome especificado da propriedade é demasiado grande.
A validação está ativada, e a operação de escrita produziria JSON inválido.
Observações
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.
O nome da propriedade é ignorado antes de ser escrito.
Aplica-se a
WriteString(ReadOnlySpan<Char>, DateTimeOffset)
Escreve um nome de propriedade especificado como um espaço de caracteres de apenas leitura e um DateTimeOffset valor (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
public:
void WriteString(ReadOnlySpan<char> propertyName, DateTimeOffset value);public void WriteString(ReadOnlySpan<char> propertyName, DateTimeOffset value);member this.WriteString : ReadOnlySpan<char> * DateTimeOffset -> unitPublic Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As DateTimeOffset)Parâmetros
- propertyName
- ReadOnlySpan<Char>
O nome da propriedade codificada em UTF-16 do objeto JSON a ser transcodificado e escrito como UTF-8.
- value
- DateTimeOffset
O valor a ser escrito como uma cadeia JSON como parte do par nome/valor.
Exceções
O nome especificado da propriedade é demasiado grande.
A validação está ativada, e a operação de escrita produziria JSON inválido.
Observações
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.
O nome da propriedade é ignorado antes de ser escrito.
Aplica-se a
WriteString(ReadOnlySpan<Char>, Guid)
Escreve um nome de propriedade especificado como um espaço de caracteres de apenas leitura e um Guid valor (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
public:
void WriteString(ReadOnlySpan<char> propertyName, Guid value);public void WriteString(ReadOnlySpan<char> propertyName, Guid value);member this.WriteString : ReadOnlySpan<char> * Guid -> unitPublic Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As Guid)Parâmetros
- propertyName
- ReadOnlySpan<Char>
O nome da propriedade codificada em UTF-16 do objeto JSON a ser transcodificado e escrito como UTF-8.
- value
- Guid
O valor a ser escrito como uma cadeia JSON como parte do par nome/valor.
Exceções
O nome especificado da propriedade é demasiado grande.
A validação está ativada, e a operação de escrita produziria JSON inválido.
Observações
Escreve usando Guid o padrão StandardFormat (ou seja, 'D'), na forma: nn-nn-nn-nn-n-n. O nome da propriedade é ignorado antes de ser escrito.
Aplica-se a
WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)
Escreve um nome de propriedade UTF-16 e um valor de texto UTF-8 (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
public:
void WriteString(ReadOnlySpan<char> propertyName, ReadOnlySpan<System::Byte> utf8Value);public void WriteString(ReadOnlySpan<char> propertyName, ReadOnlySpan<byte> utf8Value);member this.WriteString : ReadOnlySpan<char> * ReadOnlySpan<byte> -> unitPublic Sub WriteString (propertyName As ReadOnlySpan(Of Char), utf8Value As ReadOnlySpan(Of Byte))Parâmetros
- propertyName
- ReadOnlySpan<Char>
O nome da propriedade codificada em UTF-16 do objeto JSON a ser transcodificado e escrito como UTF-8.
- utf8Value
- ReadOnlySpan<Byte>
O valor codificado em UTF-8 para ser escrito como uma string JSON como parte do par nome/valor.
Exceções
O nome ou valor especificado da propriedade é demasiado elevado.
A validação está ativada, e a operação de escrita produziria JSON inválido.
Observações
O nome e o valor da propriedade são ignorados antes de serem escritos.
Aplica-se a
WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Char>)
Escreve um nome de propriedade UTF-16 e um valor de texto UTF-16 (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
public:
void WriteString(ReadOnlySpan<char> propertyName, ReadOnlySpan<char> value);public void WriteString(ReadOnlySpan<char> propertyName, ReadOnlySpan<char> value);member this.WriteString : ReadOnlySpan<char> * ReadOnlySpan<char> -> unitPublic Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As ReadOnlySpan(Of Char))Parâmetros
- propertyName
- ReadOnlySpan<Char>
O nome da propriedade codificada em UTF-16 do objeto JSON a ser transcodificado e escrito como UTF-8.
- value
- ReadOnlySpan<Char>
O valor codificado em UTF-16 para ser escrito como uma cadeia JSON transcodificada por UTF-8 como parte do par nome/valor.
Exceções
O nome ou valor especificado da propriedade é demasiado elevado.
A validação está ativada, e a operação de escrita produziria JSON inválido.
Observações
O nome e o valor da propriedade são ignorados antes de serem escritos.
Aplica-se a
WriteString(ReadOnlySpan<Byte>, JsonEncodedText)
Escreve o nome da propriedade UTF-8 e o valor pré-codificado (como uma cadeia JSON) como parte de um par nome/valor de um objeto JSON.
public:
void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, System::Text::Json::JsonEncodedText value);public void WriteString(ReadOnlySpan<byte> utf8PropertyName, System.Text.Json.JsonEncodedText value);member this.WriteString : ReadOnlySpan<byte> * System.Text.Json.JsonEncodedText -> unitPublic Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As JsonEncodedText)Parâmetros
- utf8PropertyName
- ReadOnlySpan<Byte>
O nome de propriedade codificado por UTF-8 do objeto JSON a ser escrito.
- value
- JsonEncodedText
O valor codificado em JSON para ser escrito como uma cadeia JSON transcodificada por UTF-8 como parte do par nome/valor.
Exceções
O nome especificado da propriedade é demasiado grande.
A validação está ativada, e este método resultaria na escrita de JSON inválida.
Observações
O valor já deve ter sido escapado quando a instância de JsonEncodedText foi criada.
O nome da propriedade é ignorado antes de ser escrito.
