XmlLoadSettings.MaxElementDepth Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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.