XmlArrayItemAttribute.NestingLevel Özellik

Tanım

Ad Alanı:

System.Xml.Serialization

Bütünleştirilmiş Kod:

System.Xml.XmlSerializer.dll

Kaynak:

XmlArrayItemAttribute.cs

Etkilediği XML öğeleri XmlArrayItemAttribute hiyerarşisindeki düzeyi alır veya ayarlar.

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

Özellik Değeri

Int32

Dizi dizilerindeki dizin kümesinin sıfır tabanlı dizini.

Örnekler

Aşağıdaki örnek, bir dizi dizisine üç XmlArrayItemAttribute öznitelik uygular. Her özniteliğin hangi dizilere uygulanacağını belirtmek için özelliği dizilerin NestingLevel dizinine ayarlanır.

#using <System.dll>
#using <System.Xml.dll>

using namespace System;
using namespace System::Xml;
using namespace System::Xml::Serialization;
using namespace System::IO;

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

int main()
{
    XmlSerializer^ serializer = gcnew XmlSerializer(Forest::typeid);

    Forest^ constructedForest = gcnew Forest();
    array<array<array<String^>^>^>^ tree = 
        gcnew array<array<array<String^>^>^>(2);

    array<array<String^>^>^ firstBranch = gcnew array<array<String^>^>(1);
    firstBranch[0] = gcnew array<String^>{"One"};
    tree[0] = firstBranch;

    array<array<String^>^>^ secondBranch = gcnew array<array<String^>^>(2);
    secondBranch[0] = gcnew array<String^>{"One","Two"};
    secondBranch[1] = gcnew array<String^>{"One","Two","Three"};
    tree[1] = secondBranch;

    constructedForest->TreeArray = tree;

    serializer->Serialize(Console::Out, constructedForest);
}

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

Açıklamalar

XML belgesi, XML öğelerinin hiyerarşilerini içerebilir. Böyle bir hiyerarşiyi temsil etmek için dizi dizisi kullanılır. Böyle bir dizide, her dizin hiyerarşideki bir düzeyi temsil eder. Bu nedenle özelliği NestingLevel yalnızca dizi XmlArrayItemAttribute dizisi döndüren bir alana uygulanırken kullanılır.

özniteliğini uygularken özniteliğin hangi hiyerarşi düzeyini etkileyeceğini belirterek ayarını yapın NestingLevel. İlk dizin her zaman 0 değerine sahiptir; bu nedenle, ilk dizi dizinine bir değer uygulanmadan NestingLevel değerini XmlArrayItemAttribute ayarlamak NestingLevel isteğe bağlıdır. Yalnızca sonraki XmlArrayItemAttribute nesneler belirtilen değerleri gerektirir NestingLevel (1, 2, 3 vb.).