JsonSerializerOptions.DefaultBufferSize Właściwość

Definicja

Przestrzeń nazw:

System.Text.Json

Zestaw:

System.Text.Json.dll

Źródło:

JsonSerializerOptions.cs

Pobiera lub ustawia domyślny rozmiar buforu w bajtach do użycia podczas tworzenia buforów tymczasowych.

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

Wartość właściwości

Int32

Domyślny rozmiar buforu w bajtach.

Wyjątki

ArgumentException

Rozmiar buforu jest mniejszy niż 1.

InvalidOperationException

Ta właściwość została ustawiona po serializacji lub deserializacji.

Uwagi

Domyślny rozmiar buforu w bajtach wynosi 16 384. W przypadku większości obciążeń domyślny rozmiar jest rozsądną ilością danych JSON do buforowania podczas odczytywania ze strumienia lub zapisywania w strumieniu. Oznacza to, że działa dobrze bez tworzenia obiektów na stercie dużych obiektów dla modułu odśmiecowania pamięci (GC) do śledzenia. W scenariuszach bez przesyłania strumieniowego zwiększenie domyślnego rozmiaru buforu może poprawić wydajność dla dużych ciągów JSON lub tablic bajtów UTF-8. Zalecamy pozostawienie tej wartości bez zmian, chyba że jej zmiana powoduje zauważalną różnicę w wydajności.