Utf8JsonWriter.WriteString Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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)
É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 -> unitPublic 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
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 .
S’applique à
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.
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)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
La valeur spécifiée est trop grande.
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.
S’applique à
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.
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))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
La valeur spécifiée est trop grande.
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.
S’applique à
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.
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))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
La valeur spécifiée est trop grande.
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.
S’applique à
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.
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)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
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 .
S’applique à
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.
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)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
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 .
S’applique à
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.
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)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
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 .
S’applique à
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.
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)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
Le nom de la propriété spécifiée est trop grand.
La validation est activée, et l’opération d’écriture produirait un JSON non valide.
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.
S’applique à
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.
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)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
La taille du nom ou de la valeur de la propriété spécifiée est trop grande.
La validation est activée, et l’opération d’écriture produirait un JSON non valide.
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.
S’applique à
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.
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))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
La taille du nom ou de la valeur de la propriété spécifiée est trop grande.
La validation est activée, et l’opération d’écriture produirait un JSON non valide.
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.
S’applique à
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.
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))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
La taille du nom ou de la valeur de la propriété spécifiée est trop grande.
La validation est activée, et l’opération d’écriture produirait un JSON non valide.
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.
S’applique à
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.
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)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
Le nom de la propriété spécifiée est trop grand.
La validation est activée, et l’opération d’écriture produirait un JSON non valide.
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.
S’applique à
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.
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)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
Le nom de la propriété spécifiée est trop grand.
La validation est activée, et l’opération d’écriture produirait un JSON non valide.
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.
S’applique à
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.
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)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
Le nom de la propriété spécifiée est trop grand.
La validation est activée, et l’opération d’écriture produirait un JSON non valide.
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.
S’applique à
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.
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)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
La taille du nom ou de la valeur de la propriété spécifiée est trop grande.
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.
S’applique à
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.
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)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
Le nom de la propriété spécifiée est trop grand.
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.
S’applique à
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.
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)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
Le nom de la propriété spécifiée est trop grand.
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.
S’applique à
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.
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)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
Le nom de la propriété spécifiée est trop grand.
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.
S’applique à
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.
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))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
La taille du nom ou de la valeur de la propriété spécifiée est trop grande.
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.
S’applique à
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.
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))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
La taille du nom ou de la valeur de la propriété spécifiée est trop grande.
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.
S’applique à
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.
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)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
La taille du nom ou de la valeur de la propriété spécifiée est trop grande.
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.
S’applique à
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.
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)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
Le nom de la propriété spécifiée est trop grand.
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.
S’applique à
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.
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)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
Le nom de la propriété spécifiée est trop grand.
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.
S’applique à
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.
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)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
Le nom de la propriété spécifiée est trop grand.
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.
S’applique à
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.
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)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
Le nom de la propriété spécifiée est trop grand.
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.
S’applique à
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.
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))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
La taille du nom ou de la valeur de la propriété spécifiée est trop grande.
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.
S’applique à
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.
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))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
La taille du nom ou de la valeur de la propriété spécifiée est trop grande.
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.
S’applique à
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.
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)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
Le nom de la propriété spécifiée est trop grand.
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.
