XmlArrayItemAttribute.NestingLevel Properti

Definisi

Ruang nama:

System.Xml.Serialization

Rakitan:

netstandard.dll, System.Xml.XmlSerializer.dll

Sumber:

XmlArrayItemAttribute.cs

Mendapatkan atau mengatur tingkat dalam hierarki elemen XML yang XmlArrayItemAttribute terpengaruh.

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

Nilai Properti

Int32

Indeks berbasis nol dari sekumpulan indeks dalam array array.

Contoh

Contoh berikut menerapkan tiga XmlArrayItemAttribute atribut ke array array. Untuk menentukan array mana yang berlaku untuk setiap atribut, NestingLevel properti diatur ke indeks array.

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

Keterangan

Dokumen XML dapat berisi hierarki elemen XML. Untuk mewakili hierarki seperti itu, array array digunakan. Dalam array seperti itu, setiap indeks mewakili tingkat dalam hierarki. Oleh karena itu, NestingLevel properti hanya digunakan saat menerapkan XmlArrayItemAttribute ke bidang yang mengembalikan array array.

Saat menerapkan atribut, tentukan tingkat hierarki mana yang dipengaruhi atribut dengan mengatur NestingLevel. Indeks pertama selalu memiliki nilai 0; oleh karena itu bersifat opsional untuk mengatur - NestingLevel -an XmlArrayItemAttribute tanpa NestingLevel nilai diterapkan ke indeks array pertama. Hanya objek berikutnya XmlArrayItemAttribute yang memerlukan NestingLevel nilai yang ditentukan (sebagai 1, 2, 3, dan sebagainya).