JsonSerializer.Serialize Yöntem

Tanım

Ad Alanı:

System.Text.Json

Bütünleştirilmiş Kod:

System.Text.Json.dll

Aşırı Yüklemeler

Serialize(Stream, Object, Type, JsonSerializerContext)	Sağlanan değeri UTF-8 kodlanmış JSON metnine dönüştürür ve Streamyazar.
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext)	Sağlanan yazıcıya bir JSON değeri (nesneler veya diziler dahil) yazar.
Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions)	Belirtilen türün JSON gösterimini sağlanan yazıcıya yazar.
Serialize(Utf8JsonWriter, Object, JsonTypeInfo)	Sağlanan yazıcıya bir JSON değeri (nesneler veya diziler dahil) yazar.
Serialize(Stream, Object, Type, JsonSerializerOptions)	Sağlanan değeri UTF-8 kodlanmış JSON metnine dönüştürür ve Streamyazar.
Serialize(Object, Type, JsonSerializerOptions)	Belirtilen türün değerini JSON dizesine dönüştürür.
Serialize(Stream, Object, JsonTypeInfo)	Sağlanan değeri UTF-8 kodlanmış JSON metnine dönüştürür ve Streamyazar.
Serialize(Object, JsonTypeInfo)	Sağlanan değeri bir Stringdönüştürür.
Serialize(Object, Type, JsonSerializerContext)	Sağlanan değeri bir Stringdönüştürür.
Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions)	Sağlanan yazıcıya genel tür parametresi tarafından belirtilen bir türün JSON gösterimini yazar.
Serialize<TValue>(TValue, JsonSerializerOptions)	Genel tür parametresi tarafından belirtilen türün değerini JSON dizesine dönüştürür.
Serialize<TValue>(TValue, JsonTypeInfo<TValue>)	Sağlanan değeri bir Stringdönüştürür.
Serialize<TValue>(Stream, TValue, JsonSerializerOptions)	Sağlanan değeri UTF-8 kodlanmış JSON metnine dönüştürür ve Streamyazar.
Serialize<TValue>(Stream, TValue, JsonTypeInfo<TValue>)	Sağlanan değeri UTF-8 kodlanmış JSON metnine dönüştürür ve Streamyazar.
Serialize<TValue>(Utf8JsonWriter, TValue, JsonTypeInfo<TValue>)	Sağlanan yazıcıya bir JSON değeri (nesneler veya diziler dahil) yazar.

Serialize(Stream, Object, Type, JsonSerializerContext)

Kaynak:

JsonSerializer.Write.Stream.cs

Sağlanan değeri UTF-8 kodlanmış JSON metnine dönüştürür ve Streamyazar.

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)

Parametreler

utf8Json

Stream

UTF-8, yazacak Stream.

value

Object

Dönüştürülecek değer.

inputType

Type

Dönüştürülecek value türü.

context

JsonSerializerContext

Serileştirilebilir türler için meta veri sağlayıcısı.

Özel durumlar

ArgumentException

inputType valueile uyumlu değildir.

ArgumentNullException

utf8Json, inputTypeveya contextnull.

NotSupportedException

inputType veya serileştirilebilir üyeleri için uyumlu JsonConverter yoktur.

Serialize(Utf8JsonWriter, Object, Type, JsonSerializerContext)

Kaynak:

JsonSerializer.Write.Utf8JsonWriter.cs

Sağlanan yazıcıya bir JSON değeri (nesneler veya diziler dahil) yazar.

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)

Parametreler

writer

Utf8JsonWriter

Yazacak bir JSON yazarı.

value

Object

Dönüştürülecek ve yazacak değer.

inputType

Type

Dönüştürülecek value türü.

context

JsonSerializerContext

Serileştirilebilir türler için meta veri sağlayıcısı.

Özel durumlar

ArgumentException

inputType valueile uyumlu değildir.

ArgumentNullException

writer veya inputTypenull.

NotSupportedException

inputType veya serileştirilebilir üyeleri için uyumlu JsonConverter yoktur.

InvalidOperationException

Sağlanan contextGetTypeInfo(Type) yöntemi, türün dönüştürülmesi için null döndürür.

Serialize(Utf8JsonWriter, Object, Type, JsonSerializerOptions)

Kaynak:

JsonSerializer.Write.Utf8JsonWriter.cs

Belirtilen türün JSON gösterimini sağlanan yazıcıya yazar.

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)

Parametreler

writer

Utf8JsonWriter

Yazacak JSON yazıcısı.

value

Object

Dönüştürülecek ve yazacak değer.

inputType

Type

Dönüştürülecek value türü.

options

JsonSerializerOptions

Serileştirme davranışını denetleme seçenekleri.

Özel durumlar

ArgumentException

inputType value ile uyumlu değil

ArgumentNullException

writer veya inputTypenull.

NotSupportedException

inputType veya serileştirilebilir üyeleri için uyumlu JsonConverter yoktur.

Açıklamalar

Utf8JsonWriter örneğini oluşturmak için kullanılan JsonWriterOptions, çakıştığında JsonSerializerOptions önceliklidir. Bu nedenle, JsonWriterOptions.Indented, JsonWriterOptions.SkipValidationve JsonWriterOptions.Encoder yazılırken kullanılır.

Daha fazla bilgi için bkz. JSONseri hale getirme ve seri durumdan çıkarma .

Serialize(Utf8JsonWriter, Object, JsonTypeInfo)

Kaynak:

JsonSerializer.Write.Utf8JsonWriter.cs

Sağlanan yazıcıya bir JSON değeri (nesneler veya diziler dahil) yazar.

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)

Parametreler

writer

Utf8JsonWriter

Yazacak yazar.

value

Object

Dönüştürülecek ve yazacak değer.

jsonTypeInfo

JsonTypeInfo

Dönüştürülecek tür hakkındaki meta veriler.

Özel durumlar

ArgumentNullException

writer veya jsonTypeInfonull.

InvalidCastException

value jsonTypeInfotürüyle eşleşmiyor.

Serialize(Stream, Object, Type, JsonSerializerOptions)

Kaynak:

JsonSerializer.Write.Stream.cs

Sağlanan değeri UTF-8 kodlanmış JSON metnine dönüştürür ve Streamyazar.

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)

Parametreler

utf8Json

Stream

UTF-8, yazacak Stream.

value

Object

Dönüştürülecek değer.

inputType

Type

Dönüştürülecek value türü.

options

JsonSerializerOptions

Dönüştürme davranışını denetleme seçenekleri.

Özel durumlar

ArgumentException

inputType valueile uyumlu değildir.

ArgumentNullException

utf8Json veya inputTypenull.

NotSupportedException

inputType veya serileştirilebilir üyeleri için uyumlu JsonConverter yoktur.

Serialize(Object, Type, JsonSerializerOptions)

Kaynak:

JsonSerializer.Write.String.cs

Belirtilen türün değerini JSON dizesine dönüştürür.

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

Parametreler

value

Object

Dönüştürülecek değer.

inputType

Type

Dönüştürülecek value türü.

options

JsonSerializerOptions

Dönüştürme davranışını denetleme seçenekleri.

Döndürülenler

String

Değerin JSON dize gösterimi.

Özel durumlar

ArgumentException

inputType valueile uyumlu değildir.

ArgumentNullException

inputType null.

NotSupportedException

inputType veya serileştirilebilir üyeleri için uyumlu JsonConverter yoktur.

Açıklamalar

Uygulama dahili olarak UTF-8 kullandığından, String kullanmak UTF-8 kodlaması kullanmak kadar verimli değildir. Ayrıca bkz. SerializeToUtf8Bytes(Object, Type, JsonSerializerOptions) ve SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken).

Daha fazla bilgi için bkz. JSONseri hale getirme ve seri durumdan çıkarma .

Serialize(Stream, Object, JsonTypeInfo)

Kaynak:

JsonSerializer.Write.Stream.cs

Sağlanan değeri UTF-8 kodlanmış JSON metnine dönüştürür ve Streamyazar.

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)

Parametreler

utf8Json

Stream

UTF-8, yazacak Stream.

value

Object

Dönüştürülecek değer.

jsonTypeInfo

JsonTypeInfo

Dönüştürülecek tür hakkındaki meta veriler.

Özel durumlar

ArgumentNullException

utf8Json null.

InvalidCastException

value jsonTypeInfotürüyle eşleşmiyor.

Serialize(Object, JsonTypeInfo)

Kaynak:

JsonSerializer.Write.String.cs

Sağlanan değeri bir Stringdönüştürür.

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

Parametreler

value

Object

Dönüştürülecek değer.

jsonTypeInfo

JsonTypeInfo

Dönüştürülecek tür hakkındaki meta veriler.

Döndürülenler

String

Değerin String gösterimi.

Özel durumlar

ArgumentNullException

jsonTypeInfo null.

InvalidCastException

value jsonTypeInfotürüyle eşleşmiyor.

Açıklamalar

Uygulama dahili olarak UTF-8 kullandığından, String kullanmak UTF-8 kodlaması kullanmak kadar verimli değildir. Ayrıca bkz. SerializeToUtf8Bytes(Object, JsonTypeInfo) ve SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken).

Serialize(Object, Type, JsonSerializerContext)

Kaynak:

JsonSerializer.Write.String.cs

Sağlanan değeri bir Stringdönüştürür.

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

Parametreler

value

Object

Dönüştürülecek değer.

inputType

Type

Dönüştürülecek value türü.

context

JsonSerializerContext

Serileştirilebilir türler için meta veri sağlayıcısı.

Döndürülenler

String

Değerin String gösterimi.

Özel durumlar

NotSupportedException

inputType veya serileştirilebilir üyeleri için uyumlu JsonConverter yoktur.

InvalidOperationException

Sağlanan contextGetTypeInfo(Type) yöntemi, türün dönüştürülmesi için null döndürür.

ArgumentNullException

inputType veya contextnull.

Açıklamalar

Uygulama dahili olarak UTF-8 kullandığından, String kullanmak UTF-8 kodlaması kullanmak kadar verimli değildir. Ayrıca bkz. SerializeToUtf8Bytes(Object, Type, JsonSerializerContext) ve SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken).

Serialize<TValue>(Utf8JsonWriter, TValue, JsonSerializerOptions)

Kaynak:

JsonSerializer.Write.Utf8JsonWriter.cs

Sağlanan yazıcıya genel tür parametresi tarafından belirtilen bir türün JSON gösterimini yazar.

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)

Tür Parametreleri

TValue

Serileştirecek değerin türü.

Parametreler

writer

Utf8JsonWriter

Yazacak bir JSON yazarı.

value

TValue

Dönüştürülecek ve yazacak değer.

options

JsonSerializerOptions

Serileştirme davranışını denetleme seçenekleri.

Özel durumlar

ArgumentNullException

writer null.

NotSupportedException

TValue veya serileştirilebilir üyeleri için uyumlu JsonConverter yoktur.

Açıklamalar

Utf8JsonWriter örneğini oluşturmak için kullanılan JsonWriterOptions, çakıştığında JsonSerializerOptions önceliklidir. Bu nedenle, JsonWriterOptions.Indented, JsonWriterOptions.SkipValidationve JsonWriterOptions.Encoder yazılırken kullanılır.

Daha fazla bilgi için bkz. JSONseri hale getirme ve seri durumdan çıkarma .

Serialize<TValue>(TValue, JsonSerializerOptions)

Kaynak:

JsonSerializer.Write.String.cs

Genel tür parametresi tarafından belirtilen türün değerini JSON dizesine dönüştürür.

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

Tür Parametreleri

TValue

Serileştirecek değerin türü.

Parametreler

value

TValue

Dönüştürülecek değer.

options

JsonSerializerOptions

Serileştirme davranışını denetleme seçenekleri.

Döndürülenler

String

Değerin JSON dize gösterimi.

Özel durumlar

NotSupportedException

TValue veya serileştirilebilir üyeleri için uyumlu JsonConverter yoktur.

Açıklamalar

Uygulama dahili olarak UTF-8 kullandığından, String kullanmak UTF-8 kodlaması kullanmak kadar verimli değildir. Ayrıca bkz. SerializeToUtf8Bytes(Object, Type, JsonSerializerOptions) ve SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken).

Daha fazla bilgi için bkz. JSONseri hale getirme ve seri durumdan çıkarma .

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

Kaynak:

JsonSerializer.Write.String.cs

Sağlanan değeri bir Stringdönüştürür.

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

Tür Parametreleri

TValue

Serileştirecek değerin türü.

Parametreler

value

TValue

Dönüştürülecek değer.

jsonTypeInfo

JsonTypeInfo<TValue>

Dönüştürülecek tür hakkındaki meta veriler.

Döndürülenler

String

Değerin String gösterimi.

Özel durumlar

NotSupportedException

TValue veya serileştirilebilir üyeleri için uyumlu JsonConverter yoktur.

ArgumentNullException

jsonTypeInfo null.

Açıklamalar

Uygulama dahili olarak UTF-8 kullandığından, String kullanmak UTF-8 kodlaması kullanmak kadar verimli değildir. Ayrıca bkz. SerializeToUtf8Bytes<TValue>(TValue, JsonTypeInfo<TValue>) ve SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken).

Serialize<TValue>(Stream, TValue, JsonSerializerOptions)

Kaynak:

JsonSerializer.Write.Stream.cs

Sağlanan değeri UTF-8 kodlanmış JSON metnine dönüştürür ve Streamyazar.

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)

Tür Parametreleri

TValue

Serileştirecek değerin türü.

Parametreler

utf8Json

Stream

UTF-8, yazacak Stream.

value

TValue

Dönüştürülecek değer.

options

JsonSerializerOptions

Dönüştürme davranışını denetleme seçenekleri.

Özel durumlar

ArgumentNullException

utf8Json null.

NotSupportedException

TValue veya serileştirilebilir üyeleri için uyumlu JsonConverter yoktur.

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

Kaynak:

JsonSerializer.Write.Stream.cs

Sağlanan değeri UTF-8 kodlanmış JSON metnine dönüştürür ve Streamyazar.

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

Tür Parametreleri

TValue

Serileştirecek değerin türü.

Parametreler

utf8Json

Stream

UTF-8, yazacak Stream.

value

TValue

Dönüştürülecek değer.

jsonTypeInfo

JsonTypeInfo<TValue>

Dönüştürülecek tür hakkındaki meta veriler.

Özel durumlar

ArgumentNullException

utf8Json null.

NotSupportedException

TValue veya serileştirilebilir üyeleri için uyumlu JsonConverter yoktur.

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

Kaynak:

JsonSerializer.Write.Utf8JsonWriter.cs

Sağlanan yazıcıya bir JSON değeri (nesneler veya diziler dahil) yazar.

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

Tür Parametreleri

TValue

Serileştirecek değerin türü.

Parametreler

writer

Utf8JsonWriter

Yazacak yazar.

value

TValue

Dönüştürülecek ve yazacak değer.

jsonTypeInfo

JsonTypeInfo<TValue>

Dönüştürülecek tür hakkındaki meta veriler.

Özel durumlar

ArgumentNullException

writer veya jsonTypeInfonull.

NotSupportedException

TValue veya serileştirilebilir üyeleri için uyumlu JsonConverter yoktur.