XmlArrayItemAttribute.NestingLevel Egenskap

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

Egenskapsvärde

Nollbaserat index för en uppsättning index i en matris med matriser.

Exempel

I följande exempel tillämpas tre XmlArrayItemAttribute attribut på en matris med matriser. Om du vill ange vilken av matriserna som varje attribut gäller för, NestingLevel ställs egenskapen in på matrisernas index.

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);
   }
}

Kommentarer

Ett XML-dokument kan innehålla hierarkier med XML-element. För att representera en sådan hierarki används en matris med matriser. I en sådan matris representerar varje index en nivå i hierarkin. Därför NestingLevel används egenskapen endast när du tillämpar ett XmlArrayItemAttribute på ett fält som returnerar en matris med matriser.

När du använder attributet anger du vilken hierarkinivå attributet påverkar genom att NestingLevelange . Det första indexet har alltid värdet 0. Därför är det valfritt att ange dess NestingLevel - ett XmlArrayItemAttribute utan värde NestingLevel tillämpas på det första matrisindexet. Endast efterföljande XmlArrayItemAttribute objekt kräver NestingLevel angivna värden (som 1, 2, 3 och så vidare).