Utf8JsonWriter.WriteStringValue Metodo

Definizione

Spazio dei nomi:

System.Text.Json

Assembly:

System.Text.Json.dll

Pacchetto:

System.Text.Json v9.0.0-rc.2.24473.5

Overload

WriteStringValue(String)	Scrive un valore stringa di testo (come una stringa JSON) come elemento di una matrice JSON.
WriteStringValue(DateTime)	Scrive un valore DateTime (come una stringa JSON) come elemento di una matrice JSON.
WriteStringValue(DateTimeOffset)	Scrive un valore DateTimeOffset (come una stringa JSON) come elemento di una matrice JSON.
WriteStringValue(Guid)	Scrive un valore Guid (come una stringa JSON) come elemento di una matrice JSON.
WriteStringValue(ReadOnlySpan<Byte>)	Scrive un valore di testo UTF-8 (come stringa JSON) come elemento di una matrice JSON.
WriteStringValue(ReadOnlySpan<Char>)	Scrive un valore di testo UTF-16 (come una stringa JSON) come elemento di una matrice JSON.
WriteStringValue(JsonEncodedText)	Scrive il valore di testo precodificato (come stringa JSON) come elemento di una matrice JSON.

WriteStringValue(String)

Origine:

Utf8JsonWriter.WriteValues.String.cs

Scrive un valore stringa di testo (come una stringa JSON) come elemento di una matrice JSON.

public:
 void WriteStringValue(System::String ^ value);

public void WriteStringValue (string? value);

member this.WriteStringValue : string -> unit

Public Sub WriteStringValue (value As String)

Parametri

value

String

Valore con codifica UTF-16 da scrivere come elemento di stringa JSON transcodificato UTF-8 di una matrice JSON.

Eccezioni

ArgumentException

Il valore specificato è troppo grande.

InvalidOperationException

La convalida è abilitata e l'operazione di scrittura produrrebbe codice JSON non valido.

Commenti

Il valore viene eliminato prima della scrittura.

Se value è null, il valore NULL JSON viene scritto, come se il WriteNullValue() metodo fosse chiamato.

WriteStringValue(DateTime)

Origine:

Utf8JsonWriter.WriteValues.DateTime.cs

Scrive un valore DateTime (come una stringa JSON) come elemento di una matrice JSON.

public:
 void WriteStringValue(DateTime value);

public void WriteStringValue (DateTime value);

member this.WriteStringValue : DateTime -> unit

Public Sub WriteStringValue (value As DateTime)

Parametri

value

DateTime

Valore da scrivere come stringa JSON come elemento di una matrice JSON.

Eccezioni

InvalidOperationException

La convalida è abilitata e l'operazione produrrebbe la scrittura di codice JSON non valido.

Commenti

Questo metodo scrive l'uso DateTime del formato esteso ISO 8601-1 (vedere Supporto dateTime e DateTimeOffset in System.Text.Json). Ad esempio, 2017-06-12T05:30:45.7680000.

WriteStringValue(DateTimeOffset)

Origine:

Utf8JsonWriter.WriteValues.DateTimeOffset.cs

Scrive un valore DateTimeOffset (come una stringa JSON) come elemento di una matrice JSON.

public:
 void WriteStringValue(DateTimeOffset value);

public void WriteStringValue (DateTimeOffset value);

member this.WriteStringValue : DateTimeOffset -> unit

Public Sub WriteStringValue (value As DateTimeOffset)

Parametri

value

DateTimeOffset

Valore da scrivere come stringa JSON come elemento di una matrice JSON.

Eccezioni

InvalidOperationException

La convalida è abilitata e l'operazione produrrebbe la scrittura di codice JSON non valido.

Commenti

Questo metodo scrive l'uso DateTimeOffset del formato esteso ISO 8601-1 (vedere Supporto dateTime e DateTimeOffset in System.Text.Json). Ad esempio, 2017-06-12T05:30:45.7680000-07:00.

WriteStringValue(Guid)

Origine:

Utf8JsonWriter.WriteValues.Guid.cs

Scrive un valore Guid (come una stringa JSON) come elemento di una matrice JSON.

public:
 void WriteStringValue(Guid value);

public void WriteStringValue (Guid value);

member this.WriteStringValue : Guid -> unit

Public Sub WriteStringValue (value As Guid)

Parametri

value

Guid

Valore da scrivere come stringa JSON come elemento di una matrice JSON.

Eccezioni

InvalidOperationException

La convalida è abilitata e l'operazione produrrebbe la scrittura di codice JSON non valido.

Commenti

Questo metodo scrive il Guid valore usando il valore predefinito StandardFormat (ovvero 'D'), come modulo: nn-nn.

WriteStringValue(ReadOnlySpan<Byte>)

Origine:

Utf8JsonWriter.WriteValues.String.cs

Scrive un valore di testo UTF-8 (come stringa JSON) come elemento di una matrice 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))

Parametri

utf8Value

ReadOnlySpan<Byte>

Valore con codifica UTF-8 da scrivere come elemento di stringa JSON di una matrice JSON.

Eccezioni

ArgumentException

Il valore specificato è troppo grande.

InvalidOperationException

La convalida è abilitata e l'operazione di scrittura produrrebbe codice JSON non valido.

Commenti

Il valore viene eliminato prima della scrittura.

WriteStringValue(ReadOnlySpan<Char>)

Origine:

Utf8JsonWriter.WriteValues.String.cs

Scrive un valore di testo UTF-16 (come una stringa JSON) come elemento di una matrice 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))

Parametri

value

ReadOnlySpan<Char>

Valore con codifica UTF-16 da scrivere come elemento di stringa JSON transcodificato UTF-8 di una matrice JSON.

Eccezioni

ArgumentException

Il valore specificato è troppo grande.

InvalidOperationException

La convalida è abilitata e l'operazione di scrittura produrrebbe codice JSON non valido.

Commenti

Il valore viene eliminato prima della scrittura.

WriteStringValue(JsonEncodedText)

Origine:

Utf8JsonWriter.WriteValues.String.cs

Scrive il valore di testo precodificato (come stringa JSON) come elemento di una matrice 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)

Parametri

value

JsonEncodedText

Valore con codifica JSON da scrivere come elemento di stringa JSON transcodificato UTF-8 di una matrice JSON.

Eccezioni

InvalidOperationException

La convalida è abilitata e l'operazione di scrittura produrrebbe codice JSON non valido.

Commenti

Il valore deve essere già escape quando è stata creata l'istanza di JsonEncodedText .