XmlArrayItemAttribute Sınıf

Tanım

Ad Alanı:

System.Xml.Serialization

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.XmlSerializer.dll

Kaynak:

XmlArrayItemAttribute.cs

XmlSerializer serileştirilmiş diziye yerleştirebileceği türetilmiş türleri belirten bir özniteliği temsil eder.

public ref class XmlArrayItemAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property | System.AttributeTargets.ReturnValue, AllowMultiple=true)]
public class XmlArrayItemAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property | System.AttributeTargets.ReturnValue, AllowMultiple=true)>]
type XmlArrayItemAttribute = class
    inherit Attribute

Public Class XmlArrayItemAttribute
Inherits Attribute

Devralma

Object

Attribute

XmlArrayItemAttribute

Öznitelikler

AttributeUsageAttribute

Örnekler

Aşağıdaki örnek, bir nesne dizisi Group döndüren adlı Employees bir alan içeren adlı Employee sınıfı serileştirir. Örnek, alanını uygular XmlArrayItemAttribute ve böylece XmlSerializer hem temel sınıf () türünde hem de türetilmiş sınıf türünde (EmployeeManager) nesneleri serileştirilmiş diziye ekleyebileceğini bildirir.

using System;
using System.IO;
using System.Xml.Serialization;

public class Group
{
   /* The XmlArrayItemAttribute allows the XmlSerializer to insert
      both the base type (Employee) and derived type (Manager)
      into serialized arrays. */

   [XmlArrayItem(typeof(Manager)),
   XmlArrayItem(typeof(Employee))]
   public Employee[] Employees;

   /* Use the XmlArrayItemAttribute to specify types allowed
      in an array of Object items. */
   [XmlArray]
   [XmlArrayItem (typeof(int),
   ElementName = "MyNumber"),
   XmlArrayItem (typeof(string),
   ElementName = "MyString"),
   XmlArrayItem(typeof(Manager))]
   public object [] ExtraInfo;
}

public class Employee
{
   public string Name;
}

public class Manager:Employee{
   public int Level;
}

public class Run
{
   public static void Main()
   {
      Run test = new Run();
      test.SerializeObject("TypeDoc.xml");
      test.DeserializeObject("TypeDoc.xml");
   }

   public void SerializeObject(string filename)
   {
      // Creates a new XmlSerializer.
      XmlSerializer s = new XmlSerializer(typeof(Group));

      // Writing the XML file to disk requires a TextWriter.
      TextWriter writer = new StreamWriter(filename);
      Group group = new Group();

      Manager manager = new Manager();
      Employee emp1 = new Employee();
      Employee emp2 = new Employee();
      manager.Name = "Consuela";
      manager.Level = 3;
      emp1.Name = "Seiko";
      emp2.Name = "Martina";
      Employee [] emps = new Employee[3]{manager, emp1, emp2};
      group.Employees = emps;

      // Creates an int and a string and assigns to ExtraInfo.
      group.ExtraInfo = new Object[3]{43, "Extra", manager};

      // Serializes the object, and closes the StreamWriter.
      s.Serialize(writer, group);
      writer.Close();
   }

   public void DeserializeObject(string filename)
   {
      FileStream fs = new FileStream(filename, FileMode.Open);
      XmlSerializer x = new XmlSerializer(typeof(Group));
      Group g = (Group) x.Deserialize(fs);
      Console.WriteLine("Members:");

      foreach(Employee e in g.Employees)
      {
         Console.WriteLine("\t" + e.Name);
      }
   }
}

Option Explicit
Option Strict

Imports System.IO
Imports System.Xml.Serialization

Public Class Group
    ' The XmlArrayItemAttribute allows the XmlSerializer to insert
    ' both the base type (Employee) and derived type (Manager)
    ' into serialized arrays. 
    
    <XmlArrayItem(GetType(Manager)), _
     XmlArrayItem(GetType(Employee))> _
    Public Employees() As Employee
    
    ' Use the XmlArrayItemAttribute to specify types allowed
    ' in an array of Object items. 
    <XmlArray(), _
     XmlArrayItem(GetType(Integer), ElementName := "MyNumber"), _
     XmlArrayItem(GetType(String), ElementName := "MyString"), _
     XmlArrayItem(GetType(Manager))> _
    Public ExtraInfo() As Object
End Class

Public Class Employee
    Public Name As String
End Class

Public Class Manager
    Inherits Employee
    Public Level As Integer
End Class


Public Class Run
    
    Public Shared Sub Main()
        Dim test As New Run()
        test.SerializeObject("TypeDoc.xml")
        test.DeserializeObject("TypeDoc.xml")
    End Sub
    
       
    Public Sub SerializeObject(ByVal filename As String)
        ' Creates a new XmlSerializer.
        Dim s As New XmlSerializer(GetType(Group))
        
        ' Writing the XML file to disk requires a TextWriter.
        Dim writer As New StreamWriter(filename)
        Dim group As New Group()
        
        Dim manager As New Manager()
        Dim emp1 As New Employee()
        Dim emp2 As New Employee()
        manager.Name = "Consuela"
        manager.Level = 3
        emp1.Name = "Seiko"
        emp2.Name = "Martina"
        Dim emps() As Employee = {manager, emp1, emp2}
        group.Employees = emps
        
        ' Creates an int and a string and assigns to ExtraInfo.
        group.ExtraInfo = New Object() {43, "Extra", manager}
        
        ' Serializes the object, and closes the StreamWriter.
        s.Serialize(writer, group)
        writer.Close()
    End Sub
    
    
    Public Sub DeserializeObject(ByVal filename As String)
        Dim fs As New FileStream(filename, FileMode.Open)
        Dim x As New XmlSerializer(GetType(Group))
        Dim g As Group = CType(x.Deserialize(fs), Group)
        Console.WriteLine("Members:")
        
        Dim e As Employee
        For Each e In  g.Employees
            Console.WriteLine(ControlChars.Tab & e.Name)
        Next e
    End Sub
End Class

Açıklamalar

, XmlArrayItemAttribute bir nesnenin seri hale nasıl getirildiğini veya seri durumdan XmlSerializer çıkarıldığını denetleen bir öznitelik ailesine aittir. Benzer özniteliklerin tam listesi için bkz. XML Serileştirmesini Denetleen Öznitelikler.

öğesini XmlArrayItemAttribute bir dizi döndüren veya bir diziye erişim sağlayan herhangi bir genel okuma/yazma üyesine uygulayabilirsiniz. Örneğin, bir nesne dizisi, koleksiyon, bir veya arabirimi uygulayan ArrayList herhangi bir IEnumerablesınıf döndüren bir alan.

, XmlArrayItemAttribute polimorfizmi destekler; başka bir deyişle, bir diziye türetilmiş nesneler eklemesine izin verir XmlSerializer . Örneğin, adlı bir sınıfın adlı MammalAnimalbir temel sınıftan türetilmiş olduğunu varsayalım. Ayrıca adlı MyAnimals sınıfın bir nesne dizisi döndüren bir alan içerdiğini Animal varsayalım. hem hem de türünü seri hale getirmesine izin vermek XmlSerializer için, her seferinde kabul edilebilir iki türden birini belirterek alanını iki kez uygulayınAnimal.MammalXmlArrayItemAttribute

Note

diziye eklenebilen XmlArrayItemAttribute nesne türlerini belirtmek için veya XmlElementAttribute öğesinin birden çok örneğini uygulayabilirsiniz.

Note

Arabirim veya arabirim dizisi döndüren bir alanın veya özelliğin seri hale getirilmesi desteklenmez.

Öznitelikleri kullanma hakkında daha fazla bilgi için bkz . Öznitelikler.

Note

uzun yerine XmlArrayItemkodunuzda sözcüğünü XmlArrayItemAttribute kullanabilirsiniz.

Oluşturucular

Name	Description
XmlArrayItemAttribute()	XmlArrayItemAttribute sınıfının yeni bir örneğini başlatır.
XmlArrayItemAttribute(String, Type)	sınıfının yeni bir örneğini XmlArrayItemAttribute başlatır ve XML belgesinde oluşturulan XML öğesinin adını ve Type oluşturulan XML belgesine eklenebilen öğesini belirtir.
XmlArrayItemAttribute(String)	Sınıfının yeni bir örneğini XmlArrayItemAttribute başlatır ve XML belgesinde oluşturulan XML öğesinin adını belirtir.
XmlArrayItemAttribute(Type)	sınıfının yeni bir örneğini XmlArrayItemAttribute başlatır ve serileştirilmiş diziye eklenebilen öğesini belirtir Type .

Özellikler

Name	Description
DataType	Oluşturulan XML öğesinin XML veri türünü alır veya ayarlar.
ElementName	Oluşturulan XML öğesinin adını alır veya ayarlar.
Form	Oluşturulan XML öğesinin adının nitelenmiş olup olmadığını gösteren bir değer alır veya ayarlar.
IsNullable	öğesinin, özniteliği olarak ayarlanmış XmlSerializerboş bir XML etiketi olarak bir üyeyi seri hale getirmesi xsi:nil gerekip gerekmediğini true belirten bir değer alır veya ayarlar.
Namespace	Oluşturulan XML öğesinin ad alanını alır veya ayarlar.
NestingLevel	Etkilediği XML öğelerinin XmlArrayItemAttribute hiyerarşisindeki düzeyi alır veya ayarlar.
Type	Dizide izin verilen türü alır veya ayarlar.
TypeId	Türetilmiş bir sınıfta uygulandığında, bu Attributeiçin benzersiz bir tanımlayıcı alır. (Devralındığı yer: Attribute)

Yöntemler

Name	Description
Equals(Object)	Bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür. (Devralındığı yer: Attribute)
GetHashCode()	Bu örneğin karma kodunu döndürür. (Devralındığı yer: Attribute)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
IsDefaultAttribute()	Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin değerinin türetilmiş sınıf için varsayılan değer olup olmadığını gösterir. (Devralındığı yer: Attribute)
Match(Object)	Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür. (Devralındığı yer: Attribute)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• XmlArrayAttribute
• XmlSerializer
• XmlArrayItems
• XmlAttributeOverrides
• XmlAttributes
• XML Serileştirmeye Giriş
• Nasıl yapılır: XML Akışı için Alternatif Öğe Adı Belirtme
• Öznitelikleri Kullanarak XML Serileştirmesini Denetleme
• XML Serileştirme Örnekleri
• XML Şema Tanımı Aracı (XSD.exe)