Utf8JsonWriter.WriteString Methode

Definition

Namespace:

System.Text.Json

Assembly:

System.Text.Json.dll

Überlädt

WriteString(JsonEncodedText, JsonEncodedText)	Schreibt den vorcodierten Eigenschaftennamen und vorcodierten Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.
WriteString(JsonEncodedText, String)	Schreibt den vorcodierten Eigenschaftennamen und Zeichenfolgen-Textwert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.
WriteString(JsonEncodedText, ReadOnlySpan<Char>)	Schreibt den vorcodierten Eigenschaftennamen und Textwert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.
WriteString(JsonEncodedText, ReadOnlySpan<Byte>)	Schreibt den vorcodierten Eigenschaftennamen und UTF-8-Textwert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.
WriteString(JsonEncodedText, Guid)	Schreibt den vorcodierten Eigenschaftennamen und Guid-Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.
WriteString(JsonEncodedText, DateTimeOffset)	Schreibt den vorcodierten Eigenschaftennamen und DateTimeOffset-Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.
WriteString(JsonEncodedText, DateTime)	Schreibt den vorcodierten Eigenschaftennamen und DateTime-Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.
WriteString(String, JsonEncodedText)	Schreibt den Eigenschaftennamen und vorcodierten Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.
WriteString(String, String)	Schreibt einen als Zeichenfolge angegebenen Eigenschaftennamen und einen Zeichenfolgentextwert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.
WriteString(String, ReadOnlySpan<Char>)	Schreibt einen als Zeichenfolge angegebenen Eigenschaftennamen und einen UTF-16-Textwert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.
WriteString(String, ReadOnlySpan<Byte>)	Schreibt einen als Zeichenfolge angegebenen Eigenschaftennamen und einen UTF-8-Textwert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.
WriteString(String, DateTimeOffset)	Schreibt einen als Zeichenfolge angegebenen Eigenschaftennamen und einen DateTimeOffset-Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.
WriteString(String, DateTime)	Schreibt einen als Zeichenfolge angegebenen Eigenschaftennamen und einen DateTime-Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.
WriteString(String, Guid)	Schreibt einen als Zeichenfolge angegebenen Eigenschaftennamen und einen Guid-Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.
WriteString(ReadOnlySpan<Char>, String)	Schreibt einen UTF-16-Eigenschaftennamen und Zeichenfolgentextwert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.
WriteString(ReadOnlySpan<Byte>, DateTime)	Schreibt einen UTF-8-Eigenschaftennamen und einen DateTime-Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.
WriteString(ReadOnlySpan<Byte>, DateTimeOffset)	Schreibt einen UTF-8-Eigenschaftennamen und einen DateTimeOffset-Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.
WriteString(ReadOnlySpan<Char>, JsonEncodedText)	Schreibt den Eigenschaftennamen und vorcodierten Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.
WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)	Schreibt einen UTF-8-Eigenschaftennamen und UTF-8-Textwert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.
WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Char>)	Schreibt einen UTF-8-Eigenschaftennamen und UTF-16-Textwert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.
WriteString(ReadOnlySpan<Byte>, String)	Schreibt einen UTF-8-Eigenschaftennamen und Zeichenfolgentextwert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.
WriteString(ReadOnlySpan<Byte>, Guid)	Schreibt einen UTF-8-Eigenschaftennamen und einen Guid-Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.
WriteString(ReadOnlySpan<Char>, DateTime)	Schreibt einen als schreibgeschützte Zeichenspanne angegebenen Eigenschaftennamen und einen DateTime-Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.
WriteString(ReadOnlySpan<Char>, DateTimeOffset)	Schreibt einen als schreibgeschützte Zeichenspanne angegebenen Eigenschaftennamen und einen DateTimeOffset-Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.
WriteString(ReadOnlySpan<Char>, Guid)	Schreibt einen als schreibgeschützte Zeichenspanne angegebenen Eigenschaftennamen und einen Guid-Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.
WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)	Schreibt einen UTF-16-Eigenschaftennamen und UTF-8-Textwert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.
WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	Schreibt einen UTF-16-Eigenschaftennamen und UTF-16-Textwert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.
WriteString(ReadOnlySpan<Byte>, JsonEncodedText)	Schreibt den UTF-8-Eigenschaftennamen und vorcodierten Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.

WriteString(JsonEncodedText, JsonEncodedText)

Quelle:

Utf8JsonWriter.WriteProperties.String.cs

Schreibt den vorcodierten Eigenschaftennamen und vorcodierten Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, System::Text::Json::JsonEncodedText value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, System.Text.Json.JsonEncodedText value);

member this.WriteString : System.Text.Json.JsonEncodedText * System.Text.Json.JsonEncodedText -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As JsonEncodedText)

Parameter

propertyName

JsonEncodedText

Der JSON-codierte Eigenschaftenname des JSON-Objekts, das zu transcodieren und als UTF-8 zu schreiben ist.

value

JsonEncodedText

Der JSON-codierte Wert, der als UTF-8-transcodierte JSON-Zeichenfolge als Teil des Name-Wert-Paars geschrieben werden soll.

Ausnahmen

InvalidOperationException

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

Hinweise

Der Eigenschaftsname und der Wert sollten bereits mit Escapezeichen versehen werden, wenn die Instanz von JsonEncodedText erstellt wurde.

WriteString(JsonEncodedText, String)

Quelle:

Utf8JsonWriter.WriteProperties.String.cs

Schreibt den vorcodierten Eigenschaftennamen und Zeichenfolgen-Textwert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, System::String ^ value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, string? value);

member this.WriteString : System.Text.Json.JsonEncodedText * string -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As String)

Parameter

propertyName

JsonEncodedText

Der JSON-codierte Eigenschaftenname des JSON-Objekts, das zu transcodieren und als UTF-8 zu schreiben ist.

value

String

Der Wert, der als UTF-8-transcodierte JSON-Zeichenfolge als Teil des Name-Wert-Paars 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 Eigenschaftsname sollte bereits beim Erstellen der Instanz von JsonEncodedText mit Escapezeichen versehen werden.

Der Wert wird vor dem Schreiben mit Escapezeichen versehen.

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

WriteString(JsonEncodedText, ReadOnlySpan<Char>)

Quelle:

Utf8JsonWriter.WriteProperties.String.cs

Schreibt den vorcodierten Eigenschaftennamen und Textwert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, ReadOnlySpan<char> value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, ReadOnlySpan<char> value);

member this.WriteString : System.Text.Json.JsonEncodedText * ReadOnlySpan<char> -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As ReadOnlySpan(Of Char))

Parameter

propertyName

JsonEncodedText

Der JSON-codierte Eigenschaftenname des JSON-Objekts, das zu transcodieren und als UTF-8 zu schreiben ist.

value

ReadOnlySpan<Char>

Der Wert, der als UTF-8-transcodierte JSON-Zeichenfolge als Teil des Name-Wert-Paars 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 Eigenschaftsname sollte bereits beim Erstellen der Instanz von JsonEncodedText mit Escapezeichen versehen werden.

Der Wert wird vor dem Schreiben mit Escapezeichen versehen.

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

WriteString(JsonEncodedText, ReadOnlySpan<Byte>)

Quelle:

Utf8JsonWriter.WriteProperties.String.cs

Schreibt den vorcodierten Eigenschaftennamen und UTF-8-Textwert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, ReadOnlySpan<System::Byte> utf8Value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, ReadOnlySpan<byte> utf8Value);

member this.WriteString : System.Text.Json.JsonEncodedText * ReadOnlySpan<byte> -> unit

Public Sub WriteString (propertyName As JsonEncodedText, utf8Value As ReadOnlySpan(Of Byte))

Parameter

propertyName

JsonEncodedText

Der JSON-codierte Eigenschaftenname des JSON-Objekts, das zu transcodieren und als UTF-8 zu schreiben ist.

utf8Value

ReadOnlySpan<Byte>

Der UTF-8-codierte Wert, der als JSON-Zeichenfolge als Teil des Name-Wert-Paars 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 Eigenschaftsname sollte bereits beim Erstellen der Instanz von JsonEncodedText mit Escapezeichen versehen werden.

Der Wert wird vor dem Schreiben mit Escapezeichen versehen.

WriteString(JsonEncodedText, Guid)

Quelle:

Utf8JsonWriter.WriteProperties.Guid.cs

Schreibt den vorcodierten Eigenschaftennamen und Guid-Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, Guid value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, Guid value);

member this.WriteString : System.Text.Json.JsonEncodedText * Guid -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As Guid)

Parameter

propertyName

JsonEncodedText

Der JSON-codierte Eigenschaftenname des JSON-Objekts, das zu transcodieren und als UTF-8 zu schreiben ist.

value

Guid

Der Wert, der als JSON-Zeichenfolge als Teil des Name-Wert-Paars geschrieben werden soll.

Ausnahmen

InvalidOperationException

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

Hinweise

Schreibt mit Guid dem Standardwert StandardFormat (d) im Format nnnnnnnn-nn-nnnn-n-nn-nnnn-nnnn.

Der Eigenschaftsname sollte bereits beim Erstellen der Instanz von JsonEncodedText mit Escapezeichen versehen werden.

WriteString(JsonEncodedText, DateTimeOffset)

Quelle:

Utf8JsonWriter.WriteProperties.DateTimeOffset.cs

Schreibt den vorcodierten Eigenschaftennamen und DateTimeOffset-Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, DateTimeOffset value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, DateTimeOffset value);

member this.WriteString : System.Text.Json.JsonEncodedText * DateTimeOffset -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As DateTimeOffset)

Parameter

propertyName

JsonEncodedText

Der JSON-codierte Eigenschaftenname des JSON-Objekts, das zu transcodieren und als UTF-8 zu schreiben ist.

value

DateTimeOffset

Der Wert, der als JSON-Zeichenfolge als Teil des Name-Wert-Paars geschrieben werden soll.

Ausnahmen

InvalidOperationException

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

Hinweise

Schreibt die DateTimeOffset 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-07:00.

Der Eigenschaftsname sollte bereits beim Erstellen der Instanz von JsonEncodedText mit Escapezeichen versehen werden.

WriteString(JsonEncodedText, DateTime)

Quelle:

Utf8JsonWriter.WriteProperties.DateTime.cs

Schreibt den vorcodierten Eigenschaftennamen und DateTime-Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.

public:
 void WriteString(System::Text::Json::JsonEncodedText propertyName, DateTime value);

public void WriteString (System.Text.Json.JsonEncodedText propertyName, DateTime value);

member this.WriteString : System.Text.Json.JsonEncodedText * DateTime -> unit

Public Sub WriteString (propertyName As JsonEncodedText, value As DateTime)

Parameter

propertyName

JsonEncodedText

Der JSON-codierte Eigenschaftenname des JSON-Objekts, das zu transcodieren und als UTF-8 zu schreiben ist.

value

DateTime

Der Wert, der als JSON-Zeichenfolge als Teil des Name-Wert-Paars geschrieben werden soll.

Ausnahmen

InvalidOperationException

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

Hinweise

Schreibt die DateTime 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.76800000.

Der Eigenschaftsname sollte bereits beim Erstellen der Instanz von JsonEncodedText mit Escapezeichen versehen werden.

WriteString(String, JsonEncodedText)

Quelle:

Utf8JsonWriter.WriteProperties.String.cs

Schreibt den Eigenschaftennamen und vorcodierten Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.

public:
 void WriteString(System::String ^ propertyName, System::Text::Json::JsonEncodedText value);

public void WriteString (string propertyName, System.Text.Json.JsonEncodedText value);

member this.WriteString : string * System.Text.Json.JsonEncodedText -> unit

Public Sub WriteString (propertyName As String, value As JsonEncodedText)

Parameter

propertyName

String

Der Eigenschaftenname des JSON-Objekts, das zu transcodieren und als UTF-8 zu schreiben ist.

value

JsonEncodedText

Der JSON-codierte Wert, der als UTF-8-transcodierte JSON-Zeichenfolge als Teil des Name-Wert-Paars geschrieben werden soll.

Ausnahmen

ArgumentException

Der angegebene Eigenschaftenname ist zu lang.

InvalidOperationException

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

ArgumentNullException

Der propertyName-Parameter ist null.

Hinweise

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

Der Eigenschaftsname wird vor dem Schreiben mit Escapezeichen versehen.

WriteString(String, String)

Quelle:

Utf8JsonWriter.WriteProperties.String.cs

Schreibt einen als Zeichenfolge angegebenen Eigenschaftennamen und einen Zeichenfolgentextwert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.

public:
 void WriteString(System::String ^ propertyName, System::String ^ value);

public void WriteString (string propertyName, string? value);

member this.WriteString : string * string -> unit

Public Sub WriteString (propertyName As String, value As String)

Parameter

propertyName

String

Der UTF-16-codierte Eigenschaftenname des JSON-Objekts, das zu transcodieren und als UTF-8 zu schreiben ist.

value

String

Der UTF-16-codierte Wert, der als UTF-8-transcodierte JSON-Zeichenfolge als Teil des Name-Wert-Paars geschrieben werden soll.

Ausnahmen

ArgumentException

Der angegebene Eigenschaftenname oder Wert ist zu groß.

InvalidOperationException

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

ArgumentNullException

Der propertyName-Parameter ist null.

Hinweise

Der Eigenschaftsname und der Wert werden vor dem Schreiben mit Escapezeichen versehen.

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

WriteString(String, ReadOnlySpan<Char>)

Quelle:

Utf8JsonWriter.WriteProperties.String.cs

Schreibt einen als Zeichenfolge angegebenen Eigenschaftennamen und einen UTF-16-Textwert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.

public:
 void WriteString(System::String ^ propertyName, ReadOnlySpan<char> value);

public void WriteString (string propertyName, ReadOnlySpan<char> value);

member this.WriteString : string * ReadOnlySpan<char> -> unit

Public Sub WriteString (propertyName As String, value As ReadOnlySpan(Of Char))

Parameter

propertyName

String

Der UTF-16-codierte Eigenschaftenname des JSON-Objekts, das zu transcodieren und als UTF-8 zu schreiben ist.

value

ReadOnlySpan<Char>

Der UTF-16-codierte Wert, der als UTF-8-transcodierte JSON-Zeichenfolge als Teil des Name-Wert-Paars geschrieben werden soll.

Ausnahmen

ArgumentException

Der angegebene Eigenschaftenname oder Wert ist zu groß.

InvalidOperationException

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

ArgumentNullException

Der propertyName-Parameter ist null.

Hinweise

Der Eigenschaftsname und der Wert werden vor dem Schreiben mit Escapezeichen versehen.

WriteString(String, ReadOnlySpan<Byte>)

Quelle:

Utf8JsonWriter.WriteProperties.String.cs

Schreibt einen als Zeichenfolge angegebenen Eigenschaftennamen und einen UTF-8-Textwert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.

public:
 void WriteString(System::String ^ propertyName, ReadOnlySpan<System::Byte> utf8Value);

public void WriteString (string propertyName, ReadOnlySpan<byte> utf8Value);

member this.WriteString : string * ReadOnlySpan<byte> -> unit

Public Sub WriteString (propertyName As String, utf8Value As ReadOnlySpan(Of Byte))

Parameter

propertyName

String

Der UTF-16-codierte Eigenschaftenname des JSON-Objekts, das zu transcodieren und als UTF-8 zu schreiben ist.

utf8Value

ReadOnlySpan<Byte>

Der UTF-8-codierte Wert, der als JSON-Zeichenfolge als Teil des Name-Wert-Paars geschrieben werden soll.

Ausnahmen

ArgumentException

Der angegebene Eigenschaftenname oder Wert ist zu groß.

InvalidOperationException

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

ArgumentNullException

Der propertyName-Parameter ist null.

Hinweise

Der Eigenschaftsname und der Wert werden vor dem Schreiben mit Escapezeichen versehen.

WriteString(String, DateTimeOffset)

Quelle:

Utf8JsonWriter.WriteProperties.DateTimeOffset.cs

Schreibt einen als Zeichenfolge angegebenen Eigenschaftennamen und einen DateTimeOffset-Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.

public:
 void WriteString(System::String ^ propertyName, DateTimeOffset value);

public void WriteString (string propertyName, DateTimeOffset value);

member this.WriteString : string * DateTimeOffset -> unit

Public Sub WriteString (propertyName As String, value As DateTimeOffset)

Parameter

propertyName

String

Der UTF-16-codierte Eigenschaftenname des JSON-Objekts, das zu transcodieren und als UTF-8 zu schreiben ist.

value

DateTimeOffset

Der Wert, der als JSON-Zeichenfolge als Teil des Name-Wert-Paars geschrieben werden soll.

Ausnahmen

ArgumentException

Der angegebene Eigenschaftenname ist zu lang.

InvalidOperationException

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

ArgumentNullException

Der propertyName-Parameter ist null.

Hinweise

Schreibt die DateTimeOffset 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-07:00.

Der Eigenschaftsname wird vor dem Schreiben mit Escapezeichen versehen.

WriteString(String, DateTime)

Quelle:

Utf8JsonWriter.WriteProperties.DateTime.cs

Schreibt einen als Zeichenfolge angegebenen Eigenschaftennamen und einen DateTime-Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.

public:
 void WriteString(System::String ^ propertyName, DateTime value);

public void WriteString (string propertyName, DateTime value);

member this.WriteString : string * DateTime -> unit

Public Sub WriteString (propertyName As String, value As DateTime)

Parameter

propertyName

String

Der UTF-16-codierte Eigenschaftenname des JSON-Objekts, das zu transcodieren und als UTF-8 zu schreiben ist.

value

DateTime

Der Wert, der als JSON-Zeichenfolge als Teil des Name-Wert-Paars geschrieben werden soll.

Ausnahmen

ArgumentException

Der angegebene Eigenschaftenname ist zu lang.

InvalidOperationException

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

ArgumentNullException

Der propertyName-Parameter ist null.

Hinweise

Schreibt die DateTime 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.76800000.

Der Eigenschaftsname wird vor dem Schreiben mit Escapezeichen versehen.

WriteString(String, Guid)

Quelle:

Utf8JsonWriter.WriteProperties.Guid.cs

Schreibt einen als Zeichenfolge angegebenen Eigenschaftennamen und einen Guid-Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.

public:
 void WriteString(System::String ^ propertyName, Guid value);

public void WriteString (string propertyName, Guid value);

member this.WriteString : string * Guid -> unit

Public Sub WriteString (propertyName As String, value As Guid)

Parameter

propertyName

String

Der UTF-16-codierte Eigenschaftenname des JSON-Objekts, das zu transcodieren und als UTF-8 zu schreiben ist.

value

Guid

Der Wert, der als JSON-Zeichenfolge als Teil des Name-Wert-Paars geschrieben werden soll.

Ausnahmen

ArgumentException

Der angegebene Eigenschaftenname ist zu lang.

InvalidOperationException

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

ArgumentNullException

Der propertyName-Parameter ist null.

Hinweise

Schreibt mit Guid dem Standardwert StandardFormat (d) im Format nnnnnnnn-nn-nnnn-n-nn-nnnn-nnnn. Der Eigenschaftsname wird vor dem Schreiben mit Escapezeichen versehen.

WriteString(ReadOnlySpan<Char>, String)

Quelle:

Utf8JsonWriter.WriteProperties.String.cs

Schreibt einen UTF-16-Eigenschaftennamen und Zeichenfolgentextwert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.

public:
 void WriteString(ReadOnlySpan<char> propertyName, System::String ^ value);

public void WriteString (ReadOnlySpan<char> propertyName, string? value);

member this.WriteString : ReadOnlySpan<char> * string -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As String)

Parameter

propertyName

ReadOnlySpan<Char>

Der UTF-16-codierte Eigenschaftenname des JSON-Objekts, das zu transcodieren und als UTF-8 zu schreiben ist.

value

String

Der UTF-16-codierte Wert, der als UTF-8-transcodierte JSON-Zeichenfolge als Teil des Name-Wert-Paars geschrieben werden soll.

Ausnahmen

ArgumentException

Der angegebene Eigenschaftenname oder Wert ist zu groß.

InvalidOperationException

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

Hinweise

Der Eigenschaftsname und der Wert werden vor dem Schreiben mit Escapezeichen versehen.

Wenn value ist null, wird der JSON-NULL-Wert geschrieben, als ob die WriteNull(ReadOnlySpan<Char>) -Methode aufgerufen wurde.

WriteString(ReadOnlySpan<Byte>, DateTime)

Quelle:

Utf8JsonWriter.WriteProperties.DateTime.cs

Schreibt einen UTF-8-Eigenschaftennamen und einen DateTime-Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, DateTime value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, DateTime value);

member this.WriteString : ReadOnlySpan<byte> * DateTime -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As DateTime)

Parameter

utf8PropertyName

ReadOnlySpan<Byte>

Der UTF-8-codierte Eigenschaftenname des zu schreibenden JSON-Objekts.

value

DateTime

Der Wert, der als JSON-Zeichenfolge als Teil des Name-Wert-Paars geschrieben werden soll.

Ausnahmen

ArgumentException

Der angegebene Eigenschaftenname ist zu lang.

InvalidOperationException

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

Hinweise

Schreibt die DateTime 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.76800000.

Der Eigenschaftsname wird vor dem Schreiben mit Escapezeichen versehen.

WriteString(ReadOnlySpan<Byte>, DateTimeOffset)

Quelle:

Utf8JsonWriter.WriteProperties.DateTimeOffset.cs

Schreibt einen UTF-8-Eigenschaftennamen und einen DateTimeOffset-Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, DateTimeOffset value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, DateTimeOffset value);

member this.WriteString : ReadOnlySpan<byte> * DateTimeOffset -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As DateTimeOffset)

Parameter

utf8PropertyName

ReadOnlySpan<Byte>

Der UTF-8-codierte Eigenschaftenname des zu schreibenden JSON-Objekts.

value

DateTimeOffset

Der Wert, der als JSON-Zeichenfolge als Teil des Name-Wert-Paars geschrieben werden soll.

Ausnahmen

ArgumentException

Der angegebene Eigenschaftenname ist zu lang.

InvalidOperationException

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

Hinweise

Schreibt die DateTimeOffset 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-07:00.

Der Eigenschaftsname wird vor dem Schreiben mit Escapezeichen versehen.

WriteString(ReadOnlySpan<Char>, JsonEncodedText)

Quelle:

Utf8JsonWriter.WriteProperties.String.cs

Schreibt den Eigenschaftennamen und vorcodierten Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.

public:
 void WriteString(ReadOnlySpan<char> propertyName, System::Text::Json::JsonEncodedText value);

public void WriteString (ReadOnlySpan<char> propertyName, System.Text.Json.JsonEncodedText value);

member this.WriteString : ReadOnlySpan<char> * System.Text.Json.JsonEncodedText -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As JsonEncodedText)

Parameter

propertyName

ReadOnlySpan<Char>

Der Eigenschaftenname des JSON-Objekts, das zu transcodieren und als UTF-8 zu schreiben ist.

value

JsonEncodedText

Der JSON-codierte Wert, der als UTF-8-transcodierte JSON-Zeichenfolge als Teil des Name-Wert-Paars geschrieben werden soll.

Ausnahmen

ArgumentException

Der angegebene Eigenschaftenname ist zu lang.

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.

Der Eigenschaftsname wird vor dem Schreiben mit Escapezeichen versehen.

WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)

Quelle:

Utf8JsonWriter.WriteProperties.String.cs

Schreibt einen UTF-8-Eigenschaftennamen und UTF-8-Textwert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, ReadOnlySpan<System::Byte> utf8Value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, ReadOnlySpan<byte> utf8Value);

member this.WriteString : ReadOnlySpan<byte> * ReadOnlySpan<byte> -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), utf8Value As ReadOnlySpan(Of Byte))

Parameter

utf8PropertyName

ReadOnlySpan<Byte>

Der UTF-8-codierte Eigenschaftenname des zu schreibenden JSON-Objekts.

utf8Value

ReadOnlySpan<Byte>

Der UTF-8-codierte Wert, der als JSON-Zeichenfolge als Teil des Name-Wert-Paars geschrieben werden soll.

Ausnahmen

ArgumentException

Der angegebene Eigenschaftenname oder Wert ist zu groß.

InvalidOperationException

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

Hinweise

Der Eigenschaftsname und der Wert werden vor dem Schreiben mit Escapezeichen versehen.

WriteString(ReadOnlySpan<Byte>, ReadOnlySpan<Char>)

Quelle:

Utf8JsonWriter.WriteProperties.String.cs

Schreibt einen UTF-8-Eigenschaftennamen und UTF-16-Textwert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, ReadOnlySpan<char> value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, ReadOnlySpan<char> value);

member this.WriteString : ReadOnlySpan<byte> * ReadOnlySpan<char> -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As ReadOnlySpan(Of Char))

Parameter

utf8PropertyName

ReadOnlySpan<Byte>

Der UTF-8-codierte Eigenschaftenname des zu schreibenden JSON-Objekts.

value

ReadOnlySpan<Char>

Der UTF-16-codierte Wert, der als UTF-8-transcodierte JSON-Zeichenfolge als Teil des Name-Wert-Paars geschrieben werden soll.

Ausnahmen

ArgumentException

Der angegebene Eigenschaftenname oder Wert ist zu groß.

InvalidOperationException

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

Hinweise

Der Eigenschaftsname und der Wert werden vor dem Schreiben mit Escapezeichen versehen.

WriteString(ReadOnlySpan<Byte>, String)

Quelle:

Utf8JsonWriter.WriteProperties.String.cs

Schreibt einen UTF-8-Eigenschaftennamen und Zeichenfolgentextwert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, System::String ^ value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, string? value);

member this.WriteString : ReadOnlySpan<byte> * string -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As String)

Parameter

utf8PropertyName

ReadOnlySpan<Byte>

Der UTF-8-codierte Eigenschaftenname des zu schreibenden JSON-Objekts.

value

String

Der UTF-16-codierte Wert, der als UTF-8-transcodierte JSON-Zeichenfolge als Teil des Name-Wert-Paars geschrieben werden soll.

Ausnahmen

ArgumentException

Der angegebene Eigenschaftenname oder Wert ist zu groß.

InvalidOperationException

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

Hinweise

Der Eigenschaftsname und der Wert werden vor dem Schreiben mit Escapezeichen versehen.

Wenn value ist null, wird der JSON-NULL-Wert so geschrieben, als ob die WriteNull(ReadOnlySpan<Byte>) -Methode aufgerufen wurde.

WriteString(ReadOnlySpan<Byte>, Guid)

Quelle:

Utf8JsonWriter.WriteProperties.Guid.cs

Schreibt einen UTF-8-Eigenschaftennamen und einen Guid-Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, Guid value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, Guid value);

member this.WriteString : ReadOnlySpan<byte> * Guid -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As Guid)

Parameter

utf8PropertyName

ReadOnlySpan<Byte>

Der UTF-8-codierte Eigenschaftenname des zu schreibenden JSON-Objekts.

value

Guid

Der Wert, der als JSON-Zeichenfolge als Teil des Name-Wert-Paars geschrieben werden soll.

Ausnahmen

ArgumentException

Der angegebene Eigenschaftenname ist zu lang.

InvalidOperationException

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

Hinweise

Schreibt den Guid mit dem Standardwert StandardFormat (d) in der Form nnnnnnnn-nnnn-nnnn-nn-nnnn-nnnnn-nnnnnn. Der Eigenschaftsname wird vor dem Schreiben mit escaped versehen.

WriteString(ReadOnlySpan<Char>, DateTime)

Quelle:

Utf8JsonWriter.WriteProperties.DateTime.cs

Schreibt einen als schreibgeschützte Zeichenspanne angegebenen Eigenschaftennamen und einen DateTime-Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.

public:
 void WriteString(ReadOnlySpan<char> propertyName, DateTime value);

public void WriteString (ReadOnlySpan<char> propertyName, DateTime value);

member this.WriteString : ReadOnlySpan<char> * DateTime -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As DateTime)

Parameter

propertyName

ReadOnlySpan<Char>

Der UTF-16-codierte Eigenschaftenname des JSON-Objekts, das zu transcodieren und als UTF-8 zu schreiben ist.

value

DateTime

Der Wert, der als JSON-Zeichenfolge als Teil des Name-Wert-Paars geschrieben werden soll.

Ausnahmen

ArgumentException

Der angegebene Eigenschaftenname ist zu lang.

InvalidOperationException

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

Hinweise

Schreibt das DateTime mithilfe des erweiterten ISO 8601-1-Formats (siehe Unterstützung von DateTime und DateTimeOffset in System.Text.Json). Beispiel: 2017-06-12T05:30:45.7680000.

Der Eigenschaftsname wird vor dem Schreiben mit escaped versehen.

WriteString(ReadOnlySpan<Char>, DateTimeOffset)

Quelle:

Utf8JsonWriter.WriteProperties.DateTimeOffset.cs

Schreibt einen als schreibgeschützte Zeichenspanne angegebenen Eigenschaftennamen und einen DateTimeOffset-Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.

public:
 void WriteString(ReadOnlySpan<char> propertyName, DateTimeOffset value);

public void WriteString (ReadOnlySpan<char> propertyName, DateTimeOffset value);

member this.WriteString : ReadOnlySpan<char> * DateTimeOffset -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As DateTimeOffset)

Parameter

propertyName

ReadOnlySpan<Char>

Der UTF-16-codierte Eigenschaftenname des JSON-Objekts, das zu transcodieren und als UTF-8 zu schreiben ist.

value

DateTimeOffset

Der Wert, der als JSON-Zeichenfolge als Teil des Name-Wert-Paars geschrieben werden soll.

Ausnahmen

ArgumentException

Der angegebene Eigenschaftenname ist zu lang.

InvalidOperationException

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

Hinweise

Schreibt die DateTimeOffset mithilfe des erweiterten ISO 8601-1-Formats (siehe Unterstützung von DateTime und DateTimeOffset in System.Text.Json). Beispiel: 2017-06-12T05:30:45.7680000-07:00.

Der Eigenschaftsname wird vor dem Schreiben mit escaped versehen.

WriteString(ReadOnlySpan<Char>, Guid)

Quelle:

Utf8JsonWriter.WriteProperties.Guid.cs

Schreibt einen als schreibgeschützte Zeichenspanne angegebenen Eigenschaftennamen und einen Guid-Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.

public:
 void WriteString(ReadOnlySpan<char> propertyName, Guid value);

public void WriteString (ReadOnlySpan<char> propertyName, Guid value);

member this.WriteString : ReadOnlySpan<char> * Guid -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As Guid)

Parameter

propertyName

ReadOnlySpan<Char>

Der UTF-16-codierte Eigenschaftenname des JSON-Objekts, das zu transcodieren und als UTF-8 zu schreiben ist.

value

Guid

Der Wert, der als JSON-Zeichenfolge als Teil des Name-Wert-Paars geschrieben werden soll.

Ausnahmen

ArgumentException

Der angegebene Eigenschaftenname ist zu lang.

InvalidOperationException

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

Hinweise

Schreibt den Guid mit dem Standardwert StandardFormat (d) in der Form nnnnnnnn-nnnn-nnnn-nn-nnnn-nnnnn-nnnnnn. Der Eigenschaftsname wird vor dem Schreiben mit escaped versehen.

WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)

Quelle:

Utf8JsonWriter.WriteProperties.String.cs

Schreibt einen UTF-16-Eigenschaftennamen und UTF-8-Textwert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.

public:
 void WriteString(ReadOnlySpan<char> propertyName, ReadOnlySpan<System::Byte> utf8Value);

public void WriteString (ReadOnlySpan<char> propertyName, ReadOnlySpan<byte> utf8Value);

member this.WriteString : ReadOnlySpan<char> * ReadOnlySpan<byte> -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), utf8Value As ReadOnlySpan(Of Byte))

Parameter

propertyName

ReadOnlySpan<Char>

Der UTF-16-codierte Eigenschaftenname des JSON-Objekts, das zu transcodieren und als UTF-8 zu schreiben ist.

utf8Value

ReadOnlySpan<Byte>

Der UTF-8-codierte Wert, der als JSON-Zeichenfolge als Teil des Name-Wert-Paars geschrieben werden soll.

Ausnahmen

ArgumentException

Der angegebene Eigenschaftenname oder Wert ist zu groß.

InvalidOperationException

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

Hinweise

Der Eigenschaftsname und der Wert werden vor dem Schreiben mit Escapezeichen versehen.

WriteString(ReadOnlySpan<Char>, ReadOnlySpan<Char>)

Quelle:

Utf8JsonWriter.WriteProperties.String.cs

Schreibt einen UTF-16-Eigenschaftennamen und UTF-16-Textwert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.

public:
 void WriteString(ReadOnlySpan<char> propertyName, ReadOnlySpan<char> value);

public void WriteString (ReadOnlySpan<char> propertyName, ReadOnlySpan<char> value);

member this.WriteString : ReadOnlySpan<char> * ReadOnlySpan<char> -> unit

Public Sub WriteString (propertyName As ReadOnlySpan(Of Char), value As ReadOnlySpan(Of Char))

Parameter

propertyName

ReadOnlySpan<Char>

Der UTF-16-codierte Eigenschaftenname des JSON-Objekts, das zu transcodieren und als UTF-8 zu schreiben ist.

value

ReadOnlySpan<Char>

Der UTF-16-codierte Wert, der als UTF-8-transcodierte JSON-Zeichenfolge als Teil des Name-Wert-Paars geschrieben werden soll.

Ausnahmen

ArgumentException

Der angegebene Eigenschaftenname oder Wert ist zu groß.

InvalidOperationException

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

Hinweise

Der Eigenschaftsname und der Wert werden vor dem Schreiben mit Escapezeichen versehen.

WriteString(ReadOnlySpan<Byte>, JsonEncodedText)

Quelle:

Utf8JsonWriter.WriteProperties.String.cs

Schreibt den UTF-8-Eigenschaftennamen und vorcodierten Wert (als JSON-Zeichenfolge) als Teil eines Name-Wert-Paars eines JSON-Objekts.

public:
 void WriteString(ReadOnlySpan<System::Byte> utf8PropertyName, System::Text::Json::JsonEncodedText value);

public void WriteString (ReadOnlySpan<byte> utf8PropertyName, System.Text.Json.JsonEncodedText value);

member this.WriteString : ReadOnlySpan<byte> * System.Text.Json.JsonEncodedText -> unit

Public Sub WriteString (utf8PropertyName As ReadOnlySpan(Of Byte), value As JsonEncodedText)

Parameter

utf8PropertyName

ReadOnlySpan<Byte>

Der UTF-8-codierte Eigenschaftenname des zu schreibenden JSON-Objekts.

value

JsonEncodedText

Der JSON-codierte Wert, der als UTF-8-transcodierte JSON-Zeichenfolge als Teil des Name-Wert-Paars geschrieben werden soll.

Ausnahmen

ArgumentException

Der angegebene Eigenschaftenname ist zu lang.

InvalidOperationException

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

Hinweise

Der Wert sollte bereits beim Erstellen der Instanz von JsonEncodedText escaped sein.

Der Eigenschaftsname wird vor dem Schreiben mit escaped versehen.