XmlLoadSettings.MaxElementDepth Propriété

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

Valeur de propriété

Valeur de profondeur. La valeur par défaut est 256.

Remarques

Une valeur zéro (0) signifie aucune limite de profondeur d’élément d’un document XML. Une valeur autre que zéro spécifie la profondeur maximale.

Une entité compte comme un niveau d’imbrication. Par exemple, si vous avez une entité qui fait référence à un document XML qui comprend deux éléments XML imbriqués, définissez la valeur sur 3.

Lorsque l’objet DOM est cloné, la valeur de cette propriété est propagée à l’objet cloné. Lorsque la taille d’un document XML dépasse la limite définie par cette propriété, une erreur de chargement se produit lorsque le document est analysé.

Cette propriété permet d’éviter les attaques par déni de service dans lesquelles est envoyé un document dont la profondeur d’élément est excessive. Si vous ne limitez pas la profondeur de l’élément, vous êtes ouvert à l’exploit où un document XML relativement petit peut provoquer un déni de service. La propriété MaxElementDepth atténue cette menace. Si vous craignez les attaques par déni de service, vous devez définir cette propriété sur une valeur qui vous autorise à charger vos documents avec une profondeur hiérarchique raisonnable.

S’applique à