Utf8JsonWriter.WriteStringValue 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

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)

Source:

Utf8JsonWriter.WriteValues.String.cs

É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);

member this.WriteStringValue : string -> unit

Public 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

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

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.

WriteStringValue(DateTime)

Source:

Utf8JsonWriter.WriteValues.DateTime.cs

É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 -> unit

Public 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

InvalidOperationException

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.

WriteStringValue(DateTimeOffset)

Source:

Utf8JsonWriter.WriteValues.DateTimeOffset.cs

É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 -> unit

Public 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

InvalidOperationException

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.

WriteStringValue(Guid)

Source:

Utf8JsonWriter.WriteValues.Guid.cs

É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 -> unit

Public 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

InvalidOperationException

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.

WriteStringValue(ReadOnlySpan<Byte>)

Source:

Utf8JsonWriter.WriteValues.String.cs

É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> -> unit

Public 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

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

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

WriteStringValue(ReadOnlySpan<Char>)

Source:

Utf8JsonWriter.WriteValues.String.cs

É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> -> unit

Public 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

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

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

WriteStringValue(JsonEncodedText)

Source:

Utf8JsonWriter.WriteValues.String.cs

É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 -> unit

Public 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

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 un échappement lors de la création de l’instance de JsonEncodedText .