JsonSerializer.Serialize 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
| Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext) |
Schreibt einen JSON-Wert (einschließlich Objekte oder Arrays) in den bereitgestellten Writer. |
| Serialize(Stream, Object, Type, JsonSerializerContext) |
Konvertiert den angegebenen Wert in UTF-8-codierten JSON-Text und schreibt ihn in den Stream. |
| Serialize(Stream, Object, Type, JsonSerializerOptions) |
Konvertiert den angegebenen Wert in UTF-8-codierten JSON-Text und schreibt ihn in den Stream. |
| Serialize(Utf8JsonWriter, Object, JsonTypeInfo) |
Schreibt einen JSON-Wert (einschließlich Objekte oder Arrays) in den bereitgestellten Writer. |
| Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions) |
Schreibt die JSON-Darstellung des angegebenen Typs in den bereitgestellten Writer. |
| Serialize(Object, Type, JsonSerializerOptions) |
Konvertiert den Wert eines angegebenen Typs in eine JSON-Zeichenfolge. |
| Serialize(Stream, Object, JsonTypeInfo) |
Konvertiert den angegebenen Wert in UTF-8-codierten JSON-Text und schreibt ihn in den Stream. |
| Serialize(Object, JsonTypeInfo) |
Konvertiert den angegebenen Wert in einen String. |
| Serialize(Object, Type, JsonSerializerContext) |
Konvertiert den angegebenen Wert in einen String. |
| Serialize<TValue>(TValue, JsonSerializerOptions) |
Konvertiert den Wert eines von einem generischen Typparameter angegebenen Typs in eine JSON-Zeichenfolge. |
| Serialize<TValue>(TValue, JsonTypeInfo<TValue>) |
Konvertiert den angegebenen Wert in einen String. |
| Serialize<TValue>(Stream, TValue, JsonSerializerOptions) |
Konvertiert den angegebenen Wert in UTF-8-codierten JSON-Text und schreibt ihn in den Stream. |
| Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>) |
Konvertiert den angegebenen Wert in UTF-8-codierten JSON-Text und schreibt ihn in den Stream. |
| Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions) |
Schreibt die JSON-Darstellung eines Typs, der von einem generischen Typparameter angegeben wird, in den bereitgestellten Writer. |
| Serialize<TValue>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>) |
Schreibt einen JSON-Wert (einschließlich Objekte oder Arrays) in den bereitgestellten Writer. |
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext)
Schreibt einen JSON-Wert (einschließlich Objekte oder Arrays) in den bereitgestellten Writer.
public:
static void Serialize(System::Text::Json::Utf8JsonWriter ^ writer, System::Object ^ value, Type ^ inputType, System::Text::Json::Serialization::JsonSerializerContext ^ context);public static void Serialize (System.Text.Json.Utf8JsonWriter writer, object? value, Type inputType, System.Text.Json.Serialization.JsonSerializerContext context);static member Serialize : System.Text.Json.Utf8JsonWriter * obj * Type * System.Text.Json.Serialization.JsonSerializerContext -> unitPublic Sub Serialize (writer As Utf8JsonWriter, value As Object, inputType As Type, context As JsonSerializerContext)Parameter
- writer
- Utf8JsonWriter
Ein JSON-Writer, in den geschrieben werden soll.
- value
- Object
Der zu konvertierende und zu schreibende Wert.
- inputType
- Type
Der Typ des value-Elements, das konvertiert werden soll.
- context
- JsonSerializerContext
Ein Metadatenanbieter für serialisierbare Typen.
Ausnahmen
inputType ist nicht mit value kompatibel.
writer oder inputType ist null.
Es ist keine kompatible JsonConverter-Klasse für inputType oder die serialisierbaren Member vorhanden.
Die GetTypeInfo(Type) -Methode der bereitgestellten context gibt für den zu konvertierenden Typ zurück null .
Gilt für:
Serialize(Stream, Object, Type, JsonSerializerContext)
Konvertiert den angegebenen Wert in UTF-8-codierten JSON-Text und schreibt ihn in den Stream.
public:
static void Serialize(System::IO::Stream ^ utf8Json, System::Object ^ value, Type ^ inputType, System::Text::Json::Serialization::JsonSerializerContext ^ context);public static void Serialize (System.IO.Stream utf8Json, object? value, Type inputType, System.Text.Json.Serialization.JsonSerializerContext context);static member Serialize : System.IO.Stream * obj * Type * System.Text.Json.Serialization.JsonSerializerContext -> unitPublic Sub Serialize (utf8Json As Stream, value As Object, inputType As Type, context As JsonSerializerContext)Parameter
- value
- Object
Der zu konvertierende Wert.
- inputType
- Type
Der Typ des value-Elements, das konvertiert werden soll.
- context
- JsonSerializerContext
Ein Metadatenanbieter für serialisierbare Typen.
Ausnahmen
inputType ist nicht mit value kompatibel.
utf8Json, inputType oder context ist null.
Es ist keine kompatible JsonConverter-Klasse für inputType oder die serialisierbaren Member vorhanden.
Gilt für:
Serialize(Stream, Object, Type, JsonSerializerOptions)
Konvertiert den angegebenen Wert in UTF-8-codierten JSON-Text und schreibt ihn in den Stream.
public static void Serialize (System.IO.Stream utf8Json, object? value, Type inputType, System.Text.Json.JsonSerializerOptions? options = default);static member Serialize : System.IO.Stream * obj * Type * System.Text.Json.JsonSerializerOptions -> unitPublic Sub Serialize (utf8Json As Stream, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing)Parameter
- value
- Object
Der zu konvertierende Wert.
- inputType
- Type
Der Typ des value-Elements, das konvertiert werden soll.
- options
- JsonSerializerOptions
Optionen zum Steuern des Konvertierungsverhaltens.
Ausnahmen
inputType ist nicht mit value kompatibel.
utf8Json oder inputType ist null.
Es ist keine kompatible JsonConverter-Klasse für inputType oder die serialisierbaren Member vorhanden.
Gilt für:
Serialize(Utf8JsonWriter, Object, JsonTypeInfo)
Schreibt einen JSON-Wert (einschließlich Objekte oder Arrays) in den bereitgestellten Writer.
public:
static void Serialize(System::Text::Json::Utf8JsonWriter ^ writer, System::Object ^ value, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);public static void Serialize (System.Text.Json.Utf8JsonWriter writer, object? value, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);static member Serialize : System.Text.Json.Utf8JsonWriter * obj * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> unitPublic Sub Serialize (writer As Utf8JsonWriter, value As Object, jsonTypeInfo As JsonTypeInfo)Parameter
- writer
- Utf8JsonWriter
Der zu schreibende Schreiber.
- value
- Object
Der zu konvertierende und zu schreibende Wert.
- jsonTypeInfo
- JsonTypeInfo
Metadaten zum zu konvertierenden Typ.
Ausnahmen
writer oder jsonTypeInfo ist null.
value stimmt nicht mit dem Typ von überein jsonTypeInfo.
Gilt für:
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions)
Schreibt die JSON-Darstellung des angegebenen Typs in den bereitgestellten Writer.
public static void Serialize (System.Text.Json.Utf8JsonWriter writer, object? value, Type inputType, System.Text.Json.JsonSerializerOptions? options = default);public static void Serialize (System.Text.Json.Utf8JsonWriter writer, object value, Type inputType, System.Text.Json.JsonSerializerOptions options = default);static member Serialize : System.Text.Json.Utf8JsonWriter * obj * Type * System.Text.Json.JsonSerializerOptions -> unitPublic Shared Sub Serialize (writer As Utf8JsonWriter, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing)Public Sub Serialize (writer As Utf8JsonWriter, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing)Parameter
- writer
- Utf8JsonWriter
Der JSON-Writer, in den geschrieben werden soll.
- value
- Object
Der zu konvertierende und zu schreibende Wert.
- inputType
- Type
Der Typ des value-Elements, das konvertiert werden soll.
- options
- JsonSerializerOptions
Optionen zum Steuern des Serialisierungsverhaltens.
Ausnahmen
inputType ist nicht mit value kompatibel.
writer oder inputType ist null.
Es ist keine kompatible JsonConverter-Klasse für inputType oder die serialisierbaren Member vorhanden.
Hinweise
Die JsonWriterOptions zum Erstellen der instance von Utf8JsonWriter verwendet wird, haben Vorrang vor demJsonSerializerOptions, wenn sie in Konflikt stehen. JsonWriterOptions.IndentedDaher werden , JsonWriterOptions.SkipValidationund JsonWriterOptions.Encoder beim Schreiben verwendet.
Weitere Informationen finden Sie unter Serialisieren und Deserialisieren von JSON.
Gilt für:
Serialize(Object, Type, JsonSerializerOptions)
Konvertiert den Wert eines angegebenen Typs in eine JSON-Zeichenfolge.
public static string Serialize (object? value, Type inputType, System.Text.Json.JsonSerializerOptions? options = default);public static string Serialize (object value, Type inputType, System.Text.Json.JsonSerializerOptions options = default);static member Serialize : obj * Type * System.Text.Json.JsonSerializerOptions -> stringPublic Shared Function Serialize (value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing) As StringPublic Function Serialize (value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing) As StringParameter
- value
- Object
Der zu konvertierende Wert.
- inputType
- Type
Der Typ des value-Elements, das konvertiert werden soll.
- options
- JsonSerializerOptions
Optionen zum Steuern des Konvertierungsverhaltens.
Gibt zurück
Die JSON-Zeichenfolgendarstellung des Werts.
Ausnahmen
inputType ist nicht mit value kompatibel.
inputType ist null.
Es ist keine kompatible JsonConverter-Klasse für inputType oder die serialisierbaren Member vorhanden.
Hinweise
Die Verwendung von ist String nicht so effizient wie die UTF-8-Codierung, da die Implementierung intern UTF-8 verwendet. Siehe auch SerializeToUtf8Bytes(Object, Type, JsonSerializerOptions) und SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken).
Weitere Informationen finden Sie unter Serialisieren und Deserialisieren von JSON.
Gilt für:
Serialize(Stream, Object, JsonTypeInfo)
Konvertiert den angegebenen Wert in UTF-8-codierten JSON-Text und schreibt ihn in den Stream.
public:
static void Serialize(System::IO::Stream ^ utf8Json, System::Object ^ value, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);public static void Serialize (System.IO.Stream utf8Json, object? value, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);static member Serialize : System.IO.Stream * obj * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> unitPublic Sub Serialize (utf8Json As Stream, value As Object, jsonTypeInfo As JsonTypeInfo)Parameter
- value
- Object
Der zu konvertierende Wert.
- jsonTypeInfo
- JsonTypeInfo
Metadaten zum zu konvertierenden Typ.
Ausnahmen
utf8Json ist null
value stimmt nicht mit dem Typ von überein jsonTypeInfo.
Gilt für:
Serialize(Object, JsonTypeInfo)
Konvertiert den angegebenen Wert in einen String.
public:
static System::String ^ Serialize(System::Object ^ value, System::Text::Json::Serialization::Metadata::JsonTypeInfo ^ jsonTypeInfo);public static string Serialize (object? value, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo);static member Serialize : obj * System.Text.Json.Serialization.Metadata.JsonTypeInfo -> stringPublic Function Serialize (value As Object, jsonTypeInfo As JsonTypeInfo) As StringParameter
- value
- Object
Der zu konvertierende Wert.
- jsonTypeInfo
- JsonTypeInfo
Metadaten zum zu konvertierenden Typ.
Gibt zurück
Eine String Darstellung des Werts.
Ausnahmen
jsonTypeInfo ist null
value stimmt nicht mit dem Typ von überein jsonTypeInfo.
Hinweise
Die Verwendung von ist String nicht so effizient wie die UTF-8-Codierung, da die Implementierung intern UTF-8 verwendet. Siehe auch SerializeToUtf8Bytes(Object, JsonTypeInfo) und SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken).
Gilt für:
Serialize(Object, Type, JsonSerializerContext)
Konvertiert den bereitgestellten Wert in einen String.
public:
static System::String ^ Serialize(System::Object ^ value, Type ^ inputType, System::Text::Json::Serialization::JsonSerializerContext ^ context);public static string Serialize (object? value, Type inputType, System.Text.Json.Serialization.JsonSerializerContext context);static member Serialize : obj * Type * System.Text.Json.Serialization.JsonSerializerContext -> stringPublic Function Serialize (value As Object, inputType As Type, context As JsonSerializerContext) As StringParameter
- value
- Object
Der zu konvertierende Wert.
- inputType
- Type
Der Typ des value-Elements, das konvertiert werden soll.
- context
- JsonSerializerContext
Ein Metadatenanbieter für serialisierbare Typen.
Gibt zurück
Eine String Darstellung des Werts.
Ausnahmen
Es ist keine kompatible JsonConverter-Klasse für inputType oder die serialisierbaren Member vorhanden.
Die GetTypeInfo(Type) -Methode der angegebenen context gibt für den zu konvertierenden Typ zurück null .
inputType oder context ist null.
Hinweise
Die Verwendung eines String ist nicht so effizient wie die Verwendung der UTF-8-Codierung, da die Implementierung intern UTF-8 verwendet. Siehe SerializeToUtf8Bytes(Object, Type, JsonSerializerContext) auch und SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken).
Gilt für:
Serialize<TValue>(TValue, JsonSerializerOptions)
Konvertiert den Wert eines von einem generischen Typparameter angegebenen Typs in eine JSON-Zeichenfolge.
public static string Serialize<TValue> (TValue value, System.Text.Json.JsonSerializerOptions? options = default);public static string Serialize<TValue> (TValue value, System.Text.Json.JsonSerializerOptions options = default);static member Serialize : 'Value * System.Text.Json.JsonSerializerOptions -> stringPublic Shared Function Serialize(Of TValue) (value As TValue, Optional options As JsonSerializerOptions = Nothing) As StringPublic Function Serialize(Of TValue) (value As TValue, Optional options As JsonSerializerOptions = Nothing) As StringTypparameter
- TValue
Der Typ des zu serialisierenden Werts.
Parameter
- value
- TValue
Der zu konvertierende Wert.
- options
- JsonSerializerOptions
Optionen zum Steuern des Serialisierungsverhaltens.
Gibt zurück
Eine JSON-Zeichenfolgendarstellung des Werts.
Ausnahmen
Es ist keine kompatible JsonConverter-Klasse für TValue oder die serialisierbaren Member vorhanden.
Hinweise
Die Verwendung eines String ist nicht so effizient wie die Verwendung der UTF-8-Codierung, da die Implementierung intern UTF-8 verwendet. Siehe auch SerializeToUtf8Bytes(Object, Type, JsonSerializerOptions) und SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken).
Weitere Informationen finden Sie unter Serialisieren und Deserialisieren von JSON.
Gilt für:
Serialize<TValue>(TValue, JsonTypeInfo<TValue>)
Konvertiert den bereitgestellten Wert in einen String.
public:
generic <typename TValue>
static System::String ^ Serialize(TValue value, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);public static string Serialize<TValue> (TValue value, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);static member Serialize : 'Value * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> stringPublic Function Serialize(Of TValue) (value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue)) As StringTypparameter
- TValue
Der Typ des zu serialisierenden Werts.
Parameter
- value
- TValue
Der zu konvertierende Wert.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadaten über den zu konvertierenden Typ.
Gibt zurück
Eine String Darstellung des Werts.
Ausnahmen
Es ist keine kompatible JsonConverter-Klasse für TValue oder die serialisierbaren Member vorhanden.
jsonTypeInfo ist null
Hinweise
Die Verwendung eines String ist nicht so effizient wie die Verwendung der UTF-8-Codierung, da die Implementierung intern UTF-8 verwendet. Siehe auch SerializeToUtf8Bytes<TValue>(TValue, JsonTypeInfo<TValue>) und SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken).
Gilt für:
Serialize<TValue>(Stream, TValue, JsonSerializerOptions)
Konvertiert den angegebenen Wert in UTF-8-codierten JSON-Text und schreibt ihn in .Stream
public static void Serialize<TValue> (System.IO.Stream utf8Json, TValue value, System.Text.Json.JsonSerializerOptions? options = default);static member Serialize : System.IO.Stream * 'Value * System.Text.Json.JsonSerializerOptions -> unitPublic Sub Serialize(Of TValue) (utf8Json As Stream, value As TValue, Optional options As JsonSerializerOptions = Nothing)Typparameter
- TValue
Der Typ des zu serialisierenden Werts.
Parameter
- value
- TValue
Der zu konvertierende Wert.
- options
- JsonSerializerOptions
Optionen zum Steuern des Konvertierungsverhaltens.
Ausnahmen
utf8Json ist null.
Es ist keine kompatible JsonConverter-Klasse für TValue oder die serialisierbaren Member vorhanden.
Gilt für:
Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>)
Konvertiert den angegebenen Wert in UTF-8-codierten JSON-Text und schreibt ihn in .Stream
public:
generic <typename TValue>
static void Serialize(System::IO::Stream ^ utf8Json, TValue value, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);public static void Serialize<TValue> (System.IO.Stream utf8Json, TValue value, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);static member Serialize : System.IO.Stream * 'Value * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> unitPublic Sub Serialize(Of TValue) (utf8Json As Stream, value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue))Typparameter
- TValue
Der Typ des zu serialisierenden Werts.
Parameter
- value
- TValue
Der zu konvertierende Wert.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadaten über den zu konvertierenden Typ.
Ausnahmen
utf8Json ist null.
Es ist keine kompatible JsonConverter-Klasse für TValue oder die serialisierbaren Member vorhanden.
Gilt für:
Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions)
Schreibt die JSON-Darstellung eines Typs, der von einem generischen Typparameter angegeben wird, in den bereitgestellten Writer.
public static void Serialize<TValue> (System.Text.Json.Utf8JsonWriter writer, TValue value, System.Text.Json.JsonSerializerOptions? options = default);public static void Serialize<TValue> (System.Text.Json.Utf8JsonWriter writer, TValue value, System.Text.Json.JsonSerializerOptions options = default);static member Serialize : System.Text.Json.Utf8JsonWriter * 'Value * System.Text.Json.JsonSerializerOptions -> unitPublic Shared Sub Serialize(Of TValue) (writer As Utf8JsonWriter, value As TValue, Optional options As JsonSerializerOptions = Nothing)Public Sub Serialize(Of TValue) (writer As Utf8JsonWriter, value As TValue, Optional options As JsonSerializerOptions = Nothing)Typparameter
- TValue
Der Typ des zu serialisierenden Werts.
Parameter
- writer
- Utf8JsonWriter
Ein JSON-Writer, in den geschrieben werden soll.
- value
- TValue
Der zu konvertierende und zu schreibende Wert.
- options
- JsonSerializerOptions
Optionen zum Steuern des Serialisierungsverhaltens.
Ausnahmen
writer ist null.
Es ist keine kompatible JsonConverter-Klasse für TValue oder die serialisierbaren Member vorhanden.
Hinweise
Die JsonWriterOptions , die zum Erstellen der instance von Utf8JsonWriter verwendet wird, haben Vorrang vor demJsonSerializerOptions, wenn sie in Konflikt stehen. JsonWriterOptions.IndentedDaher werden , JsonWriterOptions.SkipValidationund JsonWriterOptions.Encoder beim Schreiben verwendet.
Weitere Informationen finden Sie unter Serialisieren und Deserialisieren von JSON.
Gilt für:
Serialize<TValue>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>)
Schreibt einen JSON-Wert (einschließlich Objekten oder Arrays) in den bereitgestellten Writer.
public:
generic <typename TValue>
static void Serialize(System::Text::Json::Utf8JsonWriter ^ writer, TValue value, System::Text::Json::Serialization::Metadata::JsonTypeInfo<TValue> ^ jsonTypeInfo);public static void Serialize<TValue> (System.Text.Json.Utf8JsonWriter writer, TValue value, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo);static member Serialize : System.Text.Json.Utf8JsonWriter * 'Value * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> -> unitPublic Sub Serialize(Of TValue) (writer As Utf8JsonWriter, value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue))Typparameter
- TValue
Der Typ des zu serialisierenden Werts.
Parameter
- writer
- Utf8JsonWriter
Der zu schreibende Writer.
- value
- TValue
Der zu konvertierende und zu schreibende Wert.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadaten über den zu konvertierenden Typ.
Ausnahmen
writer oder jsonTypeInfo ist null.
Es ist keine kompatible JsonConverter-Klasse für TValue oder die serialisierbaren Member vorhanden.
Gilt für:
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für