JsonSerializer.Serialize Methode

Definition

Namespace:

System.Text.Json

Assembly:

System.Text.Json.dll

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

Quelle:

JsonSerializer.Write.Stream.cs

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

Public Sub Serialize (utf8Json As Stream, value As Object, inputType As Type, context As JsonSerializerContext)

Parameter

utf8Json

Stream

Der UTF-8-Stream, in den geschrieben werden soll.

value

Object

Der zu konvertierende Wert.

inputType

Type

Der Typ des zu konvertierenden value.

context

JsonSerializerContext

Ein Metadatenanbieter für serialisierbare Typen.

Ausnahmen

ArgumentException

inputType ist nicht mit valuekompatibel.

ArgumentNullException

utf8Json, inputTypeoder context ist null.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für inputType oder die serialisierbaren Member.

Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext)

Quelle:

JsonSerializer.Write.Utf8JsonWriter.cs

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

Public 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

ArgumentException

inputType ist nicht mit valuekompatibel.

ArgumentNullException

writer oder inputType ist null.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für inputType oder die serialisierbaren Member.

InvalidOperationException

Die GetTypeInfo(Type) Methode der bereitgestellten context gibt null für den zu konvertierenden Typ zurück.

Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions)

Quelle:

JsonSerializer.Write.Utf8JsonWriter.cs

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

static member Serialize : System.Text.Json.Utf8JsonWriter * obj * Type * System.Text.Json.JsonSerializerOptions -> unit

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

ArgumentException

inputType ist nicht kompatibel mit value

ArgumentNullException

writer oder inputType ist null.

NotSupportedException

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.

Serialize(Utf8JsonWriter, Object, JsonTypeInfo)

Quelle:

JsonSerializer.Write.Utf8JsonWriter.cs

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

Public 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

ArgumentNullException

writer oder jsonTypeInfo ist null.

InvalidCastException

value stimmt nicht mit dem Typ der jsonTypeInfoüberein.

Serialize(Stream, Object, Type, JsonSerializerOptions)

Quelle:

JsonSerializer.Write.Stream.cs

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

Public Sub Serialize (utf8Json As Stream, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing)

Parameter

utf8Json

Stream

Der UTF-8-Stream, in den geschrieben werden soll.

value

Object

Der zu konvertierende Wert.

inputType

Type

Der Typ des zu konvertierenden value.

options

JsonSerializerOptions

Optionen zum Steuern des Konvertierungsverhaltens.

Ausnahmen

ArgumentException

inputType ist nicht mit valuekompatibel.

ArgumentNullException

utf8Json oder inputType ist null.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für inputType oder die serialisierbaren Member.

Serialize(Object, Type, JsonSerializerOptions)

Quelle:

JsonSerializer.Write.String.cs

Konvertiert den Wert eines angegebenen Typs in eine JSON-Zeichenfolge.

public static string Serialize (object? value, Type inputType, System.Text.Json.JsonSerializerOptions? options = default);

static member Serialize : obj * Type * System.Text.Json.JsonSerializerOptions -> string

Public Function Serialize (value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing) As String

Parameter

value

Object

Der zu konvertierende Wert.

inputType

Type

Der Typ des zu konvertierenden value.

options

JsonSerializerOptions

Optionen zum Steuern des Konvertierungsverhaltens.

Gibt zurück

String

Die JSON-Zeichenfolgendarstellung des Werts.

Ausnahmen

ArgumentException

inputType ist nicht mit valuekompatibel.

ArgumentNullException

inputType ist null.

NotSupportedException

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.

Serialize(Stream, Object, JsonTypeInfo)

Quelle:

JsonSerializer.Write.Stream.cs

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

Public Sub Serialize (utf8Json As Stream, value As Object, jsonTypeInfo As JsonTypeInfo)

Parameter

utf8Json

Stream

Der UTF-8-Stream, in den geschrieben werden soll.

value

Object

Der zu konvertierende Wert.

jsonTypeInfo

JsonTypeInfo

Metadaten zum zu konvertierenden Typ.

Ausnahmen

ArgumentNullException

utf8Json ist null.

InvalidCastException

value stimmt nicht mit dem Typ der jsonTypeInfoüberein.

Serialize(Object, JsonTypeInfo)

Quelle:

JsonSerializer.Write.String.cs

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

Public Function Serialize (value As Object, jsonTypeInfo As JsonTypeInfo) As String

Parameter

value

Object

Der zu konvertierende Wert.

jsonTypeInfo

JsonTypeInfo

Metadaten zum zu konvertierenden Typ.

Gibt zurück

String

Eine String Darstellung des Werts.

Ausnahmen

ArgumentNullException

jsonTypeInfo ist null.

InvalidCastException

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

Serialize(Object, Type, JsonSerializerContext)

Quelle:

JsonSerializer.Write.String.cs

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

Public Function Serialize (value As Object, inputType As Type, context As JsonSerializerContext) As String

Parameter

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

String

Eine String Darstellung des Werts.

Ausnahmen

NotSupportedException

Es gibt keine kompatiblen JsonConverter für inputType oder die serialisierbaren Member.

InvalidOperationException

Die GetTypeInfo(Type) Methode der bereitgestellten context gibt null für den zu konvertierenden Typ zurück.

ArgumentNullException

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

Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions)

Quelle:

JsonSerializer.Write.Utf8JsonWriter.cs

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

static member Serialize : System.Text.Json.Utf8JsonWriter * 'Value * System.Text.Json.JsonSerializerOptions -> unit

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

ArgumentNullException

writer ist null.

NotSupportedException

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.

Serialize<TValue>(TValue, JsonSerializerOptions)

Quelle:

JsonSerializer.Write.String.cs

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

static member Serialize : 'Value * System.Text.Json.JsonSerializerOptions -> string

Public Function Serialize(Of TValue) (value As TValue, Optional options As JsonSerializerOptions = Nothing) As String

Typparameter

TValue

Der Typ des zu serialisierenden Werts.

Parameter

value

TValue

Der zu konvertierende Wert.

options

JsonSerializerOptions

Optionen zum Steuern des Serialisierungsverhaltens.

Gibt zurück

String

Eine JSON-Zeichenfolgendarstellung des Werts.

Ausnahmen

NotSupportedException

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.

Serialize<TValue>(TValue, JsonTypeInfo<TValue>)

Quelle:

JsonSerializer.Write.String.cs

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

Public Function Serialize(Of TValue) (value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue)) As String

Typparameter

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

String

Eine String Darstellung des Werts.

Ausnahmen

NotSupportedException

Es gibt keine kompatiblen JsonConverter für TValue oder die serialisierbaren Member.

ArgumentNullException

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

Serialize<TValue>(Stream, TValue, JsonSerializerOptions)

Quelle:

JsonSerializer.Write.Stream.cs

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

Public Sub Serialize(Of TValue) (utf8Json As Stream, value As TValue, Optional options As JsonSerializerOptions = Nothing)

Typparameter

TValue

Der Typ des zu serialisierenden Werts.

Parameter

utf8Json

Stream

Der UTF-8-Stream, in den geschrieben werden soll.

value

TValue

Der zu konvertierende Wert.

options

JsonSerializerOptions

Optionen zum Steuern des Konvertierungsverhaltens.

Ausnahmen

ArgumentNullException

utf8Json ist null.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für TValue oder die serialisierbaren Member.

Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>)

Quelle:

JsonSerializer.Write.Stream.cs

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

Public Sub Serialize(Of TValue) (utf8Json As Stream, value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue))

Typparameter

TValue

Der Typ des zu serialisierenden Werts.

Parameter

utf8Json

Stream

Der UTF-8-Stream, in den geschrieben werden soll.

value

TValue

Der zu konvertierende Wert.

jsonTypeInfo

JsonTypeInfo<TValue>

Metadaten zum zu konvertierenden Typ.

Ausnahmen

ArgumentNullException

utf8Json ist null.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für TValue oder die serialisierbaren Member.

Serialize<TValue>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>)

Quelle:

JsonSerializer.Write.Utf8JsonWriter.cs

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

Public 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

ArgumentNullException

writer oder jsonTypeInfo ist null.

NotSupportedException

Es gibt keine kompatiblen JsonConverter für TValue oder die serialisierbaren Member.