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(Stream, Object, Type, JsonSerializerContext) |
Konvertiert den bereitgestellten Wert in UTF-8-codierten JSON-Text und schreibt ihn in den Stream. |
| Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext) |
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(Utf8JsonWriter, Object, JsonTypeInfo) |
Schreibt einen JSON-Wert (einschließlich Objekte oder Arrays) in den bereitgestellten Writer. |
| Serialize(Stream, Object, Type, JsonSerializerOptions) |
Konvertiert den bereitgestellten Wert in UTF-8-codierten JSON-Text und schreibt ihn in den Stream. |
| Serialize(Object, Type, JsonSerializerOptions) |
Konvertiert den Wert eines angegebenen Typs in eine JSON-Zeichenfolge. |
| Serialize(Stream, Object, JsonTypeInfo) |
Konvertiert den bereitgestellten Wert in UTF-8-codierten JSON-Text und schreibt ihn in den Stream. |
| Serialize(Object, JsonTypeInfo) |
Wandelt den bereitgestellten Wert in eine Stringum. |
| Serialize(Object, Type, JsonSerializerContext) |
Wandelt den bereitgestellten Wert in eine Stringum. |
| Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions) |
Schreibt die JSON-Darstellung eines Typs, der durch einen generischen Typparameter angegeben wird, in den bereitgestellten Writer. |
| Serialize<TValue>(TValue, JsonSerializerOptions) |
Konvertiert den Wert eines Typs, der durch einen generischen Typparameter angegeben wird, in eine JSON-Zeichenfolge. |
| Serialize<TValue>(TValue, JsonTypeInfo<TValue>) |
Wandelt den bereitgestellten Wert in eine Stringum. |
| Serialize<TValue>(Stream, TValue, JsonSerializerOptions) |
Konvertiert den bereitgestellten Wert in UTF-8-codierten JSON-Text und schreibt ihn in den Stream. |
| Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>) |
Konvertiert den bereitgestellten Wert in UTF-8-codierten JSON-Text und schreibt ihn in den Stream. |
| Serialize<TValue>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>) |
Schreibt einen JSON-Wert (einschließlich Objekte oder Arrays) in den bereitgestellten Writer. |
Serialize(Stream, Object, Type, JsonSerializerContext)
Konvertiert den bereitgestellten 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 zu konvertierenden value.
- context
- JsonSerializerContext
Ein Metadatenanbieter für serialisierbare Typen.
Ausnahmen
inputType ist nicht mit valuekompatibel.
utf8Json, inputTypeoder context ist null.
Es gibt keine kompatiblen JsonConverter für inputType oder die serialisierbaren Member.
Gilt für:
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 wert, der konvertiert und geschrieben werden soll.
- inputType
- Type
Der Typ des zu konvertierenden value.
- context
- JsonSerializerContext
Ein Metadatenanbieter für serialisierbare Typen.
Ausnahmen
inputType ist nicht mit valuekompatibel.
writer oder inputType ist null.
Es gibt keine kompatiblen JsonConverter für inputType oder die serialisierbaren Member.
Die GetTypeInfo(Type) Methode der bereitgestellten context gibt null für den zu konvertierenden Typ zurück.
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 wert, der konvertiert und geschrieben werden soll.
- inputType
- Type
Der Typ des zu konvertierenden value.
- options
- JsonSerializerOptions
Optionen zum Steuern des Serialisierungsverhaltens.
Ausnahmen
inputType ist nicht kompatibel mit value
writer oder inputType ist null.
Es gibt keine kompatiblen JsonConverter für inputType oder die serialisierbaren Member.
Hinweise
Die JsonWriterOptions, die zum Erstellen der Instanz der Utf8JsonWriter verwendet wird, hat Vorrang vor dem JsonSerializerOptions, wenn ein Konflikt auftritt. Daher werden JsonWriterOptions.Indented, JsonWriterOptions.SkipValidationund JsonWriterOptions.Encoder beim Schreiben verwendet.
Weitere Informationen finden Sie unter How to serialize and deserialize JSON.
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 Autor.
- value
- Object
Der wert, der konvertiert und geschrieben werden soll.
- jsonTypeInfo
- JsonTypeInfo
Metadaten zum zu konvertierenden Typ.
Ausnahmen
writer oder jsonTypeInfo ist null.
value stimmt nicht mit dem Typ der jsonTypeInfoüberein.
Gilt für:
Serialize(Stream, Object, Type, JsonSerializerOptions)
Konvertiert den bereitgestellten 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 zu konvertierenden value.
- options
- JsonSerializerOptions
Optionen zum Steuern des Konvertierungsverhaltens.
Ausnahmen
inputType ist nicht mit valuekompatibel.
utf8Json oder inputType ist null.
Es gibt keine kompatiblen JsonConverter für inputType oder die serialisierbaren Member.
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 zu konvertierenden value.
- options
- JsonSerializerOptions
Optionen zum Steuern des Konvertierungsverhaltens.
Gibt zurück
Die JSON-Zeichenfolgendarstellung des Werts.
Ausnahmen
inputType ist nicht mit valuekompatibel.
inputType ist null.
Es gibt keine kompatiblen JsonConverter für inputType oder die serialisierbaren Member.
Hinweise
Die Verwendung eines String ist nicht so effizient wie die Verwendung von 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 How to serialize and deserialize JSON.
Gilt für:
Serialize(Stream, Object, JsonTypeInfo)
Konvertiert den bereitgestellten 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 der jsonTypeInfoüberein.
Gilt für:
Serialize(Object, JsonTypeInfo)
Wandelt den bereitgestellten Wert in eine Stringum.
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 der jsonTypeInfoüberein.
Hinweise
Die Verwendung eines String ist nicht so effizient wie die Verwendung von 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)
Wandelt den bereitgestellten Wert in eine Stringum.
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 zu konvertierenden value.
- context
- JsonSerializerContext
Ein Metadatenanbieter für serialisierbare Typen.
Gibt zurück
Eine String Darstellung des Werts.
Ausnahmen
Es gibt keine kompatiblen JsonConverter für inputType oder die serialisierbaren Member.
Die GetTypeInfo(Type) Methode der bereitgestellten context gibt null für den zu konvertierenden Typ zurück.
inputType oder context ist null.
Hinweise
Die Verwendung eines String ist nicht so effizient wie die Verwendung von UTF-8-Codierung, da die Implementierung intern UTF-8 verwendet. Siehe auch SerializeToUtf8Bytes(Object, Type, JsonSerializerContext) und SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken).
Gilt für:
Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions)
Schreibt die JSON-Darstellung eines Typs, der durch einen 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 wert, der konvertiert und geschrieben werden soll.
- options
- JsonSerializerOptions
Optionen zum Steuern des Serialisierungsverhaltens.
Ausnahmen
writer ist null.
Es gibt keine kompatiblen JsonConverter für TValue oder die serialisierbaren Member.
Hinweise
Die JsonWriterOptions, die zum Erstellen der Instanz der Utf8JsonWriter verwendet wird, hat Vorrang vor dem JsonSerializerOptions, wenn ein Konflikt auftritt. Daher werden JsonWriterOptions.Indented, JsonWriterOptions.SkipValidationund JsonWriterOptions.Encoder beim Schreiben verwendet.
Weitere Informationen finden Sie unter How to serialize and deserialize JSON.
Gilt für:
Serialize<TValue>(TValue, JsonSerializerOptions)
Konvertiert den Wert eines Typs, der durch einen generischen Typparameter angegeben wird, 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 gibt keine kompatiblen JsonConverter für TValue oder die serialisierbaren Member.
Hinweise
Die Verwendung eines String ist nicht so effizient wie die Verwendung von 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 How to serialize and deserialize JSON.
Gilt für:
Serialize<TValue>(TValue, JsonTypeInfo<TValue>)
Wandelt den bereitgestellten Wert in eine Stringum.
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 zum zu konvertierenden Typ.
Gibt zurück
Eine String Darstellung des Werts.
Ausnahmen
Es gibt keine kompatiblen JsonConverter für TValue oder die serialisierbaren Member.
jsonTypeInfo ist null.
Hinweise
Die Verwendung eines String ist nicht so effizient wie die Verwendung von 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 bereitgestellten Wert in UTF-8-codierten JSON-Text und schreibt ihn in den 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 gibt keine kompatiblen JsonConverter für TValue oder die serialisierbaren Member.
Gilt für:
Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>)
Konvertiert den bereitgestellten Wert in UTF-8-codierten JSON-Text und schreibt ihn in den 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 zum zu konvertierenden Typ.
Ausnahmen
utf8Json ist null.
Es gibt keine kompatiblen JsonConverter für TValue oder die serialisierbaren Member.
Gilt für:
Serialize<TValue>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>)
Schreibt einen JSON-Wert (einschließlich Objekte 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 Autor.
- value
- TValue
Der wert, der konvertiert und geschrieben werden soll.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadaten zum zu konvertierenden Typ.
Ausnahmen
writer oder jsonTypeInfo ist null.
Es gibt keine kompatiblen JsonConverter für TValue oder die serialisierbaren Member.
