JsonSerializer.DeserializeAsync Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Aşırı Yüklemeler
DeserializeAsync(Stream, JsonTypeInfo, CancellationToken) |
Tek bir JSON değerini temsil eden UTF-8 kodlanmış metnini |
DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken) |
Tek bir JSON değerini temsil eden UTF-8 kodlu metni zaman uyumsuz olarak belirtilen türdeki bir örneğe okur. Akış tamamlanmaya kadar okunur. |
DeserializeAsync(Stream, Type, JsonSerializerContext, CancellationToken) |
Tek bir JSON değerini temsil eden UTF-8 kodlu metni |
DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken) |
Tek bir JSON değerini temsil eden UTF-8 kodlu metni |
DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken) |
Tek bir JSON değerini temsil eden UTF-8 kodlanmış metnini zaman uyumsuz olarak genel tür parametresi tarafından belirtilen bir tür örneğine okur. Akış tamamlanmaya kadar okunur. |
DeserializeAsync(Stream, JsonTypeInfo, CancellationToken)
Tek bir JSON değerini temsil eden UTF-8 kodlanmış metnini jsonTypeInfo
tarafından belirtilen bir örnekte okur.
Akış tamamlanmaya okunur.
public static System.Threading.Tasks.ValueTask<object?> DeserializeAsync (System.IO.Stream utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);
static member DeserializeAsync : System.IO.Stream * System.Text.Json.Serialization.Metadata.JsonTypeInfo * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>
Public Function DeserializeAsync (utf8Json As Stream, jsonTypeInfo As JsonTypeInfo, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)
Parametreler
- utf8Json
- Stream
Ayrıştırmak için JSON verileri.
- jsonTypeInfo
- JsonTypeInfo
Dönüştürülecek tür hakkındaki meta veriler.
- cancellationToken
- CancellationToken
Okuma işlemini iptal etmek için kullanılabilecek CancellationToken.
Döndürülenler
JSON değerinin jsonTypeInfo
gösterimi.
Özel durumlar
utf8Json
veya jsonTypeInfo
null
.
JSON geçersiz veya Stream'de kalan veriler olduğunda.
İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.
Şunlara uygulanır
DeserializeAsync(Stream, Type, JsonSerializerOptions, CancellationToken)
Tek bir JSON değerini temsil eden UTF-8 kodlu metni zaman uyumsuz olarak belirtilen türdeki bir örneğe okur. Akış tamamlanmaya kadar okunur.
public static System.Threading.Tasks.ValueTask<object?> DeserializeAsync (System.IO.Stream utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);
public static System.Threading.Tasks.ValueTask<object> DeserializeAsync (System.IO.Stream utf8Json, Type returnType, System.Text.Json.JsonSerializerOptions options = default, System.Threading.CancellationToken cancellationToken = default);
static member DeserializeAsync : System.IO.Stream * Type * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>
Public Shared Function DeserializeAsync (utf8Json As Stream, returnType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)
Public Function DeserializeAsync (utf8Json As Stream, returnType As Type, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)
Parametreler
- utf8Json
- Stream
Ayrıştırmak için JSON verileri.
- returnType
- Type
Dönüştürülecek ve döndürülecek nesnenin türü.
- options
- JsonSerializerOptions
Okuma sırasında davranışı denetleme seçenekleri.
- cancellationToken
- CancellationToken
Okuma işlemini iptal etmek için kullanılabilecek bir iptal belirteci.
Döndürülenler
JSON değerinin returnType
gösterimi.
Özel durumlar
utf8Json
veya returnType
null
.
JSON geçersiz.
-veya-
TValue
JSON ile uyumlu değildir.
-veya-
Akışta kalan veriler var.
returnType
veya serileştirilebilir üyeleri için uyumlu JsonConverter yoktur.
İ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, Deserialize(Stream, Type, JsonSerializerOptions)tarafından oluşan özel durumlara bakın.
Şunlara uygulanır
DeserializeAsync(Stream, Type, JsonSerializerContext, CancellationToken)
Tek bir JSON değerini temsil eden UTF-8 kodlu metni returnType
olarak okur.
Akış tamamlanmaya okunur.
public static System.Threading.Tasks.ValueTask<object?> DeserializeAsync (System.IO.Stream utf8Json, Type returnType, System.Text.Json.Serialization.JsonSerializerContext context, System.Threading.CancellationToken cancellationToken = default);
static member DeserializeAsync : System.IO.Stream * Type * System.Text.Json.Serialization.JsonSerializerContext * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<obj>
Public Function DeserializeAsync (utf8Json As Stream, returnType As Type, context As JsonSerializerContext, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Object)
Parametreler
- utf8Json
- Stream
Ayrıştırmak için JSON verileri.
- returnType
- Type
Dönüştürülecek ve döndürülecek nesnenin türü.
- context
- JsonSerializerContext
Serileştirilebilir türler için meta veri sağlayıcısı.
- cancellationToken
- CancellationToken
Okuma işlemini iptal etmek için kullanılabilecek CancellationToken.
Döndürülenler
JSON değerinin returnType
gösterimi.
Özel durumlar
utf8Json
, returnType
veya context
null
.
JSON geçersiz, returnType
JSON ile uyumlu değil veya Stream'de kalan veriler var.
returnType
veya serileştirilebilir üyeleri için uyumlu JsonConverter yoktur.
Sağlanan context
üzerindeki GetTypeInfo(Type) yöntemi returnType
için uyumlu bir JsonTypeInfo döndürmedi.
İ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, Deserialize(Stream, Type, JsonSerializerContext)tarafından oluşan özel durumlara bakın.
Şunlara uygulanır
DeserializeAsync<TValue>(Stream, JsonTypeInfo<TValue>, CancellationToken)
Tek bir JSON değerini temsil eden UTF-8 kodlu metni TValue
olarak okur.
Akış tamamlanmaya okunur.
public static System.Threading.Tasks.ValueTask<TValue?> DeserializeAsync<TValue> (System.IO.Stream utf8Json, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);
static member DeserializeAsync : System.IO.Stream * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Value>
Public Function DeserializeAsync(Of TValue) (utf8Json As Stream, jsonTypeInfo As JsonTypeInfo(Of TValue), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TValue)
Tür Parametreleri
- TValue
JSON değerinin serisini kaldıracak tür.
Parametreler
- utf8Json
- Stream
Ayrıştırmak için JSON verileri.
- jsonTypeInfo
- JsonTypeInfo<TValue>
Dönüştürülecek tür hakkındaki meta veriler.
- cancellationToken
- CancellationToken
Okuma işlemini iptal etmek için kullanılabilecek CancellationToken.
Döndürülenler
JSON değerinin TValue
gösterimi.
Özel durumlar
utf8Json
veya jsonTypeInfo
null
.
JSON geçersiz, TValue
JSON ile uyumlu değil veya Stream'de kalan veriler var.
TValue
veya serileştirilebilir üyeleri için uyumlu JsonConverter yoktur.
İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.
Şunlara uygulanır
DeserializeAsync<TValue>(Stream, JsonSerializerOptions, CancellationToken)
Tek bir JSON değerini temsil eden UTF-8 kodlanmış metnini zaman uyumsuz olarak genel tür parametresi tarafından belirtilen bir tür örneğine okur. Akış tamamlanmaya kadar okunur.
public static System.Threading.Tasks.ValueTask<TValue?> DeserializeAsync<TValue> (System.IO.Stream utf8Json, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);
public static System.Threading.Tasks.ValueTask<TValue> DeserializeAsync<TValue> (System.IO.Stream utf8Json, System.Text.Json.JsonSerializerOptions options = default, System.Threading.CancellationToken cancellationToken = default);
static member DeserializeAsync : System.IO.Stream * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<'Value>
Public Shared Function DeserializeAsync(Of TValue) (utf8Json As Stream, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TValue)
Public Function DeserializeAsync(Of TValue) (utf8Json As Stream, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of TValue)
Tür Parametreleri
- TValue
JSON değerinin hedef türü.
Parametreler
- utf8Json
- Stream
Ayrıştırmak için JSON verileri.
- options
- JsonSerializerOptions
Okuma sırasında davranışı denetleme seçenekleri.
- cancellationToken
- CancellationToken
Okuma işlemini iptal etmek için kullanılabilecek bir belirteç.
Döndürülenler
JSON değerinin TValue
gösterimi.
Özel durumlar
JSON geçersiz.
-veya-
TValue
JSON ile uyumlu değildir.
-veya-
Akışta kalan veriler var.
TValue
veya serileştirilebilir üyeleri için uyumlu JsonConverter yoktur.
utf8Json
null
.
İ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