XmlLoadSettings.MaxElementDepth Propriedade

Definição

Namespace:

Windows.Data.Xml.Dom

Obtém e define os limites da profundidade do elemento de um documento XML a ser carregado em um objeto DOM.

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

Valor da propriedade

UInt32

unsigned int

uint32_t

O valor de profundidade. O valor padrão é 256.

Comentários

Um valor zero (0) significa que não há limite para a profundidade do elemento de um documento XML. Um valor diferente de zero especifica a profundidade máxima.

Uma entidade conta como um nível de aninhamento. Por exemplo, se você tiver uma entidade que faça referência a um documento XML que inclua dois elementos XML aninhados, defina o valor como 3.

Quando o objeto DOM é clonado, o valor dessa propriedade é propagado para o objeto clonado. Quando o tamanho de um documento XML exceder o limite definido por essa propriedade, quando o documento for analisado resultará um erro ao carregar.

Essa propriedade ajuda a evitar ataques negação de serviço em que um documento com profundidade excessiva do elemento seja enviado. A não limitação da profundidade do elemento deixa você vulnerável a um ataque em que um documento XML relativamente pequeno pode causar negação de serviço. A propriedade MaxElementDepth atenua essa ameaça. Se você estiver preocupado com a negação de serviço, defina essa propriedade como um valor que permite carregar os seus documentos, mas limita a profundidade a um nível razoável.