XmlArrayItemAttribute.NestingLevel Tulajdonság

Definíció

Névtér:

System.Xml.Serialization

Szerelvények:

netstandard.dll, System.Xml.XmlSerializer.dll

Forrás:

XmlArrayItemAttribute.cs

Lekéri vagy beállítja a szintet az érintett XML-elemek hierarchiájában XmlArrayItemAttribute .

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

Tulajdonság értéke

Int32

Egy tömbtömb indexeinek nullaalapú indexe.

Példák

Az alábbi példa három XmlArrayItemAttribute attribútumot alkalmaz tömbök tömbjeire. Annak megadásához, hogy az egyes attribútumok mely tömbökre vonatkoznak, a NestingLevel tulajdonság a tömbök indexére van állítva.

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

Megjegyzések

Az XML-dokumentumok tartalmazhatnak XML-elemek hierarchiáját. Egy ilyen hierarchia ábrázolásához tömbök tömbje van használatban. Egy ilyen tömbben minden index a hierarchia egy szintjét jelöli. Ezért a NestingLevel tulajdonság csak tömbtömböket visszaadó mezőkre való alkalmazáskor XmlArrayItemAttribute használatos.

Az attribútum alkalmazásakor adja meg, hogy az attribútum milyen hierarchiaszintet érint a NestingLevelbeállítással. Az első index értéke mindig 0; ezért nem kötelező megadni az NestingLevel --an XmlArrayItemAttribute értéket az NestingLevel első tömbindexre alkalmazva. Csak a következő XmlArrayItemAttribute objektumokhoz van szükség megadott értékekre NestingLevel (1, 2, 3 és így tovább).