JsonSerializerOptions.DefaultBufferSize Proprietà

Definizione

Spazio dei nomi:

System.Text.Json

Assembly:

System.Text.Json.dll

Pacchetto:

System.Text.Json v9.0.0-preview.3.24172.9

Origine:

JsonSerializerOptions.cs

Ottiene o imposta le dimensioni predefinite del buffer, in byte, da usare per la creazione di buffer temporanei.

public:
 property int DefaultBufferSize { int get(); void set(int value); };

public int DefaultBufferSize { get; set; }

member this.DefaultBufferSize : int with get, set

Public Property DefaultBufferSize As Integer

Valore della proprietà

Int32

Dimensioni predefinite del buffer in byte.

Eccezioni

ArgumentException

Le dimensioni del buffer sono minori di 1.

InvalidOperationException

Questa proprietà è stata impostata dopo la serializzazione o deserializzazione.

Commenti

La dimensione predefinita del buffer, in byte, è 16.384. Per la maggior parte dei carichi di lavoro, le dimensioni predefinite sono una quantità ragionevole di JSON da memorizzare nel buffer durante la lettura da un flusso o la scrittura in un flusso. Ciò significa che funziona correttamente senza creare oggetti nell'heap di oggetti Large per il Garbage Collector (GC) da tenere traccia. Negli scenari non di streaming, l'aumento delle dimensioni predefinite del buffer potrebbe migliorare le prestazioni per stringhe JSON di grandi dimensioni o matrici di byte UTF-8. È consigliabile lasciare invariato questo valore, a meno che la modifica non faccia una differenza osservabile nelle prestazioni.