JsonSerializer.Serialize Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Przeciążenia
Serialize(Stream, Object, Type, JsonSerializerContext) |
Konwertuje podaną wartość na tekst JSON zakodowany w formacie UTF-8 i zapisuje go w Stream. |
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext) |
Zapisuje jedną wartość JSON (w tym obiekty lub tablice) do dostarczonego składnika zapisywania. |
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions) |
Zapisuje reprezentację JSON określonego typu w podanym składniku zapisywania. |
Serialize(Utf8JsonWriter, Object, JsonTypeInfo) |
Zapisuje jedną wartość JSON (w tym obiekty lub tablice) do dostarczonego składnika zapisywania. |
Serialize(Stream, Object, Type, JsonSerializerOptions) |
Konwertuje podaną wartość na tekst JSON zakodowany w formacie UTF-8 i zapisuje go w Stream. |
Serialize(Object, Type, JsonSerializerOptions) |
Konwertuje wartość określonego typu na ciąg JSON. |
Serialize(Stream, Object, JsonTypeInfo) |
Konwertuje podaną wartość na tekst JSON zakodowany w formacie UTF-8 i zapisuje go w Stream. |
Serialize(Object, JsonTypeInfo) |
Konwertuje podaną wartość na String. |
Serialize(Object, Type, JsonSerializerContext) |
Konwertuje podaną wartość na String. |
Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions) |
Zapisuje reprezentację JSON typu określonego przez ogólny parametr typu do dostarczonego składnika zapisywania. |
Serialize<TValue>(TValue, JsonSerializerOptions) |
Konwertuje wartość typu określonego przez parametr typu ogólnego na ciąg JSON. |
Serialize<TValue>(TValue, JsonTypeInfo<TValue>) |
Konwertuje podaną wartość na String. |
Serialize<TValue>(Stream, TValue, JsonSerializerOptions) |
Konwertuje podaną wartość na tekst JSON zakodowany w formacie UTF-8 i zapisuje go w Stream. |
Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>) |
Konwertuje podaną wartość na tekst JSON zakodowany w formacie UTF-8 i zapisuje go w Stream. |
Serialize<TValue>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>) |
Zapisuje jedną wartość JSON (w tym obiekty lub tablice) do dostarczonego składnika zapisywania. |
Serialize(Stream, Object, Type, JsonSerializerContext)
Konwertuje podaną wartość na tekst JSON zakodowany w formacie UTF-8 i zapisuje go w 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
Wartość do przekonwertowania.
- inputType
- Type
Typ value
do konwersji.
- context
- JsonSerializerContext
Dostawca metadanych dla typów możliwych do serializacji.
Wyjątki
inputType
nie jest zgodny z value
.
utf8Json
, inputType
lub context
jest null
.
Nie ma zgodnych JsonConverter dla inputType
ani jego składowych z możliwością serializacji.
Dotyczy
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext)
Zapisuje jedną wartość JSON (w tym obiekty lub tablice) do dostarczonego składnika zapisywania.
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
Zapis w formacie JSON do zapisu.
- value
- Object
Wartość do konwersji i zapisu.
- inputType
- Type
Typ value
do konwersji.
- context
- JsonSerializerContext
Dostawca metadanych dla typów możliwych do serializacji.
Wyjątki
inputType
nie jest zgodny z value
.
writer
lub inputType
jest null
.
Nie ma zgodnych JsonConverter dla inputType
ani jego składowych z możliwością serializacji.
Metoda GetTypeInfo(Type) podanej context
zwraca null
dla typu do konwersji.
Dotyczy
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions)
Zapisuje reprezentację JSON określonego typu w podanym składniku zapisywania.
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
Zapis w formacie JSON do zapisu.
- value
- Object
Wartość do konwersji i zapisu.
- inputType
- Type
Typ value
do konwersji.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania serializacji.
Wyjątki
inputType
nie jest zgodna z value
writer
lub inputType
jest null
.
Nie ma zgodnych JsonConverter dla inputType
ani jego składowych z możliwością serializacji.
Uwagi
JsonWriterOptions użyte do utworzenia wystąpienia Utf8JsonWriter mają pierwszeństwo przed JsonSerializerOptions w przypadku konfliktu. W związku z tym JsonWriterOptions.Indented, JsonWriterOptions.SkipValidationi JsonWriterOptions.Encoder są używane podczas pisania.
Aby uzyskać więcej informacji, zobacz Jak serializować i deserializowaćJSON.
Dotyczy
Serialize(Utf8JsonWriter, Object, JsonTypeInfo)
Zapisuje jedną wartość JSON (w tym obiekty lub tablice) do dostarczonego składnika zapisywania.
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
Pisarz do pisania.
- value
- Object
Wartość do konwersji i zapisu.
- jsonTypeInfo
- JsonTypeInfo
Metadane dotyczące typu do konwersji.
Wyjątki
writer
lub jsonTypeInfo
jest null
.
value
nie jest zgodny z typem jsonTypeInfo
.
Dotyczy
Serialize(Stream, Object, Type, JsonSerializerOptions)
Konwertuje podaną wartość na tekst JSON zakodowany w formacie UTF-8 i zapisuje go w 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
Wartość do przekonwertowania.
- inputType
- Type
Typ value
do konwersji.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania konwersji.
Wyjątki
inputType
nie jest zgodny z value
.
utf8Json
lub inputType
jest null
.
Nie ma zgodnych JsonConverter dla inputType
ani jego składowych z możliwością serializacji.
Dotyczy
Serialize(Object, Type, JsonSerializerOptions)
Konwertuje wartość określonego typu na ciąg 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
Wartość do przekonwertowania.
- inputType
- Type
Typ value
do konwersji.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania konwersji.
Zwraca
Reprezentacja ciągu JSON wartości.
Wyjątki
inputType
nie jest zgodny z value
.
inputType
jest null
.
Nie ma zgodnych JsonConverter dla inputType
ani jego składowych z możliwością serializacji.
Uwagi
Użycie String nie jest tak wydajne, jak używanie kodowania UTF-8, ponieważ implementacja wewnętrznie używa utF-8. Zobacz również SerializeToUtf8Bytes(Object, Type, JsonSerializerOptions) i SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken).
Aby uzyskać więcej informacji, zobacz Jak serializować i deserializowaćJSON.
Dotyczy
Serialize(Stream, Object, JsonTypeInfo)
Konwertuje podaną wartość na tekst JSON zakodowany w formacie UTF-8 i zapisuje go w 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
Wartość do przekonwertowania.
- jsonTypeInfo
- JsonTypeInfo
Metadane dotyczące typu do konwersji.
Wyjątki
utf8Json
jest null
.
value
nie jest zgodny z typem jsonTypeInfo
.
Dotyczy
Serialize(Object, JsonTypeInfo)
Konwertuje podaną wartość 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
Wartość do przekonwertowania.
- jsonTypeInfo
- JsonTypeInfo
Metadane dotyczące typu do konwersji.
Zwraca
String reprezentacja wartości.
Wyjątki
jsonTypeInfo
jest null
.
value
nie jest zgodny z typem jsonTypeInfo
.
Uwagi
Użycie String nie jest tak wydajne, jak używanie kodowania UTF-8, ponieważ implementacja wewnętrznie używa utF-8. Zobacz również SerializeToUtf8Bytes(Object, JsonTypeInfo) i SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken).
Dotyczy
Serialize(Object, Type, JsonSerializerContext)
Konwertuje podaną wartość 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
Wartość do przekonwertowania.
- inputType
- Type
Typ value
do konwersji.
- context
- JsonSerializerContext
Dostawca metadanych dla typów możliwych do serializacji.
Zwraca
String reprezentacja wartości.
Wyjątki
Nie ma zgodnych JsonConverter dla inputType
ani jego składowych z możliwością serializacji.
Metoda GetTypeInfo(Type) podanej context
zwraca null
dla typu do konwersji.
inputType
lub context
jest null
.
Uwagi
Użycie String nie jest tak wydajne, jak używanie kodowania UTF-8, ponieważ implementacja wewnętrznie używa utF-8. Zobacz również SerializeToUtf8Bytes(Object, Type, JsonSerializerContext) i SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken).
Dotyczy
Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions)
Zapisuje reprezentację JSON typu określonego przez ogólny parametr typu do dostarczonego składnika zapisywania.
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 wartości do serializacji.
Parametry
- writer
- Utf8JsonWriter
Zapis w formacie JSON do zapisu.
- value
- TValue
Wartość do konwersji i zapisu.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania serializacji.
Wyjątki
writer
jest null
.
Nie ma zgodnych JsonConverter dla TValue
ani jego składowych z możliwością serializacji.
Uwagi
JsonWriterOptions użyte do utworzenia wystąpienia Utf8JsonWriter mają pierwszeństwo przed JsonSerializerOptions w przypadku konfliktu. W związku z tym JsonWriterOptions.Indented, JsonWriterOptions.SkipValidationi JsonWriterOptions.Encoder są używane podczas pisania.
Aby uzyskać więcej informacji, zobacz Jak serializować i deserializowaćJSON.
Dotyczy
Serialize<TValue>(TValue, JsonSerializerOptions)
Konwertuje wartość typu określonego przez parametr typu ogólnego na ciąg 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 wartości do serializacji.
Parametry
- value
- TValue
Wartość do przekonwertowania.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania serializacji.
Zwraca
Reprezentacja ciągu JSON wartości.
Wyjątki
Nie ma zgodnych JsonConverter dla TValue
ani jego składowych z możliwością serializacji.
Uwagi
Użycie String nie jest tak wydajne, jak używanie kodowania UTF-8, ponieważ implementacja wewnętrznie używa utF-8. Zobacz również SerializeToUtf8Bytes(Object, Type, JsonSerializerOptions) i SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken).
Aby uzyskać więcej informacji, zobacz Jak serializować i deserializowaćJSON.
Dotyczy
Serialize<TValue>(TValue, JsonTypeInfo<TValue>)
Konwertuje podaną wartość 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 wartości do serializacji.
Parametry
- value
- TValue
Wartość do przekonwertowania.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadane dotyczące typu do konwersji.
Zwraca
String reprezentacja wartości.
Wyjątki
Nie ma zgodnych JsonConverter dla TValue
ani jego składowych z możliwością serializacji.
jsonTypeInfo
jest null
.
Uwagi
Użycie String nie jest tak wydajne, jak używanie kodowania UTF-8, ponieważ implementacja wewnętrznie używa utF-8. Zobacz również SerializeToUtf8Bytes<TValue>(TValue, JsonTypeInfo<TValue>) i SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken).
Dotyczy
Serialize<TValue>(Stream, TValue, JsonSerializerOptions)
Konwertuje podaną wartość na tekst JSON zakodowany w formacie UTF-8 i zapisuje go w 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 wartości do serializacji.
Parametry
- value
- TValue
Wartość do przekonwertowania.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania konwersji.
Wyjątki
utf8Json
jest null
.
Nie ma zgodnych JsonConverter dla TValue
ani jego składowych z możliwością serializacji.
Dotyczy
Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>)
Konwertuje podaną wartość na tekst JSON zakodowany w formacie UTF-8 i zapisuje go w 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 wartości do serializacji.
Parametry
- value
- TValue
Wartość do przekonwertowania.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadane dotyczące typu do konwersji.
Wyjątki
utf8Json
jest null
.
Nie ma zgodnych JsonConverter dla TValue
ani jego składowych z możliwością serializacji.
Dotyczy
Serialize<TValue>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>)
Zapisuje jedną wartość JSON (w tym obiekty lub tablice) do dostarczonego składnika zapisywania.
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 wartości do serializacji.
Parametry
- writer
- Utf8JsonWriter
Pisarz do pisania.
- value
- TValue
Wartość do konwersji i zapisu.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadane dotyczące typu do konwersji.
Wyjątki
writer
lub jsonTypeInfo
jest null
.
Nie ma zgodnych JsonConverter dla TValue
ani jego składowych z możliwością serializacji.