Utf8JsonWriter.WriteStringValue Methode

Definition

Namespace:

System.Text.Json

Assembly:

System.Text.Json.dll

Paket:

System.Text.Json v9.0.0-preview.3.24172.9

Überlädt

WriteStringValue(String)	Schreibt einen Zeichenfolgentextwert (als JSON-Zeichenfolge) als ein Element eines JSON-Arrays.
WriteStringValue(DateTime)	Schreibt einen DateTime-Wert (als JSON-Zeichenfolge) als ein Element eines JSON-Arrays.
WriteStringValue(DateTimeOffset)	Schreibt einen DateTimeOffset-Wert (als JSON-Zeichenfolge) als ein Element eines JSON-Arrays.
WriteStringValue(Guid)	Schreibt einen Guid-Wert (als JSON-Zeichenfolge) als ein Element eines JSON-Arrays.
WriteStringValue(ReadOnlySpan<Byte>)	Schreibt einen UTF-8-Textwert (als JSON-Zeichenfolge) als ein Element eines JSON-Arrays.
WriteStringValue(ReadOnlySpan<Char>)	Schreibt einen UTF-16-Textwert (als JSON-Zeichenfolge) als ein Element eines JSON-Arrays.
WriteStringValue(JsonEncodedText)	Schreibt den vorcodierten Textwert (als JSON-Zeichenfolge) als ein Element eines JSON-Arrays.

WriteStringValue(String)

Quelle:

Utf8JsonWriter.WriteValues.String.cs

Schreibt einen Zeichenfolgentextwert (als JSON-Zeichenfolge) als ein Element eines JSON-Arrays.

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

public void WriteStringValue (string? value);

member this.WriteStringValue : string -> unit

Public Sub WriteStringValue (value As String)

Parameter

value

String

Der UTF-16-codierte Wert, der als UTF-8-transcodiertes JSON-Zeichenfolgenelement eines JSON-Arrays geschrieben werden soll.

Ausnahmen

ArgumentException

Der angegebene Wert ist zu groß.

InvalidOperationException

Validierung ist aktiviert, und der Schreibvorgang würde ungültige JSON-Daten produzieren.

Hinweise

Der Wert wird vor dem Schreiben mit Escapezeichen versehen.

Wenn value ist null, wird der JSON-NULL-Wert geschrieben, als ob die WriteNullValue() -Methode aufgerufen wurde.

WriteStringValue(DateTime)

Quelle:

Utf8JsonWriter.WriteValues.DateTime.cs

Schreibt einen DateTime-Wert (als JSON-Zeichenfolge) als ein Element eines JSON-Arrays.

public:
 void WriteStringValue(DateTime value);

public void WriteStringValue (DateTime value);

member this.WriteStringValue : DateTime -> unit

Public Sub WriteStringValue (value As DateTime)

Parameter

value

DateTime

Der Wert, der als JSON-Zeichenfolge als ein Element eines JSON-Arrays geschrieben werden soll.

Ausnahmen

InvalidOperationException

Validierung ist aktiviert, und der Vorgang würde im Schreiben ungültiger JSON-Daten resultieren.

Hinweise

Diese Methode schreibt die DateTime mit dem erweiterten ISO 8601-1-Format (siehe Unterstützung von DateTime und DateTimeOffset in System.Text.Json). Beispiel: 2017-06-12T05:30:45.7680000.

WriteStringValue(DateTimeOffset)

Quelle:

Utf8JsonWriter.WriteValues.DateTimeOffset.cs

Schreibt einen DateTimeOffset-Wert (als JSON-Zeichenfolge) als ein Element eines JSON-Arrays.

public:
 void WriteStringValue(DateTimeOffset value);

public void WriteStringValue (DateTimeOffset value);

member this.WriteStringValue : DateTimeOffset -> unit

Public Sub WriteStringValue (value As DateTimeOffset)

Parameter

value

DateTimeOffset

Der Wert, der als JSON-Zeichenfolge als ein Element eines JSON-Arrays geschrieben werden soll.

Ausnahmen

InvalidOperationException

Validierung ist aktiviert, und der Vorgang würde im Schreiben ungültiger JSON-Daten resultieren.

Hinweise

Diese Methode schreibt die DateTimeOffset mit dem erweiterten ISO 8601-1-Format (siehe Unterstützung für DateTime und DateTimeOffset in System.Text.Json). Beispiel: 2017-06-12T05:30:45.7680000-07:00.

WriteStringValue(Guid)

Quelle:

Utf8JsonWriter.WriteValues.Guid.cs

Schreibt einen Guid-Wert (als JSON-Zeichenfolge) als ein Element eines JSON-Arrays.

public:
 void WriteStringValue(Guid value);

public void WriteStringValue (Guid value);

member this.WriteStringValue : Guid -> unit

Public Sub WriteStringValue (value As Guid)

Parameter

value

Guid

Der Wert, der als JSON-Zeichenfolge als ein Element eines JSON-Arrays geschrieben werden soll.

Ausnahmen

InvalidOperationException

Validierung ist aktiviert, und der Vorgang würde im Schreiben ungültiger JSON-Daten resultieren.

Hinweise

Diese Methode schreibt den Guid Wert unter Verwendung des Standardwerts StandardFormat (d) als Form: nnnnnnnn-nnnn-nn-nn-nnnn-nn-nnnn

WriteStringValue(ReadOnlySpan<Byte>)

Quelle:

Utf8JsonWriter.WriteValues.String.cs

Schreibt einen UTF-8-Textwert (als JSON-Zeichenfolge) als ein Element eines JSON-Arrays.

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

Parameter

utf8Value

ReadOnlySpan<Byte>

Der UTF-8-codierte Wert, der als JSON-Zeichenfolgenelement eines JSON-Arrays geschrieben werden soll.

Ausnahmen

ArgumentException

Der angegebene Wert ist zu groß.

InvalidOperationException

Validierung ist aktiviert, und der Schreibvorgang würde ungültige JSON-Daten produzieren.

Hinweise

Der Wert wird vor dem Schreiben mit Escapezeichen versehen.

WriteStringValue(ReadOnlySpan<Char>)

Quelle:

Utf8JsonWriter.WriteValues.String.cs

Schreibt einen UTF-16-Textwert (als JSON-Zeichenfolge) als ein Element eines JSON-Arrays.

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

Parameter

value

ReadOnlySpan<Char>

Der UTF-16-codierte Wert, der als UTF-8-transcodiertes JSON-Zeichenfolgenelement eines JSON-Arrays geschrieben werden soll.

Ausnahmen

ArgumentException

Der angegebene Wert ist zu groß.

InvalidOperationException

Validierung ist aktiviert, und der Schreibvorgang würde ungültige JSON-Daten produzieren.

Hinweise

Der Wert wird vor dem Schreiben mit Escapezeichen versehen.

WriteStringValue(JsonEncodedText)

Quelle:

Utf8JsonWriter.WriteValues.String.cs

Schreibt den vorcodierten Textwert (als JSON-Zeichenfolge) als ein Element eines JSON-Arrays.

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)

Parameter

value

JsonEncodedText

Der JSON-codierte Wert, der als UTF-8-transcodiertes JSON-Zeichenfolgenelement eines JSON-Arrays geschrieben werden soll.

Ausnahmen

InvalidOperationException

Validierung ist aktiviert, und der Schreibvorgang würde ungültige JSON-Daten produzieren.

Hinweise

Der Wert sollte bereits mit Escapezeichen versehen werden, wenn die Instanz von JsonEncodedText erstellt wurde.