Assembly: System.Xml (in system.xml.dll)
Public Class XmlAttributeOverrides
Dim instance As XmlAttributeOverrides
public class XmlAttributeOverrides
public ref class XmlAttributeOverrides
public class XmlAttributeOverrides
public class XmlAttributeOverrides
L'oggetto XmlAttributeOverrides consente a XmlSerializer di sottoporre a override la modalità predefinita di serializzazione di un insieme di oggetti. Questo tipo di override della serializzazione ha due utilizzi. In primo luogo, è possibile controllare e ottimizzare la serializzazione degli oggetti presenti in una DLL, anche se non si ha accesso all'origine. In secondo luogo, è possibile creare un insieme di classi serializzabili, serializzando tuttavia gli oggetti in più modi. Anziché serializzare i membri di un'istanza di una classe come elementi XML, ad esempio, è possibile serializzarli come attributi XML, ottenendo un documento più facilmente trasportabile.
Dopo avere creato un oggetto XmlAttributeOverrides, passarlo come argomento al costruttore XmlSerializer. I dati contenuti nella classe XmlAttributeOverrides verranno utilizzati dalla classe XmlSerializer ottenuta per sottoporre a override gli attributi che controllano la modalità di serializzazione degli oggetti. A tale scopo, XmlAttributeOverrides contiene un insieme dei tipi di oggetti sottoposti a override, nonché un oggetto XmlAttributes associato a ciascun tipo di oggetto sottoposto a override. L'oggetto XmlAttributes stesso contiene un insieme di oggetti attributo appropriato che controlla la modalità di serializzazione di ogni campo, proprietà o classe.
La procedura per creare e utilizzare un oggetto XmlAttributeOverrides è la seguente:
-
Creare un oggetto XmlAttributes.
-
Creare un oggetto attributo adatto all'oggetto da sottoporre a override. Ad esempio, per sottoporre a override un campo o una proprietà, creare un oggetto XmlElementAttribute, utilizzando il nuovo tipo derivato. Facoltativamente, è possibile assegnare una nuova proprietà ElementName o Namespace con cui viene eseguito l'override del nome o dello spazio dei nomi dell'attributo della classe base.
-
Aggiungere l'oggetto attributo all'insieme o alla proprietà dell'oggetto XmlAttributes appropriato. È ad esempio possibile aggiungere l'oggetto XmlElementAttribute all'insieme XmlElements dell'oggetto XmlAttributes, specificando il nome del membro che sarà sottoposto a override.
-
Creare un oggetto XmlAttributeOverrides.
-
Utilizzando il metodo Add, aggiungere l'oggetto XmlAttributes all'oggetto XmlAttributeOverrides. Se l'oggetto sottoposto a override è un XmlRootAttribute o XmlTypeAttribute, è sufficiente specificare il tipo dell'oggetto sottoposto a override. Se invece l'override riguarda un campo o una proprietà, è necessario specificare anche il nome del membro sottoposto a override.
-
Quando si crea l'oggetto XmlSerializer, passare l'oggetto XmlAttributeOverrides al costruttore XmlSerializer.
-
Utilizzare l'oggetto XmlSerializer risultante per serializzare o deserializzare gli oggetti della classe derivata.
Nell'esempio che segue viene serializzata una classe denominata Orchestra, che contiene un unico campo, denominato Instruments, che restituisce una matrice di oggetti Instrument. Una seconda classe denominata Brass eredita dalla classe Instrument. Nell'esempio viene utilizzata un'istanza della classe XmlAttributeOverrides per sottoporre a override il campo Instrument, consentendo al campo di accettare oggetti Brass.
Option Explicit Option Strict Imports System Imports System.IO Imports System.Xml.Serialization Imports Microsoft.VisualBasic Public Class Orchestra Public Instruments() As Instrument End Class Public Class Instrument Public Name As String End Class Public Class Brass Inherits Instrument Public IsValved As Boolean End Class Public Class Run Public Shared Sub Main() Dim test As New Run() test.SerializeObject("Override.xml") test.DeserializeObject("Override.xml") End Sub Public Sub SerializeObject(ByVal filename As String) ' Each overridden field, property, or type requires ' an XmlAttributes object. Dim attrs As New XmlAttributes() ' Create an XmlElementAttribute to override the ' field that returns Instrument objects. The overridden field ' returns Brass objects instead. Dim attr As New XmlElementAttribute() attr.ElementName = "Brass" attr.Type = GetType(Brass) ' Add the element to the collection of elements. attrs.XmlElements.Add(attr) ' Create the XmlAttributeOverrides object. Dim attrOverrides As New XmlAttributeOverrides() ' Add the type of the class that contains the overridden ' member and the XmlAttributes to override it with to the ' XmlAttributeOverrides object. attrOverrides.Add(GetType(Orchestra), "Instruments", attrs) ' Create the XmlSerializer using the XmlAttributeOverrides. Dim s As New XmlSerializer(GetType(Orchestra), attrOverrides) ' Writing the file requires a TextWriter. Dim writer As New StreamWriter(filename) ' Create the object that will be serialized. Dim band As New Orchestra() ' Create an object of the derived type. Dim i As New Brass() i.Name = "Trumpet" i.IsValved = True Dim myInstruments() As Instrument = {i} band.Instruments = myInstruments ' Serialize the object. s.Serialize(writer, band) writer.Close() End Sub Public Sub DeserializeObject(filename As String) Dim attrOverrides As New XmlAttributeOverrides() Dim attrs As New XmlAttributes() ' Create an XmlElementAttribute to override the Instrument. Dim attr As New XmlElementAttribute() attr.ElementName = "Brass" attr.Type = GetType(Brass) ' Add the XmlElementAttribute to the collection of objects. attrs.XmlElements.Add(attr) attrOverrides.Add(GetType(Orchestra), "Instruments", attrs) ' Create the XmlSerializer using the XmlAttributeOverrides. Dim s As New XmlSerializer(GetType(Orchestra), attrOverrides) Dim fs As New FileStream(filename, FileMode.Open) Dim band As Orchestra = CType(s.Deserialize(fs), Orchestra) Console.WriteLine("Brass:") ' The difference between deserializing the overridden ' XML document and serializing it is this: To read the derived ' object values, you must declare an object of the derived type ' (Brass), and cast the Instrument instance to it. Dim b As Brass Dim i As Instrument For Each i In band.Instruments b = CType(i, Brass) Console.WriteLine(b.Name & ControlChars.Cr & b.IsValved) Next i End Sub End Class
using System; using System.IO; using System.Xml.Serialization; public class Orchestra { public Instrument[] Instruments; } public class Instrument { public string Name; } public class Brass:Instrument { public bool IsValved; } public class Run { public static void Main() { Run test = new Run(); test.SerializeObject("Override.xml"); test.DeserializeObject("Override.xml"); } public void SerializeObject(string filename) { /* Each overridden field, property, or type requires an XmlAttributes object. */ XmlAttributes attrs = new XmlAttributes(); /* Create an XmlElementAttribute to override the field that returns Instrument objects. The overridden field returns Brass objects instead. */ XmlElementAttribute attr = new XmlElementAttribute(); attr.ElementName = "Brass"; attr.Type = typeof(Brass); // Add the element to the collection of elements. attrs.XmlElements.Add(attr); // Create the XmlAttributeOverrides object. XmlAttributeOverrides attrOverrides = new XmlAttributeOverrides(); /* Add the type of the class that contains the overridden member and the XmlAttributes to override it with to the XmlAttributeOverrides object. */ attrOverrides.Add(typeof(Orchestra), "Instruments", attrs); // Create the XmlSerializer using the XmlAttributeOverrides. XmlSerializer s = new XmlSerializer(typeof(Orchestra), attrOverrides); // Writing the file requires a TextWriter. TextWriter writer = new StreamWriter(filename); // Create the object that will be serialized. Orchestra band = new Orchestra(); // Create an object of the derived type. Brass i = new Brass(); i.Name = "Trumpet"; i.IsValved = true; Instrument[] myInstruments = {i}; band.Instruments = myInstruments; // Serialize the object. s.Serialize(writer,band); writer.Close(); } public void DeserializeObject(string filename) { XmlAttributeOverrides attrOverrides = new XmlAttributeOverrides(); XmlAttributes attrs = new XmlAttributes(); // Create an XmlElementAttribute to override the Instrument. XmlElementAttribute attr = new XmlElementAttribute(); attr.ElementName = "Brass"; attr.Type = typeof(Brass); // Add the XmlElementAttribute to the collection of objects. attrs.XmlElements.Add(attr); attrOverrides.Add(typeof(Orchestra), "Instruments", attrs); // Create the XmlSerializer using the XmlAttributeOverrides. XmlSerializer s = new XmlSerializer(typeof(Orchestra), attrOverrides); FileStream fs = new FileStream(filename, FileMode.Open); Orchestra band = (Orchestra) s.Deserialize(fs); Console.WriteLine("Brass:"); /* The difference between deserializing the overridden XML document and serializing it is this: To read the derived object values, you must declare an object of the derived type (Brass), and cast the Instrument instance to it. */ Brass b; foreach(Instrument i in band.Instruments) { b = (Brass)i; Console.WriteLine( b.Name + "\n" + b.IsValved); } } }
#using <System.Xml.dll> #using <System.dll> using namespace System; using namespace System::IO; using namespace System::Xml::Serialization; public ref class Instrument { public: String^ Name; }; public ref class Brass: public Instrument { public: bool IsValved; }; public ref class Orchestra { public: array<Instrument^>^Instruments; }; void SerializeObject( String^ filename ) { /* Each overridden field, property, or type requires an XmlAttributes object. */ XmlAttributes^ attrs = gcnew XmlAttributes; /* Create an XmlElementAttribute to override the field that returns Instrument objects. The overridden field returns Brass objects instead. */ XmlElementAttribute^ attr = gcnew XmlElementAttribute; attr->ElementName = "Brass"; attr->Type = Brass::typeid; // Add the element to the collection of elements. attrs->XmlElements->Add( attr ); // Create the XmlAttributeOverrides object. XmlAttributeOverrides^ attrOverrides = gcnew XmlAttributeOverrides; /* Add the type of the class that contains the overridden member and the XmlAttributes to override it with to the XmlAttributeOverrides object. */ attrOverrides->Add( Orchestra::typeid, "Instruments", attrs ); // Create the XmlSerializer using the XmlAttributeOverrides. XmlSerializer^ s = gcnew XmlSerializer( Orchestra::typeid,attrOverrides ); // Writing the file requires a TextWriter. TextWriter^ writer = gcnew StreamWriter( filename ); // Create the object that will be serialized. Orchestra^ band = gcnew Orchestra; // Create an object of the derived type. Brass^ i = gcnew Brass; i->Name = "Trumpet"; i->IsValved = true; array<Instrument^>^myInstruments = {i}; band->Instruments = myInstruments; // Serialize the object. s->Serialize( writer, band ); writer->Close(); } void DeserializeObject( String^ filename ) { XmlAttributeOverrides^ attrOverrides = gcnew XmlAttributeOverrides; XmlAttributes^ attrs = gcnew XmlAttributes; // Create an XmlElementAttribute to override the Instrument. XmlElementAttribute^ attr = gcnew XmlElementAttribute; attr->ElementName = "Brass"; attr->Type = Brass::typeid; // Add the XmlElementAttribute to the collection of objects. attrs->XmlElements->Add( attr ); attrOverrides->Add( Orchestra::typeid, "Instruments", attrs ); // Create the XmlSerializer using the XmlAttributeOverrides. XmlSerializer^ s = gcnew XmlSerializer( Orchestra::typeid,attrOverrides ); FileStream^ fs = gcnew FileStream( filename,FileMode::Open ); Orchestra^ band = dynamic_cast<Orchestra^>(s->Deserialize( fs )); Console::WriteLine( "Brass:" ); /* The difference between deserializing the overridden XML document and serializing it is this: To read the derived object values, you must declare an object of the derived type (Brass), and cast the Instrument instance to it. */ Brass^ b; System::Collections::IEnumerator^ myEnum = band->Instruments->GetEnumerator(); while ( myEnum->MoveNext() ) { Instrument^ i = safe_cast<Instrument^>(myEnum->Current); b = dynamic_cast<Brass^>(i); Console::WriteLine( "{0}\n{1}", b->Name, b->IsValved ); } } int main() { SerializeObject( "Override.xml" ); DeserializeObject( "Override.xml" ); }
import System.*;
import System.IO.*;
import System.Xml.Serialization.*;
public class Orchestra
{
public Instrument instruments[];
} //Orchestra
public class Instrument
{
public String name;
} //Instrument
public class Brass extends Instrument
{
public boolean isValved;
} //Brass
public class Run
{
public static void main(String[] args)
{
Run test = new Run();
test.SerializeObject("Override.xml");
test.DeserializeObject("Override.xml");
} //main
public void SerializeObject(String fileName)
{
/* Each overridden field, property, or type requires
an XmlAttributes object.
*/
XmlAttributes attrs = new XmlAttributes();
/* Create an XmlElementAttribute to override the
field that returns Instrument objects. The overridden field
returns Brass objects instead.
*/
XmlElementAttribute attr = new XmlElementAttribute();
attr.set_ElementName("Brass");
attr.set_Type(Brass.class.ToType());
// Add the element to the collection of elements.
attrs.get_XmlElements().Add(attr);
// Create the XmlAttributeOverrides object.
XmlAttributeOverrides attrOverrides = new XmlAttributeOverrides();
/* Add the type of the class that contains the overridden
member and the XmlAttributes to override it with to the
XmlAttributeOverrides object.
*/
attrOverrides.Add(Orchestra.class.ToType(), "instruments", attrs);
// Create the XmlSerializer using the XmlAttributeOverrides.
XmlSerializer s =
new XmlSerializer(Orchestra.class.ToType(), attrOverrides);
// Writing the file requires a TextWriter.
TextWriter writer = new StreamWriter(fileName);
// Create the object that will be serialized.
Orchestra band = new Orchestra();
// Create an object of the derived type.
Brass i = new Brass();
i.name = "Trumpet";
i.isValved = true;
Instrument myInstruments[] ={ i };
band.instruments = myInstruments;
// Serialize the object.
s.Serialize(writer, band);
writer.Close();
} //SerializeObject
public void DeserializeObject(String fileName)
{
XmlAttributeOverrides attrOverrides = new XmlAttributeOverrides();
XmlAttributes attrs = new XmlAttributes();
// Create an XmlElementAttribute to override the Instrument.
XmlElementAttribute attr = new XmlElementAttribute();
attr.set_ElementName("Brass");
attr.set_Type(Brass.class.ToType());
// Add the XmlElementAttribute to the collection of objects.
attrs.get_XmlElements().Add(attr);
attrOverrides.Add(Orchestra.class.ToType(), "instruments", attrs);
// Create the XmlSerializer using the XmlAttributeOverrides.
XmlSerializer s =
new XmlSerializer(Orchestra.class.ToType(), attrOverrides);
FileStream fs = new FileStream(fileName, FileMode.Open);
Orchestra band = (Orchestra)s.Deserialize(fs);
Console.WriteLine("Brass:");
/* The difference between deserializing the overridden
XML document and serializing it is this: To read the derived
object values, you must declare an object of the derived type
(Brass), and cast the Instrument instance to it.
*/
Brass b;
for (int iCtr = 0; iCtr < band.instruments.length; iCtr++) {
Instrument i = (Instrument)band.instruments.get_Item(iCtr);
b = (Brass)i;
Console.WriteLine(b.name + "\n"
+ System.Convert.ToString(b.isValved));
}
} //DeserializeObject
} //Run
System.Xml.Serialization.XmlAttributeOverrides
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile per Pocket PC, Windows Mobile per Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.
.NET Framework
Supportato in: 2.0 1.1 1.0.NET Compact Framework
Supportato in: 2.0Riferimenti
Membri XmlAttributeOverridesSpazio dei nomi System.Xml.Serialization
Deserialize
Serialize
XmlSerializer
XmlAttributes
Altre risorse
Introduzione alla serializzazione XMLProcedura: specificare un nome di elemento alternativo per un flusso XML
Controllo della serializzazione XML mediante attributi
Esempi di serializzazione XML
Strumento di definizione di schemi XML (Xsd.exe)