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(Utf8JsonWriter, Object, Type, JsonSerializerContext) |
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 pliku Stream. |
Serialize(Stream, Object, Type, JsonSerializerOptions) |
Konwertuje podaną wartość na tekst JSON zakodowany w formacie UTF-8 i zapisuje go w pliku Stream. |
Serialize(Utf8JsonWriter, Object, JsonTypeInfo) |
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(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 pliku Stream. |
Serialize(Object, JsonTypeInfo) |
Konwertuje podaną wartość na wartość String. |
Serialize(Object, Type, JsonSerializerContext) |
Konwertuje podaną wartość na wartość String. |
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 wartość String. |
Serialize<TValue>(Stream, TValue, JsonSerializerOptions) |
Konwertuje podaną wartość na tekst JSON zakodowany w formacie UTF-8 i zapisuje go w pliku Stream. |
Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>) |
Konwertuje podaną wartość na tekst JSON zakodowany w formacie UTF-8 i zapisuje go w pliku Stream. |
Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions) |
Zapisuje reprezentację JSON typu określonego przez ogólny parametr typu do dostarczonego składnika zapisywania. |
Serialize<TValue>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>) |
Zapisuje jedną wartość JSON (w tym obiekty lub tablice) do dostarczonego składnika zapisywania. |
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 elementu do konwersji value
.
- context
- JsonSerializerContext
Dostawca metadanych dla typów z możliwością serializacji.
Wyjątki
inputType
nie jest zgodny z programem value
.
writer
lub inputType
to null
.
Nie ma żadnych zgodnych JsonConverter elementów inputType
członkowskich ani ich serializacji.
Metoda GetTypeInfo(Type) podanego context
zwraca null
wartość dla typu do przekonwertowania.
Dotyczy
Serialize(Stream, Object, Type, JsonSerializerContext)
Konwertuje podaną wartość na tekst JSON zakodowany w formacie UTF-8 i zapisuje go w pliku 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 konwersji.
- inputType
- Type
Typ elementu do konwersji value
.
- context
- JsonSerializerContext
Dostawca metadanych dla typów z możliwością serializacji.
Wyjątki
inputType
nie jest zgodny z programem value
.
utf8Json
, inputType
lub context
to null
.
Nie ma żadnych zgodnych JsonConverter elementów inputType
członkowskich ani ich serializacji.
Dotyczy
Serialize(Stream, Object, Type, JsonSerializerOptions)
Konwertuje podaną wartość na tekst JSON zakodowany w formacie UTF-8 i zapisuje go w pliku 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 konwersji.
- inputType
- Type
Typ elementu do konwersji value
.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania konwersji.
Wyjątki
inputType
nie jest zgodny z programem value
.
utf8Json
lub inputType
to null
.
Nie ma żadnych zgodnych JsonConverter elementów inputType
członkowskich ani ich serializacji.
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
to null
.
value
nie jest zgodny z typem jsonTypeInfo
.
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 elementu do konwersji value
.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania serializacji.
Wyjątki
inputType
jest niezgodny z value
writer
lub inputType
to null
.
Nie ma żadnych zgodnych JsonConverter elementów inputType
członkowskich ani ich serializacji.
Uwagi
Użyte JsonWriterOptions do utworzenia wystąpienia Utf8JsonWriter wystąpienia mają pierwszeństwo przed JsonSerializerOptions konfliktem. W związku z tym , JsonWriterOptions.IndentedJsonWriterOptions.SkipValidation, i JsonWriterOptions.Encoder są używane podczas pisania.
Aby uzyskać więcej informacji, zobacz Jak serializować i deserializować dane JSON.
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 konwersji.
- inputType
- Type
Typ elementu do konwersji value
.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania konwersji.
Zwraca
Reprezentacja ciągu JSON wartości.
Wyjątki
inputType
nie jest zgodny z programem value
.
inputType
to null
.
Nie ma żadnych zgodnych JsonConverter elementów inputType
członkowskich ani ich serializacji.
Uwagi
Użycie elementu nie String jest tak wydajne, jak używanie kodowania UTF-8, ponieważ implementacja wewnętrznie używa protokołu 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ć dane JSON.
Dotyczy
Serialize(Stream, Object, JsonTypeInfo)
Konwertuje podaną wartość na tekst JSON zakodowany w formacie UTF-8 i zapisuje go w pliku 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 konwersji.
- jsonTypeInfo
- JsonTypeInfo
Metadane dotyczące typu do konwersji.
Wyjątki
utf8Json
to null
.
value
nie jest zgodny z typem jsonTypeInfo
.
Dotyczy
Serialize(Object, JsonTypeInfo)
Konwertuje podaną wartość na wartość 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 konwersji.
- jsonTypeInfo
- JsonTypeInfo
Metadane dotyczące typu do konwersji.
Zwraca
Reprezentacja String wartości.
Wyjątki
jsonTypeInfo
to null
.
value
nie jest zgodny z typem jsonTypeInfo
.
Uwagi
Użycie elementu nie String jest tak wydajne, jak używanie kodowania UTF-8, ponieważ implementacja wewnętrznie używa protokołu UTF-8. Zobacz również SerializeToUtf8Bytes(Object, JsonTypeInfo) i SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken).
Dotyczy
Serialize(Object, Type, JsonSerializerContext)
Konwertuje podaną wartość na wartość 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 konwersji.
- inputType
- Type
Typ elementu do konwersji value
.
- context
- JsonSerializerContext
Dostawca metadanych dla typów z możliwością serializacji.
Zwraca
Reprezentacja String wartości.
Wyjątki
Nie ma żadnych zgodnych JsonConverter elementów inputType
członkowskich ani ich serializacji.
Metoda GetTypeInfo(Type) podanego context
zwraca null
wartość dla typu do przekonwertowania.
inputType
lub context
to null
.
Uwagi
Użycie elementu nie String jest tak wydajne, jak w przypadku kodowania UTF-8, ponieważ implementacja wewnętrznie używa protokołu UTF-8. SerializeToUtf8Bytes(Object, Type, JsonSerializerContext) Zobacz również i SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken).
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 konwersji.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania serializacji.
Zwraca
Reprezentacja ciągu JSON wartości.
Wyjątki
Nie ma żadnych zgodnych JsonConverter elementów TValue
członkowskich ani ich serializacji.
Uwagi
Użycie elementu nie String jest tak wydajne, jak używanie kodowania UTF-8, ponieważ implementacja wewnętrznie używa protokołu 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ć dane JSON.
Dotyczy
Serialize<TValue>(TValue, JsonTypeInfo<TValue>)
Konwertuje podaną wartość na wartość 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 konwersji.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadane dotyczące typu do konwersji.
Zwraca
Reprezentacja String wartości.
Wyjątki
Nie ma żadnych zgodnych JsonConverter elementów TValue
członkowskich ani ich serializacji.
jsonTypeInfo
to null
.
Uwagi
Użycie elementu nie String jest tak wydajne, jak używanie kodowania UTF-8, ponieważ implementacja wewnętrznie używa protokołu 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 pliku 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 konwersji.
- options
- JsonSerializerOptions
Opcje kontrolowania zachowania konwersji.
Wyjątki
utf8Json
to null
.
Nie ma żadnych zgodnych JsonConverter elementów TValue
członkowskich ani ich serializacji.
Dotyczy
Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>)
Konwertuje podaną wartość na tekst JSON zakodowany w formacie UTF-8 i zapisuje go w pliku 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 konwersji.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Metadane dotyczące typu do konwersji.
Wyjątki
utf8Json
to null
.
Nie ma żadnych zgodnych JsonConverter elementów TValue
członkowskich ani ich serializacji.
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
to null
.
Nie ma żadnych zgodnych JsonConverter elementów TValue
członkowskich ani ich serializacji.
Uwagi
Użyte JsonWriterOptions do utworzenia wystąpienia Utf8JsonWriter wystąpienia mają pierwszeństwo przed JsonSerializerOptions konfliktem. W związku z tym , JsonWriterOptions.IndentedJsonWriterOptions.SkipValidation, i JsonWriterOptions.Encoder są używane podczas pisania.
Aby uzyskać więcej informacji, zobacz Jak serializować i deserializować dane JSON.
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
to null
.
Nie ma żadnych zgodnych JsonConverter elementów TValue
członkowskich ani ich serializacji.
Dotyczy
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla