XmlTypeMapping Classe
Definizione
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.
In questa classe è contenuto il mapping di un tipo in un altro.
public ref class XmlTypeMapping : System::Xml::Serialization::XmlMapping
public class XmlTypeMapping : System.Xml.Serialization.XmlMapping
type XmlTypeMapping = class
inherit XmlMapping
Public Class XmlTypeMapping
Inherits XmlMapping
- Ereditarietà
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.Xml.dll>
#using <System.dll>
using namespace System;
using namespace System::IO;
using namespace System::Xml::Serialization;
using namespace System::Collections;
using namespace System::Xml;
using namespace System::Text;
public ref class Thing
{
public:
[SoapElement(IsNullable=true)]
String^ ThingName;
};
public ref class Transportation
{
public:
// The SoapElementAttribute specifies that the
// generated XML element name will be S"Wheels"
// instead of S"Vehicle".
[SoapElement("Wheels")]
String^ Vehicle;
[SoapElement(DataType="dateTime")]
DateTime CreationDate;
[SoapElement(IsNullable=true)]
Thing^ thing;
};
public ref class Test
{
public:
// Return an XmlSerializer used for overriding.
XmlSerializer^ CreateSoapOverrider()
{
// Create the SoapAttributes and SoapAttributeOverrides objects.
SoapAttributes^ soapAttrs = gcnew SoapAttributes;
SoapAttributeOverrides^ soapOverrides = gcnew SoapAttributeOverrides;
// Create an SoapElementAttribute to the Vehicles property.
SoapElementAttribute^ soapElement1 = gcnew SoapElementAttribute( "Truck" );
// Set the SoapElement to the Object*.
soapAttrs->SoapElement = soapElement1;
// Add the SoapAttributes to the SoapAttributeOverrides,specifying the member to.
soapOverrides->Add( Transportation::typeid, "Vehicle", soapAttrs );
// Create the XmlSerializer, and return it.
XmlTypeMapping^ myTypeMapping = (gcnew SoapReflectionImporter( soapOverrides ))->ImportTypeMapping( Transportation::typeid );
return gcnew XmlSerializer( myTypeMapping );
}
void SerializeOverride( String^ filename )
{
// Create an XmlSerializer instance.
XmlSerializer^ ser = CreateSoapOverrider();
// Create the Object* and serialize it.
Transportation^ myTransportation = gcnew Transportation;
myTransportation->Vehicle = "MyCar";
myTransportation->CreationDate = DateTime::Now;
myTransportation->thing = gcnew Thing;
XmlTextWriter^ writer = gcnew XmlTextWriter( filename,Encoding::UTF8 );
writer->Formatting = Formatting::Indented;
writer->WriteStartElement( "wrapper" );
ser->Serialize( writer, myTransportation );
writer->WriteEndElement();
writer->Close();
}
void SerializeObject( String^ filename )
{
// Create an XmlSerializer instance.
XmlSerializer^ ser = gcnew XmlSerializer( Transportation::typeid );
Transportation^ myTransportation = gcnew Transportation;
myTransportation->Vehicle = "MyCar";
myTransportation->CreationDate = DateTime::Now;
myTransportation->thing = gcnew Thing;
XmlTextWriter^ writer = gcnew XmlTextWriter( filename,Encoding::UTF8 );
writer->Formatting = Formatting::Indented;
writer->WriteStartElement( "wrapper" );
ser->Serialize( writer, myTransportation );
writer->WriteEndElement();
writer->Close();
}
};
int main()
{
Test^ t = gcnew Test;
t->SerializeObject( "SoapElementOriginal.xml" );
t->SerializeOverride( "SoapElementOverride.xml" );
Console::WriteLine( "Finished writing two XML files." );
}
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();
}
}
Imports System.IO
Imports System.Xml.Serialization
Imports System.Collections
Imports System.Xml
Imports System.Text
Public Class Transportation
' The SoapElementAttribute specifies that the
' generated XML element name will be "Wheels"
' instead of "Vehicle".
<SoapElement("Wheels")> Public Vehicle As String
<SoapElement(DataType:= "dateTime")> _
public CreationDate As DateTime
<SoapElement(IsNullable:= true)> _
public thing As Thing
End Class
Public Class Thing
<SoapElement(IsNullable:=true)> public ThingName As string
End Class
Public Class Test
Shared Sub Main()
Dim t As Test = New Test()
t.SerializeObject("SoapElementOriginalVb.xml")
t.SerializeOverride("SoapElementOverrideVb.xml")
Console.WriteLine("Finished writing two XML files.")
End Sub
' Return an XmlSerializer used for overriding.
Public Function CreateSoapOverrider() As XmlSerializer
' Create the SoapAttributes and SoapAttributeOverrides objects.
Dim soapAttrs As SoapAttributes = New SoapAttributes()
Dim soapOverrides As SoapAttributeOverrides = _
New SoapAttributeOverrides()
' Create a SoapElementAttribute to override
' the Vehicles property.
Dim soapElement1 As SoapElementAttribute = _
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(GetType(Transportation), "Vehicle", soapAttrs)
' Create the XmlSerializer, and return it.
Dim myTypeMapping As XmlTypeMapping = (New _
SoapReflectionImporter (soapOverrides)).ImportTypeMapping _
(GetType(Transportation))
return New XmlSerializer(myTypeMapping)
End Function
Public Sub SerializeOverride(filename As String)
' Create an XmlSerializer instance.
Dim ser As XmlSerializer = CreateSoapOverrider()
' Create the object and serialize it.
Dim myTransportation As Transportation = _
New Transportation()
myTransportation.Vehicle = "MyCar"
myTransportation.CreationDate = DateTime.Now
myTransportation.thing= new Thing()
Dim writer As XmlTextWriter = _
New XmlTextWriter(filename, Encoding.UTF8)
writer.Formatting = Formatting.Indented
writer.WriteStartElement("wrapper")
ser.Serialize(writer, myTransportation)
writer.WriteEndElement()
writer.Close()
End Sub
Public Sub SerializeObject(filename As String)
' Create an XmlSerializer instance.
Dim ser As XmlSerializer = _
New XmlSerializer(GetType(Transportation))
Dim myTransportation As Transportation = _
New Transportation()
myTransportation.Vehicle = "MyCar"
myTransportation.CreationDate=DateTime.Now
myTransportation.thing= new Thing()
Dim writer As XmlTextWriter = _
new XmlTextWriter(filename, Encoding.UTF8)
writer.Formatting = Formatting.Indented
writer.WriteStartElement("wrapper")
ser.Serialize(writer, myTransportation)
writer.WriteEndElement()
writer.Close()
End Sub
End Class
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. |
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 |
Ottiene lo spazio dei nomi XML dell'oggetto mappato. |
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) |