dotnet / dotnet/dotnet-api-docs

Missing doc for JsonSerializer.DeserializeAsync returns

Aperta
#9,801 2 commenti 0 reazioni 0 assegnatari Vedi su GitHub
area-System.Text.Json Pri3
Lingua principale
C#
Stelle
949
Fork
1.7k
Merge medio
2g 19h
PR unite (30g)
52

Descrizione

Hi,
In the generic methods, the return type is nullable, but there is no documentation on how it is possible. Is it possible?

Also, it is minor, but the sections `Exceptions` aren't formatted the same way in the 5 methods: exceptions aren't in the same order and the JsonException have 2 different look.

Article: https://learn.microsoft.com/dotnet/api/system.text.json.jsonserializer.deserializeasync?view=net-8.0

Guida per i contributori

Apri la guida per i contributori

Direzione di ricerca

Inizia dall'articolo API collegato su JsonSerializer.DeserializeAsync e confronta le cinque voci dei metodi generici. Esamina le sezioni relative al valore restituito e alle eccezioni, quindi aggiorna la documentazione in modo da spiegare il comportamento del valore restituito nullable e rendere coerenti in tutti e cinque i metodi l'ordine delle eccezioni e la formattazione di JsonException.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
csharp
Ambito
documentation
Tipo di issue
Documentazione
Difficoltà
2/5
Tempo stimato
1-3 ore
Stato di attività
Ferma
Chiarezza
Abbastanza chiara
Idoneità per principianti
48/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.