XmlArrayItemAttribute.NestingLevel Propiedad

Definición

Espacio de nombres:

System.Xml.Serialization

Ensamblado:

System.Xml.XmlSerializer.dll

Source:

XmlArrayItemAttribute.cs

Obtiene o establece el nivel en una jerarquía de elementos XML a los que afecta 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

Valor de propiedad

Int32

Índice de base cero de un conjunto de índices en una matriz de matrices.

Ejemplos

En el ejemplo siguiente se aplican tres XmlArrayItemAttribute atributos a una matriz de matrices. Para especificar a cuál de las matrices se aplica cada atributo, la NestingLevel propiedad se establece en el índice de las matrices.

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

Comentarios

Un documento XML puede contener jerarquías de elementos XML. Para representar esta jerarquía, se usa una matriz de matrices. En esta matriz, cada índice representa un nivel de la jerarquía. Por lo tanto, la NestingLevel propiedad solo se usa al aplicar un objeto XmlArrayItemAttribute a un campo que devuelve una matriz de matrices.

Al aplicar el atributo , especifique qué nivel de jerarquía afecta el atributo estableciendo .NestingLevel El primer índice siempre tiene el valor 0; por lo tanto, es opcional establecer su NestingLevel --an XmlArrayItemAttribute sin un NestingLevel valor se aplica al primer índice de matriz. Solo los objetos siguientes XmlArrayItemAttribute requieren NestingLevel valores especificados (como 1, 2, 3, etc.).