XmlTypeMapping Classe

Definizione

Spazio dei nomi:

System.Xml.Serialization

Assembly:

netstandard.dll, System.Xml.XmlSerializer.dll

Origine:

XmlTypeMapping.cs

In questa classe è contenuto il mapping di un tipo in un altro.

public class XmlTypeMapping : System.Xml.Serialization.XmlMapping

Ereditarietà

Object

XmlMapping

XmlTypeMapping

Esempio

L'esempio seguente serializza un'istanza di una classe denominata Transportation che contiene un campo denominato Vehicle. Un SoapElementAttribute oggetto viene applicato al campo . Quando il campo viene serializzato, il nome dell'elemento XML è "Wheels" anziché "Vehicle". Il SerializeOverride metodo crea un oggetto SoapElementAttribute e imposta la SoapElement proprietà di un SoapAttributes oggetto su SoapElementAttribute. L'oggetto SoapAttributes viene aggiunto a un SoapAttributeOverrides oggetto utilizzato per creare un oggetto XmlTypeMapping. Un XmlSerializer oggetto viene costruito con e un'istanza XmlTypeMappingdella Transportation classe viene nuovamente serializzata. Poiché viene usato per eseguire l'override SoapElementAttribute della serializzazione, il nome dell'elemento XML generato è ora "Truck" anziché "Wheels".

using System;
using System.IO;
using System.Xml.Serialization;
using System.Collections;
using System.Xml;
using System.Text;
public class Transportation
{
   // The SoapElementAttribute specifies that the
   // generated XML element name will be "Wheels"
   // instead of "Vehicle".
   [SoapElement("Wheels")]
   public string Vehicle;
   [SoapElement(DataType = "dateTime")]
   public DateTime CreationDate;
   [SoapElement(IsNullable = true)]
   public Thing thing;
}

public class Thing{
   [SoapElement(IsNullable=true)] public string ThingName;
}

public class Test
{
   public static void Main()
   {
      Test t = new Test();
      t.SerializeObject("SoapElementOriginal.xml");
      t.SerializeOverride("SoapElementOverride.xml");
      Console.WriteLine("Finished writing two XML files.");
   }

   // Return an XmlSerializer used for overriding.
   public XmlSerializer CreateSoapOverrider()
   {
      // Create the SoapAttributes and SoapAttributeOverrides objects.
      SoapAttributes soapAttrs = new SoapAttributes();

      SoapAttributeOverrides soapOverrides =
      new SoapAttributeOverrides();

      /* Create an SoapElementAttribute to override
      the Vehicles property. */
      SoapElementAttribute soapElement1 =
      new SoapElementAttribute("Truck");
      // Set the SoapElement to the object.
      soapAttrs.SoapElement= soapElement1;

      /* Add the SoapAttributes to the SoapAttributeOverrides,
      specifying the member to override. */
      soapOverrides.Add(typeof(Transportation), "Vehicle", soapAttrs);

      // Create the XmlSerializer, and return it.
      XmlTypeMapping myTypeMapping = (new SoapReflectionImporter
      (soapOverrides)).ImportTypeMapping(typeof(Transportation));
      return new XmlSerializer(myTypeMapping);
   }

   public void SerializeOverride(string filename)
   {
      // Create an XmlSerializer instance.
      XmlSerializer ser = CreateSoapOverrider();

      // Create the object and serialize it.
      Transportation myTransportation =
      new Transportation();

      myTransportation.Vehicle = "MyCar";
      myTransportation.CreationDate=DateTime.Now;
      myTransportation.thing = new Thing();

      XmlTextWriter writer =
      new XmlTextWriter(filename, Encoding.UTF8);
      writer.Formatting = Formatting.Indented;
      writer.WriteStartElement("wrapper");
      ser.Serialize(writer, myTransportation);
      writer.WriteEndElement();
      writer.Close();
   }
   public void SerializeObject(string filename){
      // Create an XmlSerializer instance.
      XmlSerializer ser = new XmlSerializer(typeof(Transportation));
      Transportation myTransportation =
      new Transportation();
      myTransportation.Vehicle = "MyCar";
      myTransportation.CreationDate = DateTime.Now;
      myTransportation.thing = new Thing();
      XmlTextWriter writer =
      new XmlTextWriter(filename, Encoding.UTF8);
      writer.Formatting = Formatting.Indented;
      writer.WriteStartElement("wrapper");
      ser.Serialize(writer, myTransportation);
      writer.WriteEndElement();
      writer.Close();
   }
}

Commenti

La XmlTypeMapping classe viene utilizzata per serializzare un oggetto come XML SOAP codificato. Il codice XML risultante è conforme alla sezione 5 del documento World Wide Web Consortium , "Simple Object Access Protocol (SOAP) 1.1". Creare un XmlTypeMapping oggetto chiamando il ImportTypeMapping metodo della SoapReflectionImporter classe . Usare per costruire un'istanza XmlTypeMapping della XmlSerializer classe . Per controllare la serializzazione, usare uno degli attributi elencati in Attributi che controllano la serializzazione SOAP codificata.

Proprietà

ElementName	Questa API supporta l'infrastruttura del prodotto e non è previsto che venga usata direttamente dal codice. Ottiene il nome dell'elemento mappato. (Ereditato da XmlMapping)
Namespace	Questa API supporta l'infrastruttura del prodotto e non è previsto che venga usata direttamente dal codice. Ottiene lo spazio dei nomi dell'elemento mappato. (Ereditato da XmlMapping)
TypeFullName	Nome completo del tipo, compresi lo spazio o gli spazi dei nomi e il tipo.
TypeName	Ottiene il nome del tipo dell'oggetto mappato.
XsdElementName	Questa API supporta l'infrastruttura del prodotto e non è previsto che venga usata direttamente dal codice. Ottiene il nome dell'elemento XSD del mapping. (Ereditato da XmlMapping)
XsdTypeName	Ottiene il nome dell'elemento XML dell'oggetto mappato.
XsdTypeNamespace	Ottiene lo spazio dei nomi XML dell'oggetto mappato.

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)
SetKey(String)	Questa API supporta l'infrastruttura del prodotto e non è previsto che venga usata direttamente dal codice. Imposta la chiave utilizzata per ricercare il mapping. (Ereditato da XmlMapping)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Si applica a

Vedi anche

• Introduzione alla serializzazione XML
• Procedura: serializzare un oggetto come flusso XML con codifica SOAP
• Attributi che controllano la serializzazione SOAP codificata
• Esempi di serializzazione XML