Utf8JsonWriter.WriteStringValue 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
| WriteStringValue(String) |
Écrit une valeur texte de chaîne (sous la forme d’une chaîne JSON) comme élément d’un tableau JSON. |
| WriteStringValue(DateTime) |
Écrit une valeur DateTime (sous la forme d’une chaîne JSON) comme élément d’un tableau JSON. |
| WriteStringValue(DateTimeOffset) |
Écrit une valeur DateTimeOffset (sous la forme d’une chaîne JSON) comme élément d’un tableau JSON. |
| WriteStringValue(Guid) |
Écrit une valeur Guid (sous la forme d’une chaîne JSON) comme élément d’un tableau JSON. |
| WriteStringValue(ReadOnlySpan<Byte>) |
Écrit une valeur texte UTF-8 (sous la forme d’une chaîne JSON) comme élément d’un tableau JSON. |
| WriteStringValue(ReadOnlySpan<Char>) |
Écrit une valeur texte UTF-16 (sous la forme d’une chaîne JSON) comme élément d’un tableau JSON. |
| WriteStringValue(JsonEncodedText) |
Écrit la valeur texte préencodée (sous la forme d’une chaîne JSON) comme élément d’un tableau JSON. |
WriteStringValue(String)
Écrit une valeur texte de chaîne (sous la forme d’une chaîne JSON) comme élément d’un tableau JSON.
public:
void WriteStringValue(System::String ^ value);public void WriteStringValue (string? value);public void WriteStringValue (string value);member this.WriteStringValue : string -> unitPublic Sub WriteStringValue (value As String)Paramètres
- value
- String
Valeur encodée en UTF-16 à écrire sous la forme d’un élément de chaîne JSON encodé en UTF-8 d’un tableau JSON.
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
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 WriteNullValue() méthode était appelée.
S’applique à
WriteStringValue(DateTime)
Écrit une valeur DateTime (sous la forme d’une chaîne JSON) comme élément d’un tableau JSON.
public:
void WriteStringValue(DateTime value);public void WriteStringValue (DateTime value);member this.WriteStringValue : DateTime -> unitPublic Sub WriteStringValue (value As DateTime)Paramètres
- value
- DateTime
Valeur à écrire sous la forme d’une chaîne JSON comme élément d’un tableau JSON.
Exceptions
La validation est activée, et l’opération provoquerait l’écriture d’un JSON non valide.
Remarques
Cette méthode é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.
S’applique à
WriteStringValue(DateTimeOffset)
Écrit une valeur DateTimeOffset (sous la forme d’une chaîne JSON) comme élément d’un tableau JSON.
public:
void WriteStringValue(DateTimeOffset value);public void WriteStringValue (DateTimeOffset value);member this.WriteStringValue : DateTimeOffset -> unitPublic Sub WriteStringValue (value As DateTimeOffset)Paramètres
- value
- DateTimeOffset
Valeur à écrire sous la forme d’une chaîne JSON comme élément d’un tableau JSON.
Exceptions
La validation est activée, et l’opération provoquerait l’écriture d’un JSON non valide.
Remarques
Cette méthode é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.7680000-07:00.
S’applique à
WriteStringValue(Guid)
Écrit une valeur Guid (sous la forme d’une chaîne JSON) comme élément d’un tableau JSON.
public:
void WriteStringValue(Guid value);public void WriteStringValue (Guid value);member this.WriteStringValue : Guid -> unitPublic Sub WriteStringValue (value As Guid)Paramètres
- value
- Guid
Valeur à écrire sous la forme d’une chaîne JSON comme élément d’un tableau JSON.
Exceptions
La validation est activée, et l’opération provoquerait l’écriture d’un JSON non valide.
Remarques
Cette méthode écrit la Guid valeur à l’aide de la valeur par défaut StandardFormat (c’est-à-dire « D »), sous la forme : nnnnnn-nnnn-nnnnnn.
S’applique à
WriteStringValue(ReadOnlySpan<Byte>)
Écrit une valeur texte UTF-8 (sous la forme d’une chaîne JSON) comme élément d’un tableau JSON.
public:
void WriteStringValue(ReadOnlySpan<System::Byte> utf8Value);public void WriteStringValue (ReadOnlySpan<byte> utf8Value);member this.WriteStringValue : ReadOnlySpan<byte> -> unitPublic Sub WriteStringValue (utf8Value As ReadOnlySpan(Of Byte))Paramètres
- utf8Value
- ReadOnlySpan<Byte>
Valeur encodée en UTF-8 à écrire sous la forme d’un élément de chaîne JSON d’un tableau JSON.
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
La valeur est placée dans une séquence d’échappement avant l’écriture.
S’applique à
WriteStringValue(ReadOnlySpan<Char>)
Écrit une valeur texte UTF-16 (sous la forme d’une chaîne JSON) comme élément d’un tableau JSON.
public:
void WriteStringValue(ReadOnlySpan<char> value);public void WriteStringValue (ReadOnlySpan<char> value);member this.WriteStringValue : ReadOnlySpan<char> -> unitPublic Sub WriteStringValue (value As ReadOnlySpan(Of Char))Paramètres
- value
- ReadOnlySpan<Char>
Valeur encodée en UTF-16 à écrire sous la forme d’un élément de chaîne JSON encodé en UTF-8 d’un tableau JSON.
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
La valeur est placée dans une séquence d’échappement avant l’écriture.
S’applique à
WriteStringValue(JsonEncodedText)
Écrit la valeur texte préencodée (sous la forme d’une chaîne JSON) comme élément d’un tableau JSON.
public:
void WriteStringValue(System::Text::Json::JsonEncodedText value);public void WriteStringValue (System.Text.Json.JsonEncodedText value);member this.WriteStringValue : System.Text.Json.JsonEncodedText -> unitPublic Sub WriteStringValue (value As JsonEncodedText)Paramètres
- value
- JsonEncodedText
Valeur encodée en JSON à écrire sous la forme d’un élément de chaîne JSON encodé en UTF-8 d’un tableau JSON.
Exceptions
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 un échappement lors de la création de l’instance de JsonEncodedText .
