JsonSerializer.Serialize Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přetížení
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext) |
Zapíše jednu hodnotu JSON (včetně objektů nebo polí) do zadaného zapisovače. |
Serialize(Stream, Object, Type, JsonSerializerContext) |
Převede zadanou hodnotu na text JSON s kódováním UTF-8 a zapíše ji do objektu Stream. |
Serialize(Stream, Object, Type, JsonSerializerOptions) |
Převede zadanou hodnotu na text JSON s kódováním UTF-8 a zapíše ji do objektu Stream. |
Serialize(Utf8JsonWriter, Object, JsonTypeInfo) |
Zapíše jednu hodnotu JSON (včetně objektů nebo polí) do zadaného zapisovače. |
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions) |
Zapíše reprezentaci JSON zadaného typu do zadaného zapisovače. |
Serialize(Object, Type, JsonSerializerOptions) |
Převede hodnotu zadaného typu na řetězec JSON. |
Serialize(Stream, Object, JsonTypeInfo) |
Převede zadanou hodnotu na text JSON s kódováním UTF-8 a zapíše ji do objektu Stream. |
Serialize(Object, JsonTypeInfo) |
Převede zadanou hodnotu na String. |
Serialize(Object, Type, JsonSerializerContext) |
Převede zadanou hodnotu na String. |
Serialize<TValue>(TValue, JsonSerializerOptions) |
Převede hodnotu typu určeného parametrem obecného typu na řetězec JSON. |
Serialize<TValue>(TValue, JsonTypeInfo<TValue>) |
Převede zadanou hodnotu na String. |
Serialize<TValue>(Stream, TValue, JsonSerializerOptions) |
Převede zadanou hodnotu na text JSON s kódováním UTF-8 a zapíše ji do objektu Stream. |
Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>) |
Převede zadanou hodnotu na text JSON s kódováním UTF-8 a zapíše ji do objektu Stream. |
Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions) |
Zapíše reprezentaci JSON typu určeného parametrem obecného typu do zadaného zapisovače. |
Serialize<TValue>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>) |
Zapíše jednu hodnotu JSON (včetně objektů nebo polí) do zadaného zapisovače. |
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext)
Zapíše jednu hodnotu JSON (včetně objektů nebo polí) do zadaného zapisovače.
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)
Parametry
- writer
- Utf8JsonWriter
Zapisovač JSON, do který se má zapisovat.
- value
- Object
Hodnota, která se má převést a zapsat.
- inputType
- Type
Typ value
převést.
- context
- JsonSerializerContext
Zprostředkovatel metadat pro serializovatelné typy.
Výjimky
inputType
není kompatibilní s value
nástrojem .
writer
nebo inputType
je null
.
Neexistuje žádný kompatibilní JsonConverter pro inputType
nebo jeho serializovatelné členy.
Metoda GetTypeInfo(Type) zadané context
null
vrátí pro typ k převodu.
Platí pro
Serialize(Stream, Object, Type, JsonSerializerContext)
Převede zadanou hodnotu na text JSON s kódováním UTF-8 a zapíše ji do objektu 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)
Parametry
- value
- Object
Hodnota, kterou chcete převést.
- inputType
- Type
Typ value
převést.
- context
- JsonSerializerContext
Zprostředkovatel metadat pro serializovatelné typy.
Výjimky
inputType
není kompatibilní s value
nástrojem .
utf8Json
, inputType
nebo context
je null
.
Neexistuje žádný kompatibilní JsonConverter pro inputType
nebo jeho serializovatelné členy.
Platí pro
Serialize(Stream, Object, Type, JsonSerializerOptions)
Převede zadanou hodnotu na text JSON s kódováním UTF-8 a zapíše ji do objektu 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)
Parametry
- value
- Object
Hodnota, kterou chcete převést.
- inputType
- Type
Typ value
převést.
- options
- JsonSerializerOptions
Možnosti pro řízení chování převodu.
Výjimky
inputType
není kompatibilní s value
nástrojem .
utf8Json
nebo inputType
je null
.
Neexistuje žádný kompatibilní JsonConverter pro inputType
nebo jeho serializovatelné členy.
Platí pro
Serialize(Utf8JsonWriter, Object, JsonTypeInfo)
Zapíše jednu hodnotu JSON (včetně objektů nebo polí) do zadaného zapisovače.
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)
Parametry
- writer
- Utf8JsonWriter
Autor, který má psát.
- value
- Object
Hodnota, která se má převést a zapsat.
- jsonTypeInfo
- JsonTypeInfo
Metadata o typu, který se má převést.
Výjimky
writer
nebo jsonTypeInfo
je null
.
value
neodpovídá typu jsonTypeInfo
.
Platí pro
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions)
Zapíše reprezentaci JSON zadaného typu do zadaného zapisovače.
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 -> unit
Public 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)
Parametry
- writer
- Utf8JsonWriter
Zapisovač JSON, do který se má zapisovat.
- value
- Object
Hodnota, která se má převést a zapsat.
- inputType
- Type
Typ value
převést.
- options
- JsonSerializerOptions
Možnosti řízení chování serializace.
Výjimky
inputType
není kompatibilní s value
writer
nebo inputType
je null
.
Neexistuje žádný kompatibilní JsonConverter pro inputType
nebo jeho serializovatelné členy.
Poznámky
Objekt JsonWriterOptions použitý k vytvoření instance Utf8JsonWriter má přednost před JsonSerializerOptions , když jsou v konfliktu. Proto se JsonWriterOptions.Indentedpři psaní používají , JsonWriterOptions.SkipValidationa JsonWriterOptions.Encoder .
Další informace najdete v tématu Jak serializovat a deserializovat JSON.
Platí pro
Serialize(Object, Type, JsonSerializerOptions)
Převede hodnotu zadaného typu na řetězec JSON.
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 -> string
Public Shared Function Serialize (value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing) As String
Public Function Serialize (value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing) As String
Parametry
- value
- Object
Hodnota, kterou chcete převést.
- inputType
- Type
Typ value
převést.
- options
- JsonSerializerOptions
Možnosti pro řízení chování převodu.
Návraty
Řetězcová reprezentace hodnoty JSON.
Výjimky
inputType
není kompatibilní s value
nástrojem .
inputType
je null
.
Neexistuje žádný kompatibilní JsonConverter pro inputType
nebo jeho serializovatelné členy.
Poznámky
String Použití není tak efektivní jako použití kódování UTF-8, protože implementace interně používá UTF-8. Viz také SerializeToUtf8Bytes(Object, Type, JsonSerializerOptions) a SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken).
Další informace najdete v tématu Jak serializovat a deserializovat JSON.
Platí pro
Serialize(Stream, Object, JsonTypeInfo)
Převede zadanou hodnotu na text JSON s kódováním UTF-8 a zapíše ji do objektu 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)
Parametry
- value
- Object
Hodnota, kterou chcete převést.
- jsonTypeInfo
- JsonTypeInfo
Metadata o typu, který se má převést.
Výjimky
utf8Json
je null
.
value
neodpovídá typu jsonTypeInfo
.
Platí pro
Serialize(Object, JsonTypeInfo)
Převede zadanou hodnotu na 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 -> string
Public Function Serialize (value As Object, jsonTypeInfo As JsonTypeInfo) As String
Parametry
- value
- Object
Hodnota, kterou chcete převést.
- jsonTypeInfo
- JsonTypeInfo
Metadata o typu, který se má převést.
Návraty
Reprezentace String hodnoty.
Výjimky
jsonTypeInfo
je null
.
value
neodpovídá typu jsonTypeInfo
.
Poznámky
String Použití není tak efektivní jako použití kódování UTF-8, protože implementace interně používá UTF-8. Viz také SerializeToUtf8Bytes(Object, JsonTypeInfo) a SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken).
Platí pro
Serialize(Object, Type, JsonSerializerContext)
Převede zadanou hodnotu na 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 -> string
Public Function Serialize (value As Object, inputType As Type, context As JsonSerializerContext) As String
Parametry
- value
- Object
Hodnota, kterou chcete převést.
- inputType
- Type
Typ value
převést.
- context
- JsonSerializerContext
Zprostředkovatel metadat pro serializovatelné typy.
Návraty
Reprezentace String hodnoty.
Výjimky
Neexistuje žádný kompatibilní JsonConverter pro inputType
nebo jeho serializovatelné členy.
Metoda GetTypeInfo(Type) zadaného context
návratu null
pro typ, který se má převést.
inputType
nebo context
je null
.
Poznámky
String Použití není tak efektivní jako použití kódování UTF-8, protože implementace interně používá UTF-8. Viz SerializeToUtf8Bytes(Object, Type, JsonSerializerContext) také a SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken).
Platí pro
Serialize<TValue>(TValue, JsonSerializerOptions)
Převede hodnotu typu určeného parametrem obecného typu na řetězec JSON.
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 -> string
Public Shared Function Serialize(Of TValue) (value As TValue, Optional options As JsonSerializerOptions = Nothing) As String
Public Function Serialize(Of TValue) (value As TValue, Optional options As JsonSerializerOptions = Nothing) As String
Parametry typu
- TValue
Typ hodnoty, která se má serializovat.
Parametry
- value
- TValue
Hodnota, kterou chcete převést.
- options
- JsonSerializerOptions
Možnosti řízení chování serializace.
Návraty
Řetězcová reprezentace hodnoty JSON
Výjimky
Neexistuje žádný kompatibilní JsonConverter pro TValue
serializovatelné členy nebo.
Poznámky
String Použití není tak efektivní jako použití kódování UTF-8, protože implementace interně používá UTF-8. Viz také SerializeToUtf8Bytes(Object, Type, JsonSerializerOptions) a SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken).
Další informace najdete v tématu Jak serializovat a deserializovat JSON.
Platí pro
Serialize<TValue>(TValue, JsonTypeInfo<TValue>)
Převede zadanou hodnotu na 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> -> string
Public Function Serialize(Of TValue) (value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue)) As String
Parametry typu
- TValue
Typ hodnoty, která se má serializovat.
Parametry
- value
- TValue
Hodnota, kterou chcete převést.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadata o typu, který se má převést.
Návraty
Reprezentace String hodnoty.
Výjimky
Neexistuje žádný kompatibilní JsonConverter pro TValue
serializovatelné členy nebo.
jsonTypeInfo
je null
.
Poznámky
String Použití není tak efektivní jako použití kódování UTF-8, protože implementace interně používá UTF-8. Viz také SerializeToUtf8Bytes<TValue>(TValue, JsonTypeInfo<TValue>) a SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken).
Platí pro
Serialize<TValue>(Stream, TValue, JsonSerializerOptions)
Převede zadanou hodnotu na text JSON s kódováním UTF-8 a zapíše ji do 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)
Parametry typu
- TValue
Typ hodnoty, která se má serializovat.
Parametry
- value
- TValue
Hodnota, kterou chcete převést.
- options
- JsonSerializerOptions
Možnosti řízení chování převodu
Výjimky
utf8Json
je null
.
Neexistuje žádný kompatibilní JsonConverter pro TValue
serializovatelné členy nebo.
Platí pro
Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>)
Převede zadanou hodnotu na text JSON s kódováním UTF-8 a zapíše ji do 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))
Parametry typu
- TValue
Typ hodnoty, která se má serializovat.
Parametry
- value
- TValue
Hodnota, kterou chcete převést.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadata o typu, který se má převést.
Výjimky
utf8Json
je null
.
Neexistuje žádný kompatibilní JsonConverter pro TValue
serializovatelné členy nebo.
Platí pro
Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions)
Zapíše reprezentaci JSON typu určeného parametrem obecného typu do zadaného zapisovače.
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 -> unit
Public 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)
Parametry typu
- TValue
Typ hodnoty, která se má serializovat.
Parametry
- writer
- Utf8JsonWriter
Zapisovač JSON, do který se má zapisovat.
- value
- TValue
Hodnota, která se má převést a zapsat.
- options
- JsonSerializerOptions
Možnosti řízení chování serializace.
Výjimky
writer
je null
.
Neexistuje žádný kompatibilní JsonConverter pro TValue
serializovatelné členy nebo.
Poznámky
Objekt JsonWriterOptions použitý k vytvoření instance Utf8JsonWriter má přednost před konfliktem JsonSerializerOptions . Proto se JsonWriterOptions.Indentedpři psaní používají , JsonWriterOptions.SkipValidationa JsonWriterOptions.Encoder .
Další informace najdete v tématu Jak serializovat a deserializovat JSON.
Platí pro
Serialize<TValue>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>)
Zapíše do zadaného zapisovače jednu hodnotu JSON (včetně objektů nebo polí).
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))
Parametry typu
- TValue
Typ hodnoty, která se má serializovat.
Parametry
- writer
- Utf8JsonWriter
Spisovatel, který má psát.
- value
- TValue
Hodnota, která se má převést a zapsat.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadata o typu, který se má převést.
Výjimky
writer
nebo jsonTypeInfo
je null
.
Neexistuje žádný kompatibilní JsonConverter pro TValue
serializovatelné členy nebo.
Platí pro
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro