XmlDictionaryReaderQuotas.MaxBytesPerRead 屬性

定義

命名空間:

System.Xml

組件:

System.Runtime.Serialization.Xml.dll

來源:

XmlDictionaryReaderQuotas.cs

取得或設定允許每個讀取動作傳回的位元組上限。

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

屬性值

Int32

允許每個讀取動作傳回的位元組上限。 預設值是 4096。

例外狀況

InvalidOperationException

嘗試 set 此值，但是配額值對於此執行個體而言是唯讀的。

ArgumentException

嘗試將此值 set 為小於零。

備註

這個配額會限制讀取器在呼叫一次 Read() 時所能取用的位元組數目。

這個配額只是個大約值，因為在套用這個配額之前，編碼層中的轉換已經開始進行。 這個配額與網路傳輸層級上所收到位元組數目關係密切，但其用途只是在控制每個讀取動作所接收的資料數量。 我們實際上會使用它來限制開始標記的大小。 因為整個開始標記必須先緩衝處理才能進行處理 (屬性唯一性必須經過驗證)，所以必須限制大小來降低 DOS 攻擊的風險。

透過公用建構函式所建立的執行個體具有可以 set 的屬性。