Utf8JsonWriter.WriteString Méthode

Définition

Espace de noms:

System.Text.Json

Assembly:

System.Text.Json.dll

Paquet:

System.Text.Json v9.0.0-preview.3.24172.9

Surcharges

WriteString(JsonEncodedText, JsonEncodedText)	Écrit le nom de propriété préencodé et la valeur préencodée (sous forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.
WriteString(JsonEncodedText, String)	Écrit le nom de propriété préencodé et la valeur texte de chaîne (sous forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.
WriteString(JsonEncodedText, ReadOnlySpan<Char>)	Écrit le nom de propriété préencodé et la valeur texte (sous forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.
WriteString(JsonEncodedText, ReadOnlySpan<Byte>)	Écrit le nom de propriété préencodé et la valeur texte UTF-8 (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.
WriteString(JsonEncodedText, Guid)	Écrit le nom de propriété préencodé et la valeur Guid (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.
WriteString(JsonEncodedText, DateTimeOffset)	Écrit le nom de propriété préencodé et la valeur DateTimeOffset (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.
WriteString(JsonEncodedText, DateTime)	Écrit le nom de propriété préencodé et la valeur DateTime (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.
WriteString(String, JsonEncodedText)	Écrit le nom de propriété et la valeur préencodée (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.
WriteString(String, String)	Écrit un nom de propriété spécifié sous la forme d’une chaîne et une valeur texte de chaîne (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.
WriteString(String, ReadOnlySpan<Char>)	Écrit un nom de propriété spécifié sous la forme d’une chaîne et une valeur texte UTF-16 (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.
WriteString(String, ReadOnlySpan<Byte>)	Écrit un nom de propriété spécifié sous la forme d’une chaîne et une valeur texte UTF-8 (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.
WriteString(String, DateTimeOffset)	Écrit un nom de propriété spécifié sous la forme d’une chaîne et une valeur DateTimeOffset (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.
WriteString(String, DateTime)	Écrit un nom de propriété spécifié sous la forme d’une chaîne et une valeur DateTime (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.
WriteString(String, Guid)	Écrit un nom de propriété spécifié sous la forme d’une chaîne et une valeur Guid (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.
WriteString(ReadOnlySpan<Char>, String)	Écrit un nom de propriété UTF-16 et une valeur texte de chaîne (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.
WriteString(ReadOnlySpan<Byte>, DateTime)	Écrit un nom de propriété UTF-8 et une valeur DateTime (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.
WriteString(ReadOnlySpan<Byte>, DateTimeOffset)	Écrit un nom de propriété UTF-8 et une valeur DateTimeOffset (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.
WriteString(ReadOnlySpan<Char>, JsonEncodedText)	Écrit le nom de propriété et la valeur préencodée (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.
WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)	Écrit un nom de propriété UTF-8 et une valeur texte UTF-8 (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.
WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Char>)	Écrit un nom de propriété UTF-8 et une valeur texte UTF-16 (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.
WriteString(ReadOnlySpan<Byte>, String)	Écrit un nom de propriété UTF-8 et une valeur texte de chaîne (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.
WriteString(ReadOnlySpan<Byte>, Guid)	Écrit un nom de propriété UTF-8 et une valeur Guid (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.
WriteString(ReadOnlySpan<Char>, DateTime)	Écrit un nom de propriété spécifié sous la forme d’une étendue de caractères en lecture seule et une valeur DateTime (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.
WriteString(ReadOnlySpan<Char>, DateTimeOffset)	Écrit un nom de propriété spécifié sous la forme d’une étendue de caractères en lecture seule et une valeur DateTimeOffset (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.
WriteString(ReadOnlySpan<Char>, Guid)	Écrit un nom de propriété spécifié sous la forme d’une étendue de caractères en lecture seule et une valeur Guid (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.
WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)	Écrit un nom de propriété UTF-16 et une valeur texte UTF-8 (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.
WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	Écrit un nom de propriété UTF-16 et une valeur texte UTF-16 (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.
WriteString(ReadOnlySpan<Byte>, JsonEncodedText)	Écrit le nom de propriété UTF-8 et la valeur préencodée (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.

WriteString(JsonEncodedText, JsonEncodedText)

Source:

Utf8JsonWriter.WriteProperties.String.cs

Écrit le nom de propriété préencodé et la valeur préencodée (sous forme d’une chaîne JSON) dans une paire nom/valeur d’un objet 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)

Paramètres

propertyName

JsonEncodedText

Nom de propriété encodé en JSON de l’objet JSON à transcoder et à écrire au format UTF-8.

value

JsonEncodedText

Valeur encodée en JSON à écrire sous forme de chaîne JSON transcodée en UTF-8 dans la paire nom/valeur.

Exceptions

InvalidOperationException

La validation est activée, et l’opération d’écriture produirait un JSON non valide.

Remarques

Le nom et la valeur de la propriété doivent déjà être placés dans une séquence d’échappement lors de la création de l’instance de JsonEncodedText .

WriteString(JsonEncodedText, String)

Source:

Utf8JsonWriter.WriteProperties.String.cs

Écrit le nom de propriété préencodé et la valeur texte de chaîne (sous forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, System::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)

Paramètres

propertyName

JsonEncodedText

Nom de propriété encodé en JSON de l’objet JSON à transcoder et à écrire au format UTF-8.

value

String

Valeur à écrire sous forme de chaîne JSON transcodée en UTF-8 dans la paire nom/valeur.

Exceptions

ArgumentException

La valeur spécifiée est trop grande.

InvalidOperationException

La validation est activée, et l’opération d’écriture produirait un JSON non valide.

Remarques

Le nom de la propriété doit déjà être placé dans une séquence d’échappement lors de la création de l’instance de JsonEncodedText .

La valeur est placée dans une séquence d’échappement avant l’écriture.

Si value a la valeur null, la valeur NULL JSON est écrite, comme si la WriteNull(JsonEncodedText) méthode était appelée.

WriteString(JsonEncodedText, ReadOnlySpan<Char>)

Source:

Utf8JsonWriter.WriteProperties.String.cs

Écrit le nom de propriété préencodé et la valeur texte (sous forme d’une chaîne JSON) dans une paire nom/valeur d’un objet 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))

Paramètres

propertyName

JsonEncodedText

Nom de propriété encodé en JSON de l’objet JSON à transcoder et à écrire au format UTF-8.

value

ReadOnlySpan<Char>

Valeur à écrire sous forme de chaîne JSON transcodée en UTF-8 dans la paire nom/valeur.

Exceptions

ArgumentException

La valeur spécifiée est trop grande.

InvalidOperationException

La validation est activée, et l’opération d’écriture produirait un JSON non valide.

Remarques

Le nom de la propriété doit déjà être placé dans une séquence d’échappement lors de la création de l’instance de JsonEncodedText .

La valeur est placée dans une séquence d’échappement avant l’écriture.

Si value a la valeur null, la valeur NULL JSON est écrite, comme si la WriteNull(JsonEncodedText) méthode était appelée.

WriteString(JsonEncodedText, ReadOnlySpan<Byte>)

Source:

Utf8JsonWriter.WriteProperties.String.cs

Écrit le nom de propriété préencodé et la valeur texte UTF-8 (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet 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))

Paramètres

propertyName

JsonEncodedText

Nom de propriété encodé en JSON de l’objet JSON à transcoder et à écrire au format UTF-8.

utf8Value

ReadOnlySpan<Byte>

Valeur encodée en UTF-8 à écrire sous la forme d’une chaîne JSON dans la paire nom/valeur.

Exceptions

ArgumentException

La valeur spécifiée est trop grande.

InvalidOperationException

La validation est activée, et l’opération d’écriture produirait un JSON non valide.

Remarques

Le nom de la propriété doit déjà être placé dans une séquence d’échappement lors de la création de l’instance de JsonEncodedText .

La valeur est placée dans une séquence d’échappement avant l’écriture.

WriteString(JsonEncodedText, Guid)

Source:

Utf8JsonWriter.WriteProperties.Guid.cs

Écrit le nom de propriété préencodé et la valeur Guid (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet 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)

Paramètres

propertyName

JsonEncodedText

Nom de propriété encodé en JSON de l’objet JSON à transcoder et à écrire au format UTF-8.

value

Guid

Valeur à écrire sous la forme d’une chaîne JSON dans la paire nom/valeur.

Exceptions

InvalidOperationException

La validation est activée, et l’opération d’écriture produirait un JSON non valide.

Remarques

Écrit le Guid à l’aide de la valeur par défaut StandardFormat (c’est-à-dire , « D »), au format : nnnnnn-nnnn-nnnnnnnnnn.

Le nom de la propriété doit déjà être placé dans une séquence d’échappement lors de la création de l’instance de JsonEncodedText .

WriteString(JsonEncodedText, DateTimeOffset)

Source:

Utf8JsonWriter.WriteProperties.DateTimeOffset.cs

Écrit le nom de propriété préencodé et la valeur DateTimeOffset (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet 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)

Paramètres

propertyName

JsonEncodedText

Nom de propriété encodé en JSON de l’objet JSON à transcoder et à écrire au format UTF-8.

value

DateTimeOffset

Valeur à écrire sous la forme d’une chaîne JSON dans la paire nom/valeur.

Exceptions

InvalidOperationException

La validation est activée, et l’opération d’écriture produirait un JSON non valide.

Remarques

Écrit le DateTimeOffset à l’aide du format étendu ISO 8601-1 (voir Prise en charge de DateTime et DateTimeOffset dans System.Text.Json) ; par exemple, 2017-06-12T05:30:45.76800000-07:00.

Le nom de la propriété doit déjà être placé dans une séquence d’échappement lors de la création de l’instance de JsonEncodedText .

WriteString(JsonEncodedText, DateTime)

Source:

Utf8JsonWriter.WriteProperties.DateTime.cs

Écrit le nom de propriété préencodé et la valeur DateTime (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet 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)

Paramètres

propertyName

JsonEncodedText

Nom de propriété encodé en JSON de l’objet JSON à transcoder et à écrire au format UTF-8.

value

DateTime

Valeur à écrire sous la forme d’une chaîne JSON dans la paire nom/valeur.

Exceptions

InvalidOperationException

La validation est activée, et l’opération d’écriture produirait un JSON non valide.

Remarques

Écrit à l’aide DateTime du format étendu ISO 8601-1 (voir Prise en charge de DateTime et DateTimeOffset dans System.Text.Json) ; par exemple, 2017-06-12T05:30:45.7680000.

Le nom de la propriété doit déjà être placé dans une séquence d’échappement lors de la création de l’instance de JsonEncodedText .

WriteString(String, JsonEncodedText)

Source:

Utf8JsonWriter.WriteProperties.String.cs

Écrit le nom de propriété et la valeur préencodée (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet 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)

Paramètres

propertyName

String

Nom de propriété de l’objet JSON à transcoder et à écrire au format UTF-8.

value

JsonEncodedText

Valeur encodée en JSON à écrire sous forme de chaîne JSON transcodée en UTF-8 dans la paire nom/valeur.

Exceptions

ArgumentException

Le nom de la propriété spécifiée est trop grand.

InvalidOperationException

La validation est activée, et l’opération d’écriture produirait un JSON non valide.

ArgumentNullException

Le paramètre propertyName a la valeur null.

Remarques

La valeur doit déjà être placée dans une séquence d’échappement lors de la création de l’instance de JsonEncodedText .

Le nom de la propriété est placé dans une séquence d’échappement avant l’écriture.

WriteString(String, String)

Source:

Utf8JsonWriter.WriteProperties.String.cs

Écrit un nom de propriété spécifié sous la forme d’une chaîne et une valeur texte de chaîne (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.

public:
 void WriteString(System::String ^ propertyName, System::String ^ value);

public void WriteString (string propertyName, string? value);

member this.WriteString : string * string -> unit

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

Paramètres

propertyName

String

Nom de propriété encodé en UTF-16 de l’objet JSON à transcoder et à écrire au format UTF-8.

value

String

Valeur encodée en UTF-16 à écrire sous la forme d’une chaîne JSON transcodée en UTF-8 dans la paire nom/valeur.

Exceptions

ArgumentException

La taille du nom ou de la valeur de la propriété spécifiée est trop grande.

InvalidOperationException

La validation est activée, et l’opération d’écriture produirait un JSON non valide.

ArgumentNullException

Le paramètre propertyName a la valeur null.

Remarques

Le nom et la valeur de la propriété sont placés dans une séquence d’échappement avant l’écriture.

Si value a la valeur null, la valeur NULL JSON est écrite, comme si la WriteNull(String) méthode était appelée.

WriteString(String, ReadOnlySpan<Char>)

Source:

Utf8JsonWriter.WriteProperties.String.cs

Écrit un nom de propriété spécifié sous la forme d’une chaîne et une valeur texte UTF-16 (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet 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))

Paramètres

propertyName

String

Nom de propriété encodé en UTF-16 de l’objet JSON à transcoder et à écrire au format UTF-8.

value

ReadOnlySpan<Char>

Valeur encodée en UTF-16 à écrire sous la forme d’une chaîne JSON transcodée en UTF-8 dans la paire nom/valeur.

Exceptions

ArgumentException

La taille du nom ou de la valeur de la propriété spécifiée est trop grande.

InvalidOperationException

La validation est activée, et l’opération d’écriture produirait un JSON non valide.

ArgumentNullException

Le paramètre propertyName a la valeur null.

Remarques

Le nom et la valeur de la propriété sont placés dans une séquence d’échappement avant l’écriture.

WriteString(String, ReadOnlySpan<Byte>)

Source:

Utf8JsonWriter.WriteProperties.String.cs

Écrit un nom de propriété spécifié sous la forme d’une chaîne et une valeur texte UTF-8 (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet 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))

Paramètres

propertyName

String

Nom de propriété encodé en UTF-16 de l’objet JSON à transcoder et à écrire au format UTF-8.

utf8Value

ReadOnlySpan<Byte>

Valeur encodée en UTF-8 à écrire sous la forme d’une chaîne JSON dans la paire nom/valeur.

Exceptions

ArgumentException

La taille du nom ou de la valeur de la propriété spécifiée est trop grande.

InvalidOperationException

La validation est activée, et l’opération d’écriture produirait un JSON non valide.

ArgumentNullException

Le paramètre propertyName a la valeur null.

Remarques

Le nom et la valeur de la propriété sont placés dans une séquence d’échappement avant l’écriture.

WriteString(String, DateTimeOffset)

Source:

Utf8JsonWriter.WriteProperties.DateTimeOffset.cs

Écrit un nom de propriété spécifié sous la forme d’une chaîne et une valeur DateTimeOffset (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet 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)

Paramètres

propertyName

String

Nom de propriété encodé en UTF-16 de l’objet JSON à transcoder et à écrire au format UTF-8.

value

DateTimeOffset

Valeur à écrire sous la forme d’une chaîne JSON dans la paire nom/valeur.

Exceptions

ArgumentException

Le nom de la propriété spécifiée est trop grand.

InvalidOperationException

La validation est activée, et l’opération d’écriture produirait un JSON non valide.

ArgumentNullException

Le paramètre propertyName a la valeur null.

Remarques

Écrit à l’aide DateTimeOffset du format étendu ISO 8601-1 (voir Prise en charge de DateTime et DateTimeOffset dans System.Text.Json) ; par exemple, 2017-06-12T05:30:45.7680000-07:00.

Le nom de la propriété est placé dans une séquence d’échappement avant l’écriture.

WriteString(String, DateTime)

Source:

Utf8JsonWriter.WriteProperties.DateTime.cs

Écrit un nom de propriété spécifié sous la forme d’une chaîne et une valeur DateTime (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet 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)

Paramètres

propertyName

String

Nom de propriété encodé en UTF-16 de l’objet JSON à transcoder et à écrire au format UTF-8.

value

DateTime

Valeur à écrire sous la forme d’une chaîne JSON dans la paire nom/valeur.

Exceptions

ArgumentException

Le nom de la propriété spécifiée est trop grand.

InvalidOperationException

La validation est activée, et l’opération d’écriture produirait un JSON non valide.

ArgumentNullException

Le paramètre propertyName a la valeur null.

Remarques

Écrit à l’aide DateTime du format étendu ISO 8601-1 (voir Prise en charge de DateTime et DateTimeOffset dans System.Text.Json) ; par exemple, 2017-06-12T05:30:45.7680000.

Le nom de la propriété est placé dans une séquence d’échappement avant l’écriture.

WriteString(String, Guid)

Source:

Utf8JsonWriter.WriteProperties.Guid.cs

Écrit un nom de propriété spécifié sous la forme d’une chaîne et une valeur Guid (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet 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)

Paramètres

propertyName

String

Nom de propriété encodé en UTF-16 de l’objet JSON à transcoder et à écrire au format UTF-8.

value

Guid

Valeur à écrire sous la forme d’une chaîne JSON dans la paire nom/valeur.

Exceptions

ArgumentException

Le nom de la propriété spécifiée est trop grand.

InvalidOperationException

La validation est activée, et l’opération d’écriture produirait un JSON non valide.

ArgumentNullException

Le paramètre propertyName a la valeur null.

Remarques

Écrit à Guid l’aide de la valeur par défaut StandardFormat (c’est-à-dire « D »), au format : nnnnnn-nnnn-nnnn-nnnnnnnn. Le nom de la propriété est placé dans une séquence d’échappement avant l’écriture.

WriteString(ReadOnlySpan<Char>, String)

Source:

Utf8JsonWriter.WriteProperties.String.cs

Écrit un nom de propriété UTF-16 et une valeur texte de chaîne (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.

public:
 void WriteString(ReadOnlySpan<char> propertyName, System::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)

Paramètres

propertyName

ReadOnlySpan<Char>

Nom de propriété encodé en UTF-16 de l’objet JSON à transcoder et à écrire au format UTF-8.

value

String

Valeur encodée en UTF-16 à écrire sous la forme d’une chaîne JSON transcodée en UTF-8 dans la paire nom/valeur.

Exceptions

ArgumentException

La taille du nom ou de la valeur de la propriété spécifiée est trop grande.

InvalidOperationException

La validation est activée, et l’opération d’écriture produirait un JSON non valide.

Remarques

Le nom et la valeur de la propriété sont placés dans une séquence d’échappement avant l’écriture.

Si value a la valeur null, la valeur NULL JSON est écrite, comme si la WriteNull(ReadOnlySpan<Char>) méthode était appelée.

WriteString(ReadOnlySpan<Byte>, DateTime)

Source:

Utf8JsonWriter.WriteProperties.DateTime.cs

Écrit un nom de propriété UTF-8 et une valeur DateTime (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet 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)

Paramètres

utf8PropertyName

ReadOnlySpan<Byte>

Nom de propriété encodé en UTF-8 de l’objet JSON à écrire.

value

DateTime

Valeur à écrire sous la forme d’une chaîne JSON dans la paire nom/valeur.

Exceptions

ArgumentException

Le nom de la propriété spécifiée est trop grand.

InvalidOperationException

La validation est activée, et l’opération d’écriture produirait un JSON non valide.

Remarques

Écrit à l’aide DateTime du format étendu ISO 8601-1 (voir Prise en charge de DateTime et DateTimeOffset dans System.Text.Json) ; par exemple, 2017-06-12T05:30:45.7680000.

Le nom de la propriété est placé dans une séquence d’échappement avant l’écriture.

WriteString(ReadOnlySpan<Byte>, DateTimeOffset)

Source:

Utf8JsonWriter.WriteProperties.DateTimeOffset.cs

Écrit un nom de propriété UTF-8 et une valeur DateTimeOffset (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet 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)

Paramètres

utf8PropertyName

ReadOnlySpan<Byte>

Nom de propriété encodé en UTF-8 de l’objet JSON à écrire.

value

DateTimeOffset

Valeur à écrire sous la forme d’une chaîne JSON dans la paire nom/valeur.

Exceptions

ArgumentException

Le nom de la propriété spécifiée est trop grand.

InvalidOperationException

La validation est activée, et l’opération d’écriture produirait un JSON non valide.

Remarques

Écrit à l’aide DateTimeOffset du format étendu ISO 8601-1 (voir Prise en charge de DateTime et DateTimeOffset dans System.Text.Json) ; par exemple, 2017-06-12T05:30:45.7680000-07:00.

Le nom de la propriété est placé dans une séquence d’échappement avant l’écriture.

WriteString(ReadOnlySpan<Char>, JsonEncodedText)

Source:

Utf8JsonWriter.WriteProperties.String.cs

Écrit le nom de propriété et la valeur préencodée (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet 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)

Paramètres

propertyName

ReadOnlySpan<Char>

Nom de propriété de l’objet JSON à transcoder et à écrire au format UTF-8.

value

JsonEncodedText

Valeur encodée en JSON à écrire sous forme de chaîne JSON transcodée en UTF-8 dans la paire nom/valeur.

Exceptions

ArgumentException

Le nom de la propriété spécifiée est trop grand.

InvalidOperationException

La validation est activée, et l’opération d’écriture produirait un JSON non valide.

Remarques

La valeur doit déjà être placée dans une séquence d’échappement lors de la création de l’instance de JsonEncodedText .

Le nom de la propriété est placé dans une séquence d’échappement avant l’écriture.

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

Source:

Utf8JsonWriter.WriteProperties.String.cs

Écrit un nom de propriété UTF-8 et une valeur texte UTF-8 (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet 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))

Paramètres

utf8PropertyName

ReadOnlySpan<Byte>

Nom de propriété encodé en UTF-8 de l’objet JSON à écrire.

utf8Value

ReadOnlySpan<Byte>

Valeur encodée en UTF-8 à écrire sous la forme d’une chaîne JSON dans la paire nom/valeur.

Exceptions

ArgumentException

La taille du nom ou de la valeur de la propriété spécifiée est trop grande.

InvalidOperationException

La validation est activée, et l’opération d’écriture produirait un JSON non valide.

Remarques

Le nom et la valeur de la propriété sont placés dans une séquence d’échappement avant l’écriture.

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

Source:

Utf8JsonWriter.WriteProperties.String.cs

Écrit un nom de propriété UTF-8 et une valeur texte UTF-16 (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet 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))

Paramètres

utf8PropertyName

ReadOnlySpan<Byte>

Nom de propriété encodé en UTF-8 de l’objet JSON à écrire.

value

ReadOnlySpan<Char>

Valeur encodée en UTF-16 à écrire sous la forme d’une chaîne JSON transcodée en UTF-8 dans la paire nom/valeur.

Exceptions

ArgumentException

La taille du nom ou de la valeur de la propriété spécifiée est trop grande.

InvalidOperationException

La validation est activée, et l’opération d’écriture produirait un JSON non valide.

Remarques

Le nom et la valeur de la propriété sont placés dans une séquence d’échappement avant l’écriture.

WriteString(ReadOnlySpan<Byte>, String)

Source:

Utf8JsonWriter.WriteProperties.String.cs

Écrit un nom de propriété UTF-8 et une valeur texte de chaîne (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet JSON.

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, System::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)

Paramètres

utf8PropertyName

ReadOnlySpan<Byte>

Nom de propriété encodé en UTF-8 de l’objet JSON à écrire.

value

String

Valeur encodée en UTF-16 à écrire sous la forme d’une chaîne JSON transcodée en UTF-8 dans la paire nom/valeur.

Exceptions

ArgumentException

La taille du nom ou de la valeur de la propriété spécifiée est trop grande.

InvalidOperationException

La validation est activée, et l’opération d’écriture produirait un JSON non valide.

Remarques

Le nom et la valeur de la propriété sont placés dans une séquence d’échappement avant l’écriture.

Si value a la valeur null, la valeur NULL JSON est écrite, comme si la WriteNull(ReadOnlySpan<Byte>) méthode était appelée.

WriteString(ReadOnlySpan<Byte>, Guid)

Source:

Utf8JsonWriter.WriteProperties.Guid.cs

Écrit un nom de propriété UTF-8 et une valeur Guid (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet 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)

Paramètres

utf8PropertyName

ReadOnlySpan<Byte>

Nom de propriété encodé en UTF-8 de l’objet JSON à écrire.

value

Guid

Valeur à écrire sous la forme d’une chaîne JSON dans la paire nom/valeur.

Exceptions

ArgumentException

Le nom de la propriété spécifiée est trop grand.

InvalidOperationException

La validation est activée, et l’opération d’écriture produirait un JSON non valide.

Remarques

Écrit le Guid à l’aide de la valeur par défaut StandardFormat (c’est-à-dire , « D »), au format : nnnnnn-nnnn-nnnnnnnnnn. Le nom de la propriété est placé dans une séquence d’échappement avant l’écriture.

WriteString(ReadOnlySpan<Char>, DateTime)

Source:

Utf8JsonWriter.WriteProperties.DateTime.cs

Écrit un nom de propriété spécifié sous la forme d’une étendue de caractères en lecture seule et une valeur DateTime (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet 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)

Paramètres

propertyName

ReadOnlySpan<Char>

Nom de propriété encodé en UTF-16 de l’objet JSON à transcoder et à écrire au format UTF-8.

value

DateTime

Valeur à écrire sous la forme d’une chaîne JSON dans la paire nom/valeur.

Exceptions

ArgumentException

Le nom de la propriété spécifiée est trop grand.

InvalidOperationException

La validation est activée, et l’opération d’écriture produirait un JSON non valide.

Remarques

Écrit le DateTime à l’aide du format étendu ISO 8601-1 (voir Prise en charge de DateTime et DateTimeOffset dans System.Text.Json) ; par exemple, 2017-06-12T05:30:45.76800000.

Le nom de la propriété est placé dans une séquence d’échappement avant l’écriture.

WriteString(ReadOnlySpan<Char>, DateTimeOffset)

Source:

Utf8JsonWriter.WriteProperties.DateTimeOffset.cs

Écrit un nom de propriété spécifié sous la forme d’une étendue de caractères en lecture seule et une valeur DateTimeOffset (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet 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)

Paramètres

propertyName

ReadOnlySpan<Char>

Nom de propriété encodé en UTF-16 de l’objet JSON à transcoder et à écrire au format UTF-8.

value

DateTimeOffset

Valeur à écrire sous la forme d’une chaîne JSON dans la paire nom/valeur.

Exceptions

ArgumentException

Le nom de la propriété spécifiée est trop grand.

InvalidOperationException

La validation est activée, et l’opération d’écriture produirait un JSON non valide.

Remarques

Écrit le DateTimeOffset à l’aide du format étendu ISO 8601-1 (voir Prise en charge de DateTime et DateTimeOffset dans System.Text.Json) ; par exemple, 2017-06-12T05:30:45.76800000-07:00.

Le nom de la propriété est placé dans une séquence d’échappement avant l’écriture.

WriteString(ReadOnlySpan<Char>, Guid)

Source:

Utf8JsonWriter.WriteProperties.Guid.cs

Écrit un nom de propriété spécifié sous la forme d’une étendue de caractères en lecture seule et une valeur Guid (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet 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)

Paramètres

propertyName

ReadOnlySpan<Char>

Nom de propriété encodé en UTF-16 de l’objet JSON à transcoder et à écrire au format UTF-8.

value

Guid

Valeur à écrire sous la forme d’une chaîne JSON dans la paire nom/valeur.

Exceptions

ArgumentException

Le nom de la propriété spécifiée est trop grand.

InvalidOperationException

La validation est activée, et l’opération d’écriture produirait un JSON non valide.

Remarques

Écrit le Guid à l’aide de la valeur par défaut StandardFormat (c’est-à-dire , « D »), au format : nnnnnn-nnnn-nnnnnnnnnn. Le nom de la propriété est placé dans une séquence d’échappement avant l’écriture.

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

Source:

Utf8JsonWriter.WriteProperties.String.cs

Écrit un nom de propriété UTF-16 et une valeur texte UTF-8 (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet 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))

Paramètres

propertyName

ReadOnlySpan<Char>

Nom de propriété encodé en UTF-16 de l’objet JSON à transcoder et à écrire au format UTF-8.

utf8Value

ReadOnlySpan<Byte>

Valeur encodée en UTF-8 à écrire sous la forme d’une chaîne JSON dans la paire nom/valeur.

Exceptions

ArgumentException

La taille du nom ou de la valeur de la propriété spécifiée est trop grande.

InvalidOperationException

La validation est activée, et l’opération d’écriture produirait un JSON non valide.

Remarques

Le nom et la valeur de la propriété sont placés dans une séquence d’échappement avant l’écriture.

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

Source:

Utf8JsonWriter.WriteProperties.String.cs

Écrit un nom de propriété UTF-16 et une valeur texte UTF-16 (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet 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))

Paramètres

propertyName

ReadOnlySpan<Char>

Nom de propriété encodé en UTF-16 de l’objet JSON à transcoder et à écrire au format UTF-8.

value

ReadOnlySpan<Char>

Valeur encodée en UTF-16 à écrire sous la forme d’une chaîne JSON transcodée en UTF-8 dans la paire nom/valeur.

Exceptions

ArgumentException

La taille du nom ou de la valeur de la propriété spécifiée est trop grande.

InvalidOperationException

La validation est activée, et l’opération d’écriture produirait un JSON non valide.

Remarques

Le nom et la valeur de la propriété sont placés dans une séquence d’échappement avant l’écriture.

WriteString(ReadOnlySpan<Byte>, JsonEncodedText)

Source:

Utf8JsonWriter.WriteProperties.String.cs

Écrit le nom de propriété UTF-8 et la valeur préencodée (sous la forme d’une chaîne JSON) dans une paire nom/valeur d’un objet 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)

Paramètres

utf8PropertyName

ReadOnlySpan<Byte>

Nom de propriété encodé en UTF-8 de l’objet JSON à écrire.

value

JsonEncodedText

Valeur encodée en JSON à écrire sous forme de chaîne JSON transcodée en UTF-8 dans la paire nom/valeur.

Exceptions

ArgumentException

Le nom de la propriété spécifiée est trop grand.

InvalidOperationException

La validation est activée, mais cette méthode entraînerait l’écriture d’un JSON non valide.

Remarques

La valeur doit déjà être placée dans un échappement lors de la création de l’instance de JsonEncodedText .

Le nom de la propriété est placé dans une séquence d’échappement avant l’écriture.