XmlAttributes.XmlAnyElements Proprietà

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

Valore della proprietà

Oggetto XmlAnyElementAttributes che rappresenta l'insieme di XmlAnyElementAttribute oggetti .

Esempio

Nell'esempio seguente viene creato un nuovo XmlAnyElementAttribute oggetto e viene aggiunto all'insieme di oggetti a cui si accede tramite la XmlAnyElements proprietà . L'oggetto XmlAttributes viene quindi aggiunto a un XmlAttributeOverrides oggetto utilizzato per creare un XmlSerializer oggetto . Viene XmlSerializer utilizzato per serializzare o deserializzare un oggetto . Per visualizzare l'effetto dell'utilizzo della XmlAnyElementAttributes proprietà , creare un documento XML denominato "UnknownElements.xml" eseguendo il SerializeObject metodo nel Main metodo . Modificare il documento risultante per includere altri elementi (sconosciuti). Impostare come commento la SerializeObject chiamata nel Main metodo e rimuovere il commento dalla chiamata al DeserializeObject metodo , che stampa il nome e il valore di qualsiasi elemento XML sconosciuto.

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

Commenti

Può XmlAnyElementAttribute essere applicato a un membro che restituisce una matrice di XmlElement oggetti sulla deserializzazione. In questo modo è XmlSerializer possibile deserializzare tutti gli elementi che non dispongono di un membro corrispondente nell'oggetto da deserializzare, pertanto tali elementi sono "sconosciuti" all'oggetto XmlSerializer. Ciò è utile quando il flusso XML è stato modificato da un servizio Web XML o quando è noto che i dati casuali vengono sempre inclusi nel flusso XML.

La XmlAnyElements proprietà consente di eseguire l'override della serializzazione di un membro in modo che funzioni come membro a cui è stato applicato l'oggetto XmlAnyElementAttribute .

Vedi anche

• XmlAnyAttribute