XmlAnyElementAttributes Classe

Riferimento

Definizione

Spazio dei nomi:: System.Xml.Serialization

Assembly:: System.Xml.XmlSerializer.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rappresenta una raccolta di oggetti XmlAnyElementAttribute.

public ref class XmlAnyElementAttributes : System::Collections::IList

public ref class XmlAnyElementAttributes : System::Collections::CollectionBase

public class XmlAnyElementAttributes : System.Collections.IList

public class XmlAnyElementAttributes : System.Collections.CollectionBase

type XmlAnyElementAttributes = class
    interface ICollection
    interface IEnumerable
    interface IList

type XmlAnyElementAttributes = class
    inherit CollectionBase

Public Class XmlAnyElementAttributes
Implements IList

Public Class XmlAnyElementAttributes
Inherits CollectionBase

Ereditarietà: Object
XmlAnyElementAttributes

Ereditarietà: Object

CollectionBase
XmlAnyElementAttributes

Implementazioni: ICollection IEnumerable IList

Esempio

Nell'esempio seguente viene creato un nuovo oggetto XmlAnyElementAttribute e lo aggiunge all'insieme di oggetti a cui si accede tramite la XmlAnyElements proprietà . Viene XmlAttributes quindi aggiunto a un XmlAttributeOverrides oggetto utilizzato per creare un XmlSerializeroggetto . Viene XmlSerializer usato per serializzare o deserializzare un oggetto. Per visualizzare l'effetto dell'uso 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). Aggiungere un commento alla chiamata nel Main metodo e annullare ilcommentazione SerializeObject della chiamata al DeserializeObject metodo, che stampa il nome e il valore di qualsiasi elemento XML sconosciuto.

#using <System.dll>
#using <System.xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml::Serialization;
using namespace System::Xml;
public ref class Group
{
public:
   String^ GroupName;

   [XmlAnyElement]
   array<Object^>^Things;
};

void SerializeObject( String^ filename );
void DeserializeObject( String^ filename );
XmlSerializer^ CreateOverrideSerializer();
int main()
{
   // 1 Run this and create the XML document.
   // 2 Add new elements to the XML document.
   // 3 Comment out the next line, and uncomment
   // the DeserializeObject line to deserialize the
   // XML document and see unknown elements.
   SerializeObject( "UnknownElements.xml" );

   // DeserializeObject(S"UnknownElements.xml");
}

void SerializeObject( String^ filename )
{
   XmlSerializer^ ser = gcnew XmlSerializer( Group::typeid );
   TextWriter^ writer = gcnew StreamWriter( filename );
   Group^ g = gcnew Group;
   g->GroupName = "MyGroup";
   ser->Serialize( writer, g );
   writer->Close();
}

void DeserializeObject( String^ filename )
{
   XmlSerializer^ ser = CreateOverrideSerializer();

   // A FileStream is needed to read the XML document.
   FileStream^ fs = gcnew FileStream( filename,FileMode::Open );
   Group^ g = safe_cast<Group^>(ser->Deserialize( fs ));
   fs->Close();
   Console::WriteLine( g->GroupName );
   Console::WriteLine( g->Things->Length );
   for ( int i = 0; i < g->Things->Length; ++i )
   {
      XmlElement^ xelement = safe_cast<XmlElement^>(g->Things[ i ]);
      Console::WriteLine( "{0}: {1}", xelement->Name, xelement->InnerXml );
   }
}

XmlSerializer^ CreateOverrideSerializer()
{
   XmlAnyElementAttribute^ myAnyElement = gcnew XmlAnyElementAttribute;
   XmlAttributeOverrides^ xOverride = gcnew XmlAttributeOverrides;
   XmlAttributes^ xAtts = gcnew XmlAttributes;
   xAtts->XmlAnyElements->Add( myAnyElement );
   xOverride->Add( Group::typeid, "Things", xAtts );
   return gcnew XmlSerializer( Group::typeid,xOverride );
}

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

Usare l'oggetto per eseguire l'override XmlAnyElementAttributes del comportamento di un set di XmlAnyElementAttribute oggetti. È possibile applicare più istanze della classe a un membro della XmlAnyElementAttribute classe, purché ogni istanza abbia un valore di proprietà distinto Name . Ciò indica di XmlSerializer raccogliere elementi sconosciuti nell'elemento denominato nella matrice appropriata. Per questo motivo è possibile aggiungere più istanze della classe all'oggetto XmlAnyElementAttribute XmlAnyElementAttributes.

Per eseguire l'override di un set di XmlAnyElementAttribute oggetti:

Creare un oggetto XmlAnyElementAttributes.
Creare il set di XmlAnyElementAttribute oggetti e aggiungere ogni oggetto all'insieme usando il Add metodo .
Creare un oggetto XmlAttributes.
Impostare la XmlAnyElements proprietà su XmlAnyElementAttributes.
Creare un oggetto XmlAttributeOverrides.
Aggiungere l'oggetto XmlAttributes all'oggetto XmlAttributeOverrides usando il Add metodo .
Creare un'istanza dell'oggetto XmlSerializer usando .XmlAttributeOverrides
Serializzare o deserializzare un oggetto contenente il set di XmlAnyElementAttribute oggetti.

Costruttori

XmlAnyElementAttributes()

Inizializza una nuova istanza della classe XmlAnyElementAttributes.

Proprietà

Capacity	Ottiene o imposta il numero di elementi che CollectionBase può contenere. (Ereditato da CollectionBase)
Count	Ottiene il numero di elementi contenuti in ICollection.
Count	Ottiene il numero di elementi contenuti nell'istanza di CollectionBase. Questa proprietà non può essere sottoposta a override. (Ereditato da CollectionBase)
InnerList	Ottiene un ArrayList contenente l'elenco degli elementi presenti nell'istanza CollectionBase. (Ereditato da CollectionBase)
Item[Int32]	Ottiene o imposta l'oggetto XmlAnyElementAttribute in corrispondenza dell'indice specificato.
List	Ottiene un IList contenente l'elenco degli elementi presenti nell'istanza CollectionBase. (Ereditato da CollectionBase)

Metodi

Add(XmlAnyElementAttribute)	Aggiunge un oggetto XmlAnyElementAttribute alla raccolta.
Clear()	Rimuove tutti gli elementi da IList.
Clear()	Consente di rimuovere tutti gli oggetti dall'istanza CollectionBase. Questo metodo non può essere sottoposto a override. (Ereditato da CollectionBase)
Contains(XmlAnyElementAttribute)	Ottiene un valore che indica se l'oggetto XmlAnyElementAttribute specificato è presente nell'insieme.
CopyTo(XmlAnyElementAttribute[], Int32)	Copia l'intero insieme in una matrice unidimensionale compatibile di oggetti XmlElementAttribute, a partire dall'indice specificato della matrice di destinazione.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetEnumerator()	Restituisce un enumeratore che consente di eseguire l'iterazione di una raccolta.
GetEnumerator()	Restituisce un enumeratore per lo scorrimento dell'istanza di CollectionBase. (Ereditato da CollectionBase)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IndexOf(XmlAnyElementAttribute)	Ottiene l'indice della classe XmlAnyElementAttribute specificata.
Insert(Int32, XmlAnyElementAttribute)	Inserisce un oggetto XmlAnyElementAttribute nella raccolta in corrispondenza dell'indice specificato.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnClear()	Esegue processi personalizzati aggiuntivi quando viene cancellato il contenuto dell'istanza di CollectionBase. (Ereditato da CollectionBase)
OnClearComplete()	Esegue procedure personalizzate aggiuntive prima di cancellare il contenuto dell'istanza di CollectionBase. (Ereditato da CollectionBase)
OnInsert(Int32, Object)	Esegue procedure personalizzate aggiuntive prima di inserire un nuovo elemento nell'istanza di CollectionBase. (Ereditato da CollectionBase)
OnInsertComplete(Int32, Object)	Esegue procedure personalizzate aggiuntive dopo aver inserito un nuovo elemento nell'istanza di CollectionBase. (Ereditato da CollectionBase)
OnRemove(Int32, Object)	Consente di eseguire procedure personalizzate aggiuntive durante l'eliminazione di un elemento dall'istanza CollectionBase. (Ereditato da CollectionBase)
OnRemoveComplete(Int32, Object)	Esegue procedure personalizzate aggiuntive dopo della rimozione di un elemento dall'istanza di CollectionBase. (Ereditato da CollectionBase)
OnSet(Int32, Object, Object)	Esegue procedure personalizzate aggiuntive prima di impostare un valore nell'istanza di CollectionBase. (Ereditato da CollectionBase)
OnSetComplete(Int32, Object, Object)	Esegue procedure personalizzate aggiuntive dopo aver impostato un valore nell'istanza di CollectionBase. (Ereditato da CollectionBase)
OnValidate(Object)	Esegue processi personalizzati aggiuntivi durante la convalida di un valore. (Ereditato da CollectionBase)
Remove(XmlAnyElementAttribute)	Rimuove l'oggetto XmlAnyElementAttribute specificato dalla raccolta.
RemoveAt(Int32)	Rimuove l'elemento IList in corrispondenza dell'indice specificato.
RemoveAt(Int32)	Consente di rimuovere la voce in corrispondenza dell'indice specificato dell'istanza CollectionBase. Questo metodo non può essere sottoposto a override. (Ereditato da CollectionBase)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Implementazioni dell'interfaccia esplicita

ICollection.CopyTo(Array, Int32)	Copia gli elementi dell'oggetto ICollection in una matrice a partire da un indice specifico.
ICollection.CopyTo(Array, Int32)	Copia l'intero oggetto CollectionBase in un oggetto Array compatibile unidimensionale, a partire dall'indice specificato della matrice di destinazione. (Ereditato da CollectionBase)
ICollection.IsSynchronized	Ottiene un valore che indica se l'accesso a ICollection è sincronizzato (thread-safe).
ICollection.IsSynchronized	Ottiene un valore che indica se l'accesso a CollectionBase è sincronizzato (thread-safe). (Ereditato da CollectionBase)
ICollection.SyncRoot	Ottiene un oggetto che può essere usato per sincronizzare l'accesso a ICollection.
ICollection.SyncRoot	Ottiene un oggetto che può essere usato per sincronizzare l'accesso a CollectionBase. (Ereditato da CollectionBase)
IList.Add(Object)	Aggiunge un elemento a IList.
IList.Add(Object)	Aggiunge un oggetto alla fine di CollectionBase. (Ereditato da CollectionBase)
IList.Contains(Object)	Stabilisce se IList contiene un valore specifico.
IList.Contains(Object)	Consente di stabilire se CollectionBase contiene un elemento specifico. (Ereditato da CollectionBase)
IList.IndexOf(Object)	Determina l'indice di un elemento specifico in IList.
IList.IndexOf(Object)	Cerca l'oggetto Object specificato e restituisce l'indice in base zero della prima occorrenza all'interno dell'intero CollectionBase. (Ereditato da CollectionBase)
IList.Insert(Int32, Object)	Inserisce un elemento in IList in corrispondenza dell'indice specificato.
IList.Insert(Int32, Object)	Inserisce un elemento in CollectionBase in corrispondenza dell'indice specificato. (Ereditato da CollectionBase)
IList.IsFixedSize	Ottiene un valore che indica se IList ha dimensioni fisse.
IList.IsFixedSize	Ottiene un valore che indica se CollectionBase ha dimensioni fisse. (Ereditato da CollectionBase)
IList.IsReadOnly	Ottiene un valore che indica se IList è di sola lettura.
IList.IsReadOnly	Ottiene un valore che indica se CollectionBase è di sola lettura. (Ereditato da CollectionBase)
IList.Item[Int32]	Ottiene o imposta l'elemento in corrispondenza dell'indice specificato.
IList.Item[Int32]	Ottiene o imposta l'elemento in corrispondenza dell'indice specificato. (Ereditato da CollectionBase)
IList.Remove(Object)	Rimuove la prima occorrenza di un oggetto specifico da IList.
IList.Remove(Object)	Rimuove la prima occorrenza di un oggetto specifico da CollectionBase. (Ereditato da CollectionBase)

Metodi di estensione

Cast<TResult>(IEnumerable)	Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.
OfType<TResult>(IEnumerable)	Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.
AsParallel(IEnumerable)	Consente la parallelizzazione di una query.
AsQueryable(IEnumerable)	Converte un oggetto IEnumerable in un oggetto IQueryable.

Si applica a