JsonSerializer.SerializeAsync Yöntem

Tanım

Ad Alanı:

System.Text.Json

Bütünleştirilmiş Kod:

System.Text.Json.dll

Paket:

System.Text.Json v9.0.0-rc.2.24473.5

Aşırı Yüklemeler

SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken)	Sağlanan değeri UTF-8 kodlanmış JSON metnine dönüştürür ve Streamyazar.
SerializeAsync(PipeWriter, Object, Type, JsonSerializerContext, CancellationToken)	Sağlanan değeri UTF-8 kodlanmış JSON metnine dönüştürür ve PipeWriteryazar.
SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken)	Belirtilen türün değerini zaman uyumsuz olarak UTF-8 ile kodlanmış JSON metnine dönüştürür ve belirtilen akışa yazar.
SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken)	Sağlanan değeri UTF-8 ile kodlanmış JSON metnine dönüştürür ve Streamyazar.
SerializeAsync(PipeWriter, Object, JsonTypeInfo, CancellationToken)	Sağlanan değeri UTF-8 kodlanmış JSON metnine dönüştürür ve PipeWriteryazar.
SerializeAsync(PipeWriter, Object, Type, JsonSerializerOptions, CancellationToken)	Sağlanan değeri UTF-8 kodlanmış JSON metnine dönüştürür ve PipeWriteryazar.
SerializeAsync<TValue>(PipeWriter, TValue, JsonSerializerOptions, CancellationToken)	Sağlanan değeri UTF-8 kodlanmış JSON metnine dönüştürür ve PipeWriteryazar.
SerializeAsync<TValue>(PipeWriter, TValue, JsonTypeInfo<TValue>, CancellationToken)	Sağlanan değeri UTF-8 kodlanmış JSON metnine dönüştürür ve PipeWriteryazar.
SerializeAsync<TValue>(Stream, TValue, JsonSerializerOptions, CancellationToken)	Genel tür parametresi tarafından belirtilen tür değerini zaman uyumsuz olarak UTF-8 kodlanmış JSON metnine dönüştürür ve bir akışa yazar.
SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken)	Sağlanan değeri UTF-8 kodlanmış JSON metnine dönüştürür ve Streamyazar.

SerializeAsync(Stream, Object, Type, JsonSerializerContext, CancellationToken)

Kaynak:

JsonSerializer.Write.Stream.cs

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

public static System.Threading.Tasks.Task SerializeAsync (System.IO.Stream utf8Json, object? value, Type inputType, System.Text.Json.Serialization.JsonSerializerContext context, System.Threading.CancellationToken cancellationToken = default);

static member SerializeAsync : System.IO.Stream * obj * Type * System.Text.Json.Serialization.JsonSerializerContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SerializeAsync (utf8Json As Stream, value As Object, inputType As Type, context As JsonSerializerContext, Optional cancellationToken As CancellationToken = Nothing) As Task

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

cancellationToken

CancellationToken

Yazma işlemini iptal etmek için kullanılabilecek CancellationToken.

Döndürülenler

Task

Zaman uyumsuz yazma işlemini temsil eden görev.

Özel durumlar

ArgumentException

inputType valueile uyumlu değildir.

ArgumentNullException

utf8Json, inputTypeveya contextnull.

NotSupportedException

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

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Açıklamalar

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için, Serialize(Stream, Object, Type, JsonSerializerContext)tarafından oluşan özel durumlara bakın.

SerializeAsync(PipeWriter, Object, Type, JsonSerializerContext, CancellationToken)

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

public static System.Threading.Tasks.Task SerializeAsync (System.IO.Pipelines.PipeWriter utf8Json, object? value, Type inputType, System.Text.Json.Serialization.JsonSerializerContext context, System.Threading.CancellationToken cancellationToken = default);

static member SerializeAsync : System.IO.Pipelines.PipeWriter * obj * Type * System.Text.Json.Serialization.JsonSerializerContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SerializeAsync (utf8Json As PipeWriter, value As Object, inputType As Type, context As JsonSerializerContext, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametreler

utf8Json

PipeWriter

UTF-8, yazacak PipeWriter.

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

cancellationToken

CancellationToken

Yazma işlemini iptal etmek için kullanılabilecek CancellationToken.

Döndürülenler

Task

Zaman uyumsuz yazma işlemini temsil eden görev.

Özel durumlar

ArgumentException

inputType valueile uyumlu değildir.

ArgumentNullException

utf8Json, inputTypeveya contextnull.

NotSupportedException

Uyumlu JsonConverter

inputType veya seri hale getirilebilir üyeleri için.

SerializeAsync(Stream, Object, Type, JsonSerializerOptions, CancellationToken)

Kaynak:

JsonSerializer.Write.Stream.cs

Belirtilen türün değerini zaman uyumsuz olarak UTF-8 ile kodlanmış JSON metnine dönüştürür ve belirtilen akışa yazar.

public static System.Threading.Tasks.Task SerializeAsync (System.IO.Stream utf8Json, object? value, Type inputType, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);

static member SerializeAsync : System.IO.Stream * obj * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SerializeAsync (utf8Json As Stream, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametreler

utf8Json

Stream

Yazacak UTF-8 akışı.

value

Object

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

inputType

Type

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

options

JsonSerializerOptions

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

cancellationToken

CancellationToken

Yazma işlemini iptal etmek için kullanılabilecek bir belirteç.

Döndürülenler

Task

Zaman uyumsuz yazma işlemini temsil eden görev.

Özel durumlar

ArgumentException

inputType valueile uyumlu değildir.

ArgumentNullException

utf8Json veya inputTypenull.

NotSupportedException

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

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Açıklamalar

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

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için, Serialize(Stream, Object, Type, JsonSerializerOptions)tarafından oluşan özel durumlara bakın.

SerializeAsync(Stream, Object, JsonTypeInfo, CancellationToken)

Kaynak:

JsonSerializer.Write.Stream.cs

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

public static System.Threading.Tasks.Task SerializeAsync (System.IO.Stream utf8Json, object? value, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);

static member SerializeAsync : System.IO.Stream * obj * System.Text.Json.Serialization.Metadata.JsonTypeInfo * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SerializeAsync (utf8Json As Stream, value As Object, jsonTypeInfo As JsonTypeInfo, Optional cancellationToken As CancellationToken = Nothing) As Task

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.

cancellationToken

CancellationToken

Yazma işlemini iptal etmek için kullanılabilecek CancellationToken.

Döndürülenler

Task

Zaman uyumsuz yazma işlemini temsil eden görev.

Özel durumlar

ArgumentNullException

utf8Json null.

InvalidCastException

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

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

SerializeAsync(PipeWriter, Object, JsonTypeInfo, CancellationToken)

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

public static System.Threading.Tasks.Task SerializeAsync (System.IO.Pipelines.PipeWriter utf8Json, object? value, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);

static member SerializeAsync : System.IO.Pipelines.PipeWriter * obj * System.Text.Json.Serialization.Metadata.JsonTypeInfo * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SerializeAsync (utf8Json As PipeWriter, value As Object, jsonTypeInfo As JsonTypeInfo, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametreler

utf8Json

PipeWriter

UTF-8, yazacak PipeWriter.

value

Object

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

jsonTypeInfo

JsonTypeInfo

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

cancellationToken

CancellationToken

Yazma işlemini iptal etmek için kullanılabilecek CancellationToken.

Döndürülenler

Task

Zaman uyumsuz yazma işlemini temsil eden görev.

Özel durumlar

ArgumentNullException

utf8Json null.

InvalidCastException

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

SerializeAsync(PipeWriter, Object, Type, JsonSerializerOptions, CancellationToken)

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

public static System.Threading.Tasks.Task SerializeAsync (System.IO.Pipelines.PipeWriter utf8Json, object? value, Type inputType, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);

static member SerializeAsync : System.IO.Pipelines.PipeWriter * obj * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SerializeAsync (utf8Json As PipeWriter, value As Object, inputType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametreler

utf8Json

PipeWriter

UTF-8, yazacak PipeWriter.

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.

cancellationToken

CancellationToken

Yazma işlemini iptal etmek için kullanılabilecek CancellationToken.

Döndürülenler

Task

Zaman uyumsuz yazma işlemini temsil eden görev.

Özel durumlar

ArgumentException

inputType valueile uyumlu değildir.

ArgumentNullException

utf8Json veya inputTypenull.

NotSupportedException

Uyumlu JsonConverter

inputType veya seri hale getirilebilir üyeleri için.

SerializeAsync<TValue>(PipeWriter, TValue, JsonSerializerOptions, CancellationToken)

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

public static System.Threading.Tasks.Task SerializeAsync<TValue> (System.IO.Pipelines.PipeWriter utf8Json, TValue value, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);

static member SerializeAsync : System.IO.Pipelines.PipeWriter * 'Value * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SerializeAsync(Of TValue) (utf8Json As PipeWriter, value As TValue, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task

Tür Parametreleri

TValue

Serileştirecek değerin türü.

Parametreler

utf8Json

PipeWriter

UTF-8, yazacak PipeWriter.

value

TValue

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

options

JsonSerializerOptions

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

cancellationToken

CancellationToken

Yazma işlemini iptal etmek için kullanılabilecek CancellationToken.

Döndürülenler

Task

Zaman uyumsuz yazma işlemini temsil eden görev.

Özel durumlar

ArgumentNullException

utf8Json null.

NotSupportedException

Uyumlu JsonConverter

TValue veya seri hale getirilebilir üyeleri için.

SerializeAsync<TValue>(PipeWriter, TValue, JsonTypeInfo<TValue>, CancellationToken)

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

public static System.Threading.Tasks.Task SerializeAsync<TValue> (System.IO.Pipelines.PipeWriter utf8Json, TValue value, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);

static member SerializeAsync : System.IO.Pipelines.PipeWriter * 'Value * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SerializeAsync(Of TValue) (utf8Json As PipeWriter, value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue), Optional cancellationToken As CancellationToken = Nothing) As Task

Tür Parametreleri

TValue

Serileştirecek değerin türü.

Parametreler

utf8Json

PipeWriter

UTF-8, yazacak PipeWriter.

value

TValue

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

jsonTypeInfo

JsonTypeInfo<TValue>

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

cancellationToken

CancellationToken

Yazma işlemini iptal etmek için kullanılabilecek CancellationToken.

Döndürülenler

Task

Zaman uyumsuz yazma işlemini temsil eden görev.

Özel durumlar

ArgumentNullException

utf8Json null.

SerializeAsync<TValue>(Stream, TValue, JsonSerializerOptions, CancellationToken)

Kaynak:

JsonSerializer.Write.Stream.cs

Genel tür parametresi tarafından belirtilen tür değerini zaman uyumsuz olarak UTF-8 kodlanmış JSON metnine dönüştürür ve bir akışa yazar.

public static System.Threading.Tasks.Task SerializeAsync<TValue> (System.IO.Stream utf8Json, TValue value, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);

static member SerializeAsync : System.IO.Stream * 'Value * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SerializeAsync(Of TValue) (utf8Json As Stream, value As TValue, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task

Tür Parametreleri

TValue

Serileştirecek değerin türü.

Parametreler

utf8Json

Stream

Yazacak UTF-8 akışı.

value

TValue

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

options

JsonSerializerOptions

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

cancellationToken

CancellationToken

Yazma işlemini iptal etmek için kullanılabilecek bir belirteç.

Döndürülenler

Task

Zaman uyumsuz yazma işlemini temsil eden görev.

Özel durumlar

ArgumentNullException

utf8Json null.

NotSupportedException

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

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Açıklamalar

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

SerializeAsync<TValue>(Stream, TValue, JsonTypeInfo<TValue>, CancellationToken)

Kaynak:

JsonSerializer.Write.Stream.cs

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

public static System.Threading.Tasks.Task SerializeAsync<TValue> (System.IO.Stream utf8Json, TValue value, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);

static member SerializeAsync : System.IO.Stream * 'Value * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SerializeAsync(Of TValue) (utf8Json As Stream, value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue), Optional cancellationToken As CancellationToken = Nothing) As Task

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.

cancellationToken

CancellationToken

Yazma işlemini iptal etmek için kullanılabilecek CancellationToken.

Döndürülenler

Task

Zaman uyumsuz yazma işlemini temsil eden görev.

Özel durumlar

ArgumentNullException

utf8Json null.

NotSupportedException

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

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.