XmlAttributes.XmlAnyElements Properti

Definisi

Ruang nama:

System.Xml.Serialization

Rakitan:

netstandard.dll, System.Xml.XmlSerializer.dll

Sumber:

XmlAttributes.cs

Mendapatkan kumpulan XmlAnyElementAttribute objek untuk diambil alih.

public:
 property System::Xml::Serialization::XmlAnyElementAttributes ^ XmlAnyElements { System::Xml::Serialization::XmlAnyElementAttributes ^ get(); };

public System.Xml.Serialization.XmlAnyElementAttributes XmlAnyElements { get; }

member this.XmlAnyElements : System.Xml.Serialization.XmlAnyElementAttributes

Public ReadOnly Property XmlAnyElements As XmlAnyElementAttributes

Nilai Properti

XmlAnyElementAttributes

Objek XmlAnyElementAttributes yang mewakili kumpulan XmlAnyElementAttribute objek.

Contoh

Contoh berikut membuat objek baru XmlAnyElementAttribute dan menambahkannya ke kumpulan objek yang diakses melalui XmlAnyElements properti . Objek XmlAttributes kemudian ditambahkan ke XmlAttributeOverrides objek yang digunakan untuk membuat XmlSerializer objek. XmlSerializer digunakan untuk menserialisasikan atau mendeserialisasi objek. Untuk melihat efek penggunaan XmlAnyElementAttributes properti, buat dokumen XML bernama "UnknownElements.xml" dengan menjalankan SerializeObject metode dalam Main metode . Edit dokumen yang dihasilkan untuk menyertakan elemen (tidak diketahui) lainnya. Komentari SerializeObject panggilan dalam Main metode , dan batalkan komentar panggilan ke DeserializeObject metode , yang mencetak nama dan nilai elemen XML yang tidak diketahui.

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

public class Group{
   public string GroupName;
   [XmlAnyElement]
   public object[]Things;
}

public class Test{
   static void Main(){
      Test t = new Test();
      // 1 Run this and create the XML document.
      // 2 Add new elements to the XML document.
      // 3 Comment out the new line, and uncomment
      // the DeserializeObject line to deserialize the
      // XML document and see unknown elements.
      t.SerializeObject("UnknownElements.xml");
     
      // t.DeserializeObject("UnknownElements.xml");
   }

   private void SerializeObject(string filename){
      XmlSerializer ser = new XmlSerializer(typeof (Group));
      TextWriter writer = new StreamWriter(filename);
      Group g = new Group();
      g.GroupName = "MyGroup";
      ser.Serialize(writer, g);
      writer.Close();
   }

   private void DeserializeObject(string filename){

      XmlSerializer ser = CreateOverrideSerializer();
      // A FileStream is needed to read the XML document.
      FileStream fs = new FileStream(filename, FileMode.Open);
     Group g = (Group)
        ser.Deserialize(fs);
     fs.Close();
     Console.WriteLine(g.GroupName);
     Console.WriteLine(g.Things.Length);
     foreach(XmlElement xelement in g.Things){
     Console.WriteLine(xelement.Name + ": " + xelement.InnerXml);
     }
   }

   private XmlSerializer CreateOverrideSerializer(){
      XmlAnyElementAttribute myAnyElement = 
      new XmlAnyElementAttribute();
      XmlAttributeOverrides xOverride = 
      new XmlAttributeOverrides();
      XmlAttributes xAtts = new XmlAttributes();
      xAtts.XmlAnyElements.Add(myAnyElement);
      xOverride.Add(typeof(Group), "Things", xAtts);
      return new XmlSerializer(typeof(Group) , xOverride);
   }
}

Imports System.IO
Imports System.Xml.Serialization
Imports System.Xml

Public Class Group
   Public GroupName As String 
   <XmlAnyElement> _
   Public Things () As object
End Class

Public Class Test
   Shared Sub Main()
      Dim t As Test = New Test()
      ' 1 Run this and create the XML document.
      ' 2 Add New elements to the XML document.
      ' 3 Comment out the New line, and uncomment
      ' the DeserializeObject line to deserialize the
      ' XML document and see unknown elements.
     t.SerializeObject("UnknownElements.xml")
     
      't.DeserializeObject("UnknownElements.xml")
   End Sub

   Private Sub SerializeObject(filename As String)
      Dim ser As XmlSerializer = New XmlSerializer(GetType (Group))
      Dim writer As TextWriter = New StreamWriter(filename)
      
      Dim g As Group = New Group()
      g.GroupName = "MyGroup"
      ser.Serialize(writer, g)
      writer.Close()
   End Sub

   
   Private Sub DeserializeObject(filename As String)

      Dim ser As XmlSerializer = CreateOverrideSerializer()
      ' A FileStream is needed to read the XML document.
      Dim fs As FileStream = New FileStream(filename, FileMode.Open)
     Dim g As Group = CType( _
        ser.Deserialize(fs), Group)
     fs.Close()
     Console.WriteLine(g.GroupName)
     Console.WriteLine(g.Things.Length)
     Dim xelement As XmlELement
     for each xelement in g.Things
        Console.WriteLine(xelement.Name &": " & xelement.InnerXml)
     next
   End Sub
   

   Private Function CreateOverrideSerializer() As XmlSerializer 
      Dim myAnyElement As XmlAnyElementAttribute = _
      New XmlAnyElementAttribute()
      Dim xOverride As XmlAttributeOverrides = _
      New XmlAttributeOverrides()
      Dim xAtts As XmlAttributes = New XmlAttributes()
      xAtts.XmlAnyElements.Add(myAnyElement)
      xOverride.Add(GetType(Group), "Things", xAtts)
      return New XmlSerializer(GetType(Group) , xOverride)
   End Function
End Class

Keterangan

XmlAnyElementAttribute dapat diterapkan ke anggota yang mengembalikan array XmlElement objek pada deserialisasi. Ini memungkinkan XmlSerializer untuk mendeserialisasi elemen apa pun yang tidak memiliki anggota yang sesuai dalam objek yang dideserialisasi--dengan demikian elemen-elemen tersebut "tidak diketahui" ke XmlSerializer. Ini berguna ketika aliran XML telah diubah oleh layanan Web XML, atau ketika diketahui bahwa data acak selalu disertakan dengan aliran XML.

Properti XmlAnyElements memungkinkan Anda untuk mengambil alih serialisasi anggota untuk berfungsi sebagai anggota yang XmlAnyElementAttribute telah diterapkan.

Lihat juga

• XmlAnyAttribute