XmlArrayItemAttribute.NestingLevel Eigenschap

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

public int NestingLevel { get; set; }

member this.NestingLevel : int with get, set

Public Property NestingLevel As Integer

Waarde van eigenschap

De op nul gebaseerde index van een set indexen in een matrix met matrices.

Voorbeelden

In het volgende voorbeeld worden drie XmlArrayItemAttribute kenmerken toegepast op een matrix met matrices. Als u wilt opgeven op welke van de matrices elk kenmerk van toepassing is, wordt de NestingLevel eigenschap ingesteld op de index van de matrices.

using System;
using System.Xml;
using System.Xml.Serialization;
using System.IO;

public class Forest{
   /* Set the NestingLevel for each array. The first
   attribute (NestingLevel = 0) is optional. */
   [XmlArrayItem(ElementName = "tree", NestingLevel = 0)]
   [XmlArrayItem(ElementName = "branch", NestingLevel = 1)]
   [XmlArrayItem(ElementName = "leaf",NestingLevel = 2)]
   public string[][][] TreeArray;
}

public class Test{
   public static void Main(){
      Test t = new Test();
      t.SerializeObject("Tree.xml");
   }
   private void SerializeObject(string filename){
      XmlSerializer serializer =
      new XmlSerializer(typeof(Forest));

      Forest f = new Forest();
      string[][][] myTreeArray = new string[2] [][];

      string[][]myBranchArray1= new string[1][];
      myBranchArray1[0]=new string[1]{"One"};
      myTreeArray[0]=myBranchArray1;

      string[][]myBranchArray2= new string[2][];
      myBranchArray2[0]=new string[2]{"One","Two"};
      myBranchArray2[1]=new string[3]{"One","Two","Three"};
      myTreeArray[1]=myBranchArray2;

      f.TreeArray=myTreeArray;

     serializer.Serialize(Console.Out, f);
   }
}

Opmerkingen

Een XML-document kan hiërarchieën van XML-elementen bevatten. Om een dergelijke hiërarchie weer te geven, wordt een matrix met matrices gebruikt. In een dergelijke matrix vertegenwoordigt elke index een niveau in de hiërarchie. Daarom wordt de NestingLevel eigenschap alleen gebruikt bij het toepassen van een XmlArrayItemAttribute veld dat een matrix met matrices retourneert.

Wanneer u het kenmerk toepast, geeft u op welk hiërarchieniveau het kenmerk beïnvloedt door het instellen van de NestingLevel. De eerste index heeft altijd de waarde 0; daarom is het optioneel om de waarde --an NestingLevel in te stellen XmlArrayItemAttribute zonder dat er een NestingLevel waarde wordt toegepast op de eerste matrixindex. Alleen de volgende XmlArrayItemAttribute objecten vereisen waarden die zijn NestingLevel opgegeven (als 1, 2, 3 enzovoort).