Utf8JsonWriter.WriteString Método

Referência

Definição

Namespace:: System.Text.Json

Assembly:: System.Text.Json.dll

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

WriteString(JsonEncodedText, JsonEncodedText)	Grava o nome da propriedade pré-codificada e o valor pré-codificado (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(JsonEncodedText, String)	Grava o nome da propriedade pré-codificada e o valor de texto de cadeia de caracteres (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(JsonEncodedText, ReadOnlySpan<Char>)	Grava o nome da propriedade pré-codificada e o valor de texto (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(JsonEncodedText, ReadOnlySpan<Byte>)	Grava o nome da propriedade pré-codificada e o valor de texto UTF-8 (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(JsonEncodedText, Guid)	Grava o nome da propriedade pré-codificada e o valor de Guid (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(JsonEncodedText, DateTimeOffset)	Grava o nome da propriedade pré-codificada e o valor de DateTimeOffset (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(JsonEncodedText, DateTime)	Grava o nome da propriedade pré-codificada e o valor de DateTime (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(String, JsonEncodedText)	Grava o nome da propriedade e o valor pré-codificado (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(String, String)	Grava um nome de propriedade especificado como uma cadeia de caracteres e um valor de texto de cadeia de caracteres (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(String, ReadOnlySpan<Char>)	Grava um nome de propriedade especificado como uma cadeia de caracteres e um valor de texto UTF-16 (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(String, ReadOnlySpan<Byte>)	Grava um nome de propriedade especificado como uma cadeia de caracteres e um valor de texto UTF-8 (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(String, DateTimeOffset)	Grava um nome de propriedade especificado como uma cadeia de caracteres e um valor de DateTimeOffset (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(String, DateTime)	Grava um nome de propriedade especificado como uma cadeia de caracteres e um valor de DateTime (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(String, Guid)	Grava um nome de propriedade especificado como uma cadeia de caracteres e um valor de Guid (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Char>, String)	Grava o nome de uma propriedade UTF-16 e o valor de texto de uma cadeia de caracteres (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Byte>, DateTime)	Grava o nome de uma propriedade UTF-8 e um valor de DateTime (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Byte>, DateTimeOffset)	Grava o nome de uma propriedade UTF-8 e um valor de DateTimeOffset (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Char>, JsonEncodedText)	Grava o nome da propriedade e o valor pré-codificado (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)	Grava o nome de uma propriedade UTF-8 e o valor de texto UTF-8 (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Char>)	Grava o nome de uma propriedade UTF-8 e o valor de texto UTF-16 (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Byte>, String)	Grava o nome de uma propriedade UTF-8 e o valor de texto de uma cadeia de caracteres (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Byte>, Guid)	Grava o nome de uma propriedade UTF-8 e um valor de Guid (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Char>, DateTime)	Grava um nome de propriedade especificado como um intervalo de caracteres somente leitura a um valor de DateTime (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Char>, DateTimeOffset)	Grava um nome de propriedade especificado como um intervalo de caracteres somente leitura a um valor de DateTimeOffset (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Char>, Guid)	Grava um nome de propriedade especificado como um intervalo de caracteres somente leitura a um valor de Guid (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)	Grava o nome de uma propriedade UTF-16 e o valor de texto UTF-8 (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	Grava o nome de uma propriedade UTF-16 e o valor de texto UTF-16 (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.
WriteString(ReadOnlySpan<Byte>, JsonEncodedText)	Grava o nome da propriedade UTF-8 e o valor pré-codificado (como uma cadeia de caracteres JSON) como parte de um par nome/valor de um objeto JSON.

WriteString(JsonEncodedText, JsonEncodedText)

Grava o nome da propriedade pré-codificada e o valor pré-codificado (como uma cadeia de caracteres 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 -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As JsonEncodedText)

Parâmetros

propertyName: JsonEncodedText

O nome da propriedade codificado em JSON do objeto JSON a ser transcodificado e gravado como UTF-8.

value: JsonEncodedText

O valor codificado em JSON a ser gravado como uma cadeia de caracteres JSON transcodificada em UTF-8 como parte do par nome/valor.

Exceções

InvalidOperationException

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

Comentários

O nome e o valor da propriedade já devem ser escapados quando a instância foi JsonEncodedText criada.

Aplica-se a

WriteString(JsonEncodedText, String)

Grava o nome da propriedade pré-codificada e o valor de texto de cadeia de caracteres (como uma cadeia de caracteres 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 -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As String)

Parâmetros

propertyName: JsonEncodedText

O nome da propriedade codificado em JSON do objeto JSON a ser transcodificado e gravado como UTF-8.

value: String

O valor a ser gravado como uma cadeia de caracteres JSON transcodificado em UTF-8 como parte do par nome/valor.

Exceções

ArgumentException

O valor especificado é muito grande.

InvalidOperationException

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

Comentários

O nome da propriedade já deve ser escapado quando a instância foi JsonEncodedText criada.

O valor é escapado antes da gravação.

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

Aplica-se a

WriteString(JsonEncodedText, ReadOnlySpan<Char>)

Grava o nome da propriedade pré-codificada e o valor de texto (como uma cadeia de caracteres 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> -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As ReadOnlySpan(Of Char))

Parâmetros

propertyName: JsonEncodedText

O nome da propriedade codificado em JSON do objeto JSON a ser transcodificado e gravado como UTF-8.

value: ReadOnlySpan<Char>

O valor a ser gravado como uma cadeia de caracteres JSON transcodificado em UTF-8 como parte do par nome/valor.

Exceções

ArgumentException

O valor especificado é muito grande.

InvalidOperationException

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

Comentários

O nome da propriedade já deve ser escapado quando a instância foi JsonEncodedText criada.

O valor é escapado antes da gravação.

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

Aplica-se a

WriteString(JsonEncodedText, ReadOnlySpan<Byte>)

Grava o nome da propriedade pré-codificada e o valor de texto UTF-8 (como uma cadeia de caracteres 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> -> unit

Public Sub WriteString (propertyName As JsonEncodedText, utf8Value As ReadOnlySpan(Of Byte))

Parâmetros

propertyName: JsonEncodedText

O nome da propriedade codificado em JSON do objeto JSON a ser transcodificado e gravado como UTF-8.

utf8Value: ReadOnlySpan<Byte>

O valor codificado em UTF-8 a ser gravado como uma cadeia de caracteres JSON como parte do par nome/valor.

Exceções

ArgumentException

O valor especificado é muito grande.

InvalidOperationException

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

Comentários

O nome da propriedade já deve ser escapado quando a instância foi JsonEncodedText criada.

O valor é escapado antes da gravação.

Aplica-se a

WriteString(JsonEncodedText, Guid)

Grava o nome da propriedade pré-codificada e o valor de Guid (como uma cadeia de caracteres 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 -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As Guid)

Parâmetros

propertyName: JsonEncodedText

O nome da propriedade codificado em JSON do objeto JSON a ser transcodificado e gravado como UTF-8.

value: Guid

O valor a ser gravado como uma cadeia de caracteres JSON como parte do par nome/valor.

Exceções

InvalidOperationException

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

Comentários

Grava o Guid uso do padrão StandardFormat (ou seja, 'D'), na forma: nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnnnn.

O nome da propriedade já deve ser escapado quando a instância foi JsonEncodedText criada.

Aplica-se a

WriteString(JsonEncodedText, DateTimeOffset)

Grava o nome da propriedade pré-codificada e o valor de DateTimeOffset (como uma cadeia de caracteres 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 -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As DateTimeOffset)

Parâmetros

propertyName: JsonEncodedText

O nome da propriedade codificado em JSON do objeto JSON a ser transcodificado e gravado como UTF-8.

value: DateTimeOffset

O valor a ser gravado como uma cadeia de caracteres JSON como parte do par nome/valor.

Exceções

InvalidOperationException

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

Comentários

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.

O nome da propriedade já deve ser escapado quando a instância foi JsonEncodedText criada.

Aplica-se a

WriteString(JsonEncodedText, DateTime)

Grava o nome da propriedade pré-codificada e o valor de DateTime (como uma cadeia de caracteres 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 -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As DateTime)

Parâmetros

propertyName: JsonEncodedText

O nome da propriedade codificado em JSON do objeto JSON a ser transcodificado e gravado como UTF-8.

value: DateTime

O valor a ser gravado como uma cadeia de caracteres JSON como parte do par nome/valor.

Exceções

InvalidOperationException

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

Comentários

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.

O nome da propriedade já deve ser escapado quando a instância foi JsonEncodedText criada.

Aplica-se a

WriteString(String, JsonEncodedText)

Grava o nome da propriedade e o valor pré-codificado (como uma cadeia de caracteres 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 -> unit

Public Sub WriteString (propertyName As String, value As JsonEncodedText)

Parâmetros

propertyName: String

O nome da propriedade do objeto JSON a ser transcodificado e gravado como UTF-8.

value: JsonEncodedText

O valor codificado em JSON a ser gravado como uma cadeia de caracteres JSON transcodificada em UTF-8 como parte do par nome/valor.

Exceções

ArgumentException

O nome da propriedade especificado é muito grande.

InvalidOperationException

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

ArgumentNullException

O parâmetro propertyName é null.

Comentários

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

O nome da propriedade é escapado antes de escrever.

Aplica-se a

WriteString(String, String)

Grava um nome de propriedade especificado como uma cadeia de caracteres e um valor de texto de cadeia de caracteres (como uma cadeia de caracteres 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 -> unit

Public Sub WriteString (propertyName As String, value As String)

Parâmetros

propertyName: String

O nome da propriedade codificado em UTF-16 do objeto JSON a ser transcodificado e gravado como UTF-8.

value: String

O valor codificado em UTF-16 a ser gravado como uma cadeia de caracteres JSON transcodificada em codificado em UTF-8 como parte do par nome/valor.

Exceções

ArgumentException

O nome ou o valor da propriedade especificado é muito grande.

InvalidOperationException

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

ArgumentNullException

O parâmetro propertyName é null.

Comentários

O nome e o valor da propriedade são escapados antes da gravação.

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

Aplica-se a

WriteString(String, ReadOnlySpan<Char>)

Grava um nome de propriedade especificado como uma cadeia de caracteres e um valor de texto UTF-16 (como uma cadeia de caracteres 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> -> unit

Public Sub WriteString (propertyName As String, value As ReadOnlySpan(Of Char))

Parâmetros

propertyName: String

O nome da propriedade codificado em UTF-16 do objeto JSON a ser transcodificado e gravado como UTF-8.

value: ReadOnlySpan<Char>

O valor codificado em UTF-16 a ser gravado como uma cadeia de caracteres JSON transcodificada em codificado em UTF-8 como parte do par nome/valor.

Exceções

ArgumentException

O nome ou o valor da propriedade especificado é muito grande.

InvalidOperationException

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

ArgumentNullException

O parâmetro propertyName é null.

Comentários

O nome e o valor da propriedade são escapados antes da gravação.

Aplica-se a

WriteString(String, ReadOnlySpan<Byte>)

Grava um nome de propriedade especificado como uma cadeia de caracteres e um valor de texto UTF-8 (como uma cadeia de caracteres 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> -> unit

Public Sub WriteString (propertyName As String, utf8Value As ReadOnlySpan(Of Byte))

Parâmetros

propertyName: String

O nome da propriedade codificado em UTF-16 do objeto JSON a ser transcodificado e gravado como UTF-8.

utf8Value: ReadOnlySpan<Byte>

O valor codificado em UTF-8 a ser gravado como uma cadeia de caracteres JSON como parte do par nome/valor.

Exceções

ArgumentException

O nome ou o valor da propriedade especificado é muito grande.

InvalidOperationException

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

ArgumentNullException

O parâmetro propertyName é null.

Comentários

O nome e o valor da propriedade são escapados antes da gravação.

Aplica-se a

WriteString(String, DateTimeOffset)

Grava um nome de propriedade especificado como uma cadeia de caracteres e um valor de DateTimeOffset (como uma cadeia de caracteres 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 -> unit

Public Sub WriteString (propertyName As String, value As DateTimeOffset)

Parâmetros

propertyName: String

O nome da propriedade codificado em UTF-16 do objeto JSON a ser transcodificado e gravado como UTF-8.

value: DateTimeOffset

O valor a ser gravado como uma cadeia de caracteres JSON como parte do par nome/valor.

Exceções

ArgumentException

O nome da propriedade especificado é muito grande.

InvalidOperationException

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

ArgumentNullException

O parâmetro propertyName é null.

Comentários

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.

O nome da propriedade é escapado antes de escrever.

Aplica-se a

WriteString(String, DateTime)

Grava um nome de propriedade especificado como uma cadeia de caracteres e um valor de DateTime (como uma cadeia de caracteres 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 -> unit

Public Sub WriteString (propertyName As String, value As DateTime)

Parâmetros

propertyName: String

O nome da propriedade codificado em UTF-16 do objeto JSON a ser transcodificado e gravado como UTF-8.

value: DateTime

O valor a ser gravado como uma cadeia de caracteres JSON como parte do par nome/valor.

Exceções

ArgumentException

O nome da propriedade especificado é muito grande.

InvalidOperationException

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

ArgumentNullException

O parâmetro propertyName é null.

Comentários

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.

O nome da propriedade é escapado antes de escrever.

Aplica-se a

WriteString(String, Guid)

Grava um nome de propriedade especificado como uma cadeia de caracteres e um valor de Guid (como uma cadeia de caracteres 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 -> unit

Public Sub WriteString (propertyName As String, value As Guid)

Parâmetros

propertyName: String

O nome da propriedade codificado em UTF-16 do objeto JSON a ser transcodificado e gravado como UTF-8.

value: Guid

O valor a ser gravado como uma cadeia de caracteres JSON como parte do par nome/valor.

Exceções

ArgumentException

O nome da propriedade especificado é muito grande.

InvalidOperationException

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

ArgumentNullException

O parâmetro propertyName é null.

Comentários

Grava o Guid uso do padrão StandardFormat (ou seja, 'D'), na forma: nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnnnn. O nome da propriedade é escapado antes de escrever.

Aplica-se a

WriteString(ReadOnlySpan<Char>, String)

Grava o nome de uma propriedade UTF-16 e o valor de texto de uma cadeia de caracteres (como uma cadeia de caracteres 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 -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As String)

Parâmetros

propertyName: ReadOnlySpan<Char>

O nome da propriedade codificado em UTF-16 do objeto JSON a ser transcodificado e gravado como UTF-8.

value: String

O valor codificado em UTF-16 a ser gravado como uma cadeia de caracteres JSON transcodificada em codificado em UTF-8 como parte do par nome/valor.

Exceções

ArgumentException

O nome ou o valor da propriedade especificado é muito grande.

InvalidOperationException

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

Comentários

O nome e o valor da propriedade são escapados antes da gravação.

Se value for null, o valor nulo JSON será gravado, como se o WriteNull(ReadOnlySpan<Char>) método fosse chamado.

Aplica-se a

WriteString(ReadOnlySpan<Byte>, DateTime)

Grava o nome de uma propriedade UTF-8 e um valor de DateTime (como uma cadeia de caracteres 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 -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As DateTime)

Parâmetros

utf8PropertyName: ReadOnlySpan<Byte>

O nome da propriedade codificado em UTF-8 do objeto JSON a ser gravado.

value: DateTime

O valor a ser gravado como uma cadeia de caracteres JSON como parte do par nome/valor.

Exceções

ArgumentException

O nome da propriedade especificado é muito grande.

InvalidOperationException

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

Comentários

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.

O nome da propriedade é escapado antes de escrever.

Aplica-se a

WriteString(ReadOnlySpan<Byte>, DateTimeOffset)

Grava o nome de uma propriedade UTF-8 e um valor de DateTimeOffset (como uma cadeia de caracteres 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 -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As DateTimeOffset)

Parâmetros

utf8PropertyName: ReadOnlySpan<Byte>

O nome da propriedade codificado em UTF-8 do objeto JSON a ser gravado.

value: DateTimeOffset

O valor a ser gravado como uma cadeia de caracteres JSON como parte do par nome/valor.

Exceções

ArgumentException

O nome da propriedade especificado é muito grande.

InvalidOperationException

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

Comentários

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.

O nome da propriedade é escapado antes de escrever.

Aplica-se a

WriteString(ReadOnlySpan<Char>, JsonEncodedText)

Grava o nome da propriedade e o valor pré-codificado (como uma cadeia de caracteres 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 -> unit

Public 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 gravado como UTF-8.

value: JsonEncodedText

O valor codificado em JSON a ser gravado como uma cadeia de caracteres JSON transcodificada em UTF-8 como parte do par nome/valor.

Exceções

ArgumentException

O nome da propriedade especificado é muito grande.

InvalidOperationException

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.

O nome da propriedade é escapado antes de escrever.

Aplica-se a

WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)

Grava o nome de uma propriedade UTF-8 e o valor de texto UTF-8 (como uma cadeia de caracteres 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> -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), utf8Value As ReadOnlySpan(Of Byte))

Parâmetros

utf8PropertyName: ReadOnlySpan<Byte>

O nome da propriedade codificado em UTF-8 do objeto JSON a ser gravado.

utf8Value: ReadOnlySpan<Byte>

O valor codificado em UTF-8 a ser gravado como uma cadeia de caracteres JSON como parte do par nome/valor.

Exceções

ArgumentException

O nome ou o valor da propriedade especificado é muito grande.

InvalidOperationException

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

Comentários

O nome e o valor da propriedade são escapados antes da gravação.

Aplica-se a

WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Char>)

Grava o nome de uma propriedade UTF-8 e o valor de texto UTF-16 (como uma cadeia de caracteres 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> -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As ReadOnlySpan(Of Char))

Parâmetros

utf8PropertyName: ReadOnlySpan<Byte>

O nome da propriedade codificado em UTF-8 do objeto JSON a ser gravado.

value: ReadOnlySpan<Char>

O valor codificado em UTF-16 a ser gravado como uma cadeia de caracteres JSON transcodificada em codificado em UTF-8 como parte do par nome/valor.

Exceções

ArgumentException

O nome ou o valor da propriedade especificado é muito grande.

InvalidOperationException

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

Comentários

O nome e o valor da propriedade são escapados antes da gravação.

Aplica-se a

WriteString(ReadOnlySpan<Byte>, String)

Grava o nome de uma propriedade UTF-8 e o valor de texto de uma cadeia de caracteres (como uma cadeia de caracteres 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 -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As String)

Parâmetros

utf8PropertyName: ReadOnlySpan<Byte>

O nome da propriedade codificado em UTF-8 do objeto JSON a ser gravado.

value: String

O valor codificado em UTF-16 a ser gravado como uma cadeia de caracteres JSON transcodificada em codificado em UTF-8 como parte do par nome/valor.

Exceções

ArgumentException

O nome ou o valor da propriedade especificado é muito grande.

InvalidOperationException

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

Comentários

O nome e o valor da propriedade são escapados antes da gravação.

Se value for null, o valor nulo JSON será gravado, como se o WriteNull(ReadOnlySpan<Byte>) método fosse chamado.

Aplica-se a

WriteString(ReadOnlySpan<Byte>, Guid)

Grava o nome de uma propriedade UTF-8 e um valor de Guid (como uma cadeia de caracteres 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 -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As Guid)

Parâmetros

utf8PropertyName: ReadOnlySpan<Byte>

O nome da propriedade codificado em UTF-8 do objeto JSON a ser gravado.

value: Guid

O valor a ser gravado como uma cadeia de caracteres JSON como parte do par nome/valor.

Exceções

ArgumentException

O nome da propriedade especificado é muito grande.

InvalidOperationException

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

Comentários

Grava o Guid uso do padrão StandardFormat (ou seja, 'D'), na forma: nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnnnn. O nome da propriedade é escapado antes de escrever.

Aplica-se a

WriteString(ReadOnlySpan<Char>, DateTime)

Grava um nome de propriedade especificado como um intervalo de caracteres somente leitura a um valor de DateTime (como uma cadeia de caracteres 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 -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As DateTime)

Parâmetros

propertyName: ReadOnlySpan<Char>

O nome da propriedade codificado em UTF-16 do objeto JSON a ser transcodificado e gravado como UTF-8.

value: DateTime

O valor a ser gravado como uma cadeia de caracteres JSON como parte do par nome/valor.

Exceções

ArgumentException

O nome da propriedade especificado é muito grande.

InvalidOperationException

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

Comentários

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.

O nome da propriedade é escapado antes de escrever.

Aplica-se a

WriteString(ReadOnlySpan<Char>, DateTimeOffset)

Grava um nome de propriedade especificado como um intervalo de caracteres somente leitura a um valor de DateTimeOffset (como uma cadeia de caracteres 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 -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As DateTimeOffset)

Parâmetros

propertyName: ReadOnlySpan<Char>

O nome da propriedade codificado em UTF-16 do objeto JSON a ser transcodificado e gravado como UTF-8.

value: DateTimeOffset

O valor a ser gravado como uma cadeia de caracteres JSON como parte do par nome/valor.

Exceções

ArgumentException

O nome da propriedade especificado é muito grande.

InvalidOperationException

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

Comentários

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.

O nome da propriedade é escapado antes de escrever.

Aplica-se a

WriteString(ReadOnlySpan<Char>, Guid)

Grava um nome de propriedade especificado como um intervalo de caracteres somente leitura a um valor de Guid (como uma cadeia de caracteres 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 -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As Guid)

Parâmetros

propertyName: ReadOnlySpan<Char>

O nome da propriedade codificado em UTF-16 do objeto JSON a ser transcodificado e gravado como UTF-8.

value: Guid

O valor a ser gravado como uma cadeia de caracteres JSON como parte do par nome/valor.

Exceções

ArgumentException

O nome da propriedade especificado é muito grande.

InvalidOperationException

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

Comentários

Grava o Guid uso do padrão StandardFormat (ou seja, 'D'), na forma: nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnnnn. O nome da propriedade é escapado antes de escrever.

Aplica-se a

WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)

Grava o nome de uma propriedade UTF-16 e o valor de texto UTF-8 (como uma cadeia de caracteres 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> -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), utf8Value As ReadOnlySpan(Of Byte))

Parâmetros

propertyName: ReadOnlySpan<Char>

O nome da propriedade codificado em UTF-16 do objeto JSON a ser transcodificado e gravado como UTF-8.

utf8Value: ReadOnlySpan<Byte>

O valor codificado em UTF-8 a ser gravado como uma cadeia de caracteres JSON como parte do par nome/valor.

Exceções

ArgumentException

O nome ou o valor da propriedade especificado é muito grande.

InvalidOperationException

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

Comentários

O nome e o valor da propriedade são escapados antes da gravação.

Aplica-se a

WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Char>)

Grava o nome de uma propriedade UTF-16 e o valor de texto UTF-16 (como uma cadeia de caracteres 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> -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As ReadOnlySpan(Of Char))

Parâmetros

propertyName: ReadOnlySpan<Char>

O nome da propriedade codificado em UTF-16 do objeto JSON a ser transcodificado e gravado como UTF-8.

value: ReadOnlySpan<Char>

O valor codificado em UTF-16 a ser gravado como uma cadeia de caracteres JSON transcodificada em codificado em UTF-8 como parte do par nome/valor.

Exceções

ArgumentException

O nome ou o valor da propriedade especificado é muito grande.

InvalidOperationException

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

Comentários

O nome e o valor da propriedade são escapados antes da gravação.

Aplica-se a

WriteString(ReadOnlySpan<Byte>, JsonEncodedText)

Grava o nome da propriedade UTF-8 e o valor pré-codificado (como uma cadeia de caracteres 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 -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As JsonEncodedText)

Parâmetros

utf8PropertyName: ReadOnlySpan<Byte>

O nome da propriedade codificado em UTF-8 do objeto JSON a ser gravado.

value: JsonEncodedText

O valor codificado em JSON a ser gravado como uma cadeia de caracteres JSON transcodificada em UTF-8 como parte do par nome/valor.

Exceções

ArgumentException

O nome da propriedade especificado é muito grande.

InvalidOperationException

A validação está habilitada, e este método resultaria na escrita de JSON inválido.

Comentários

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

O nome da propriedade é escapado antes de escrever.

Aplica-se a

Partilhar via

Utf8JsonWriter.WriteString Método

Definição

Sobrecargas

WriteString(JsonEncodedText, JsonEncodedText)

Parâmetros

Exceções

Comentários

Aplica-se a

WriteString(JsonEncodedText, String)

Parâmetros

Exceções

Comentários

Aplica-se a

WriteString(JsonEncodedText, ReadOnlySpan<Char>)

Parâmetros

Exceções

Comentários

Aplica-se a

WriteString(JsonEncodedText, ReadOnlySpan<Byte>)

Parâmetros

Exceções

Comentários

Aplica-se a

WriteString(JsonEncodedText, Guid)

Parâmetros

Exceções

Comentários

Aplica-se a

WriteString(JsonEncodedText, DateTimeOffset)

Parâmetros

Exceções

Comentários

Aplica-se a

WriteString(JsonEncodedText, DateTime)

Parâmetros

Exceções

Comentários

Aplica-se a

WriteString(String, JsonEncodedText)

Parâmetros

Exceções

Comentários

Aplica-se a

WriteString(String, String)

Parâmetros

Exceções

Comentários

Aplica-se a

WriteString(String, ReadOnlySpan<Char>)

Parâmetros

Exceções

Comentários

Aplica-se a

WriteString(String, ReadOnlySpan<Byte>)

Parâmetros

Exceções

Comentários

Aplica-se a

WriteString(String, DateTimeOffset)

Parâmetros

Exceções

Comentários

Aplica-se a

WriteString(String, DateTime)

Parâmetros

Exceções

Comentários

Aplica-se a

WriteString(String, Guid)

Parâmetros

Exceções

Comentários

Aplica-se a

WriteString(ReadOnlySpan<Char>, String)

Parâmetros

Exceções

Comentários

Aplica-se a

WriteString(ReadOnlySpan<Byte>, DateTime)