XmlDictionaryReaderQuotas.MaxBytesPerRead Proprietà

Definizione

Spazio dei nomi:

System.Xml

Assembly:

System.Runtime.Serialization.Xml.dll

Assembly:

System.Runtime.Serialization.dll

Assembly:

netstandard.dll

Ottiene o imposta i byte massimi consentiti restituiti per ogni lettura.

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

public int MaxBytesPerRead { get; set; }

member this.MaxBytesPerRead : int with get, set

Public Property MaxBytesPerRead As Integer

Valore della proprietà

Int32

Byte massimi consentiti restituiti per ogni lettura. Il valore predefinito è 4096.

Eccezioni

InvalidOperationException

Tentativo di impostare (set) il valore. I valori di quota di questa istanza, tuttavia, sono in sola lettura.

ArgumentException

Tentativo di impostare (set) il valore su minore di zero.

Commenti

Questa quota limita il numero di byte che possono essere utilizzati dal reader durante una singola chiamata a Read().

Questa quota è un'approssimazione perché, prima che venga applicata, si verificano trasformazioni nel livello di codifica. Questa quota dipende fortemente dal numero di byte ricevuti in transito a livello di trasporto, ma il suo scopo è controllare la quantità di dati ricevuti per ogni lettura. Viene utilizzata, in pratica, per limitare le dimensioni dei tag di inizio. Poiché, per essere elaborato, il tag di inizio deve essere memorizzato per intero nel buffer (è necessario verificare che gli attributi siano univoci), le dimensioni devono essere limitate per ridurre gli attacchi DoS.

Le istanze create con il costruttore pubblico hanno proprietà che possono essere impostate (set).