Utf8JsonWriter.WriteStringValue Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ü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)
Schreibt einen Zeichenfolgentextwert (als JSON-Zeichenfolge) als ein Element eines JSON-Arrays.
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)Parameter
- value
- String
Der UTF-16-codierte Wert, der als UTF-8-transcodiertes JSON-Zeichenfolgenelement eines JSON-Arrays geschrieben werden soll.
Ausnahmen
Der angegebene Wert ist zu groß.
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.
Gilt für:
WriteStringValue(DateTime)
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 -> unitPublic Sub WriteStringValue (value As DateTime)Parameter
- value
- DateTime
Der Wert, der als JSON-Zeichenfolge als ein Element eines JSON-Arrays geschrieben werden soll.
Ausnahmen
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.
Gilt für:
WriteStringValue(DateTimeOffset)
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 -> unitPublic Sub WriteStringValue (value As DateTimeOffset)Parameter
- value
- DateTimeOffset
Der Wert, der als JSON-Zeichenfolge als ein Element eines JSON-Arrays geschrieben werden soll.
Ausnahmen
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.
Gilt für:
WriteStringValue(Guid)
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 -> unitPublic Sub WriteStringValue (value As Guid)Parameter
- value
- Guid
Der Wert, der als JSON-Zeichenfolge als ein Element eines JSON-Arrays geschrieben werden soll.
Ausnahmen
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
Gilt für:
WriteStringValue(ReadOnlySpan<Byte>)
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> -> unitPublic 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
Der angegebene Wert ist zu groß.
Validierung ist aktiviert, und der Schreibvorgang würde ungültige JSON-Daten produzieren.
Hinweise
Der Wert wird vor dem Schreiben mit Escapezeichen versehen.
Gilt für:
WriteStringValue(ReadOnlySpan<Char>)
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> -> unitPublic 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
Der angegebene Wert ist zu groß.
Validierung ist aktiviert, und der Schreibvorgang würde ungültige JSON-Daten produzieren.
Hinweise
Der Wert wird vor dem Schreiben mit Escapezeichen versehen.
Gilt für:
WriteStringValue(JsonEncodedText)
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 -> unitPublic 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
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.
