XmlDictionaryReaderQuotas.MaxStringContentLength 屬性

定義

命名空間:

System.Xml

組件:

System.Runtime.Serialization.Xml.dll

組件:

System.Runtime.Serialization.dll

組件:

netstandard.dll

取得或設定讀取器傳回的字串長度上限。

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

public int MaxStringContentLength { get; set; }

member this.MaxStringContentLength : int with get, set

Public Property MaxStringContentLength As Integer

屬性值

Int32

讀取器傳回的字串長度上限。 預設值為 8192。

例外狀況

InvalidOperationException

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

ArgumentException

嘗試將此值 set 為小於零。

備註

這個配額會限制各種 API 所建立和傳回的字串長度。 當呼叫 Read() 和檢查 Value 屬性時，讀取器會將字串值區塊分割成可管理的片段 (若處於資料流 (Streaming) 模式中)。 不過，呼叫 ReadContentAsString() 便可將這些片段全部串連在一起，而傳回一個龐大的字串。 使用二進位格式時，如果項目節點的值是字典字串識別項的序列，這些字串值就會進行串連。 這樣可以獲得極為充分的擴展，進而降低這個限制的影響程度。