XmlLoadSettings.MaxElementDepth 屬性

定義

命名空間:

Windows.Data.Xml.Dom

取得並設定要載入 DOM 物件之 XML 檔之專案深度的限制。

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

uint32_t MaxElementDepth();

void MaxElementDepth(uint32_t value);

public uint MaxElementDepth { get; set; }

var uInt32 = xmlLoadSettings.maxElementDepth;
xmlLoadSettings.maxElementDepth = uInt32;

Public Property MaxElementDepth As UInteger

屬性值

UInt32

unsigned int

uint32_t

深度值。 預設值為 256。

備註

零 (0) 值表示 XML 檔的元素深度沒有限制。 非零值會指定最大深度。

實體會計算為一個巢狀層級。 例如，如果您有參考包含兩個巢狀 XML 元素之 XML 檔的實體，請將值設定為 3。

複製 DOM 物件時，這個屬性的值會傳播至複製的物件。 當 XML 檔的大小超過此屬性所設定的限制時，剖析檔時會產生載入錯誤。

此屬性有助於避免提交具有過多元素深度的檔遭到拒絕服務攻擊。 無法限制元素深度會讓您開放至惡意探索，其中相對小型的 XML 檔可能會導致拒絕服務。 MaxElementDepth屬性可減輕此威脅。 如果您擔心拒絕服務，您應該將此屬性設定為值，讓您載入檔，但會將深度限制為合理的層級。