XmlAttributes Classe

Definizione

Rappresenta un insieme di oggetti attributo che controlla come XmlSerializer serializza e deserializza un oggetto.

public class XmlAttributes
Ereditarietà
XmlAttributes

Esempio

L'esempio seguente serializza un'istanza di una classe denominata Orchestra, che contiene un singolo campo denominato Instruments che restituisce una matrice di Instrument oggetti . Una seconda classe denominata Brass eredita dalla Instrument classe . Nell'esempio viene creato un XmlAttributes oggetto per eseguire l'override del Instrument campo, consentendo al campo di accettare Brass oggetti e aggiunge l'oggetto a un'istanza XmlAttributes della XmlAttributeOverrides classe .

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 element to the collection of elements.
      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);
      }
   }
}

Commenti

La creazione di fa parte di un processo che esegue l'override XmlAttributes del modo predefinito in cui serializza XmlSerializer le istanze della classe. Si supponga, ad esempio, di voler serializzare un oggetto creato da una DLL con un'origine inaccessibile. Usando XmlAttributeOverrides, è possibile aumentare o controllare in altro modo la modalità di serializzazione dell'oggetto.

I membri della XmlAttributes classe corrispondono direttamente a una famiglia di classi di attributi che controllano la serializzazione. Ad esempio, la XmlText proprietà deve essere impostata su un XmlTextAttributeoggetto , che consente di eseguire l'override della serializzazione di un campo o di una proprietà indicando XmlSerializer a per serializzare il valore della proprietà come testo XML. Per un elenco completo degli attributi che controllano la serializzazione, vedere .XmlSerializer

Per altre informazioni sull'uso di con la XmlAttributeOverridesXmlAttributes classe , vedere Procedura: Specificare un nome di elemento alternativo per un flusso XML.

Costruttori

XmlAttributes()

Inizializza una nuova istanza della classe XmlAttributes.

XmlAttributes(ICustomAttributeProvider)

Inizializza una nuova istanza della classe XmlAttributes e personalizza il modo in cui XmlSerializer serializza e deserializza un oggetto.

Proprietà

XmlAnyAttribute

Ottiene o imposta l'elemento XmlAnyAttributeAttribute di cui eseguire l'override.

XmlAnyElements

Ottiene l'insieme di oggetti XmlAnyElementAttribute di cui eseguire l'override.

XmlArray

Recupera o imposta un oggetto che specifica come XmlSerializer serializza un campo pubblico o una proprietà in lettura/scrittura che restituisce una matrice.

XmlArrayItems

Recupera o imposta un insieme di oggetti che specifica come XmlSerializer serializza gli elementi inseriti in una matrice restituita da un campo pubblico o una proprietà di lettura/scrittura.

XmlAttribute

Ottiene o imposta un oggetto che specifica come XmlSerializer serializza un campo pubblico o una proprietà pubblica in lettura/scrittura come attributo XML.

XmlChoiceIdentifier

Ottiene o imposta un oggetto che consente di distinguere tra un gruppo di scelte.

XmlDefaultValue

Ottiene o imposta il valore predefinito di un attributo o elemento XML.

XmlElements

Ottiene un insieme di oggetti che specificano il modo in cui XmlSerializer serializza un campo public o una proprietà di lettura/scrittura come elemento XML.

XmlEnum

Ottiene o imposta un oggetto che specifica come XmlSerializer serializza un membro di enumerazione.

XmlIgnore

Ottiene o imposta un valore che specifica se XmlSerializer serializza o meno un campo pubblico o una proprietà in lettura/scrittura pubblica.

Xmlns

Ottiene o imposta un valore che specifica se mantenere tutte le dichiarazioni degli spazi dei nomi quando un oggetto contenente un membro che restituisce un oggetto XmlSerializerNamespaces viene sottoposto a override.

XmlRoot

Ottiene o imposta un oggetto che specifica come XmlSerializer serializza una classe come elemento XML di primo livello.

XmlText

Ottiene o imposta un oggetto che fa in modo che XmlSerializer serializzi un campo pubblico o una proprietà pubblica in lettura/scrittura come testo XML.

XmlType

Ottiene o imposta un oggetto che specifica come XmlSerializer serializza una classe alla quale è stato applicato XmlTypeAttribute.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Si applica a

Prodotto Versioni
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0

Vedi anche