Partager via


Utf8JsonWriter.WriteStringValue Méthode

Définition

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
Source:
Utf8JsonWriter.WriteValues.String.cs
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);
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

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)

Source:
Utf8JsonWriter.WriteValues.DateTime.cs
Source:
Utf8JsonWriter.WriteValues.DateTime.cs
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

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)

Source:
Utf8JsonWriter.WriteValues.DateTimeOffset.cs
Source:
Utf8JsonWriter.WriteValues.DateTimeOffset.cs
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

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)

Source:
Utf8JsonWriter.WriteValues.Guid.cs
Source:
Utf8JsonWriter.WriteValues.Guid.cs
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

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

Source:
Utf8JsonWriter.WriteValues.String.cs
Source:
Utf8JsonWriter.WriteValues.String.cs
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

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

Source:
Utf8JsonWriter.WriteValues.String.cs
Source:
Utf8JsonWriter.WriteValues.String.cs
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

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)

Source:
Utf8JsonWriter.WriteValues.String.cs
Source:
Utf8JsonWriter.WriteValues.String.cs
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

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 .

S’applique à