SoapElementAttribute.DataType Vlastnost

Definice

Obor názvů:

System.Xml.Serialization

Sestavení:

netstandard.dll, System.Xml.XmlSerializer.dll

Zdroj:

SoapElementAttribute.cs

Získá nebo nastaví datový typ jazyka XSD (XML Schema Definition Language) vygenerovaného elementu XML.

public:
 property System::String ^ DataType { System::String ^ get(); void set(System::String ^ value); };

public string DataType { get; set; }

member this.DataType : string with get, set

Public Property DataType As String

Hodnota vlastnosti

String

Jeden z datových typů schématu XML.

Příklady

Následující příklad serializuje instanci třídy s názvem Transportation , která obsahuje pole s názvem Vehicle. U pole se použije A SoapElementAttribute . Pokud je pole serializováno, název elementu XML je "Wheel" místo "Vehicle". Metoda SerializeOverride vytvoří SoapElementAttribute a nastaví SoapElement vlastnost SoapAttributes na SoapElementAttributehodnotu . Přidá SoapAttributes se do objektu SoapAttributeOverrides , který slouží k vytvoření objektu XmlTypeMapping. Je XmlSerializer vytvořen s , XmlTypeMappinga instance Transportation třídy je znovu serializována. SoapElementAttribute Vzhledem k tomu, že se používá k přepsání serializace, vygenerovaný název xml elementu je nyní "Truck" místo "Wheel".

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

Poznámky

Následující tabulka uvádí jednoduché datové typy schématu XML s jejich ekvivalenty .NET.

V případě schématu base64Binary XML a hexBinary datových Byte typů použijte pole struktur a podle potřeby použijte SoapElementAttribute pole se DataType sadou "base64Binary" nebo "hexBinary". Pro schéma time XML a date datové typy použijte DateTime typ a použijte SoapElementAttribute s DataType nastaveným datem nebo časem.

Pro každý datový typ schématu XML, který je namapován na řetězec, použijte SoapElementAttribute s jeho DataType vlastností nastavenou na typ schématu XML. Všimněte si, že se tím nezmění formát serializace, pouze schéma člena.

Poznámka:

Vlastnost rozlišují malá a velká písmena, takže ji musíte nastavit přesně na jeden z datových typů schématu XML.

Poznámka:

Předávání binárních dat jako elementu XML je efektivnější než jeho předání jako atribut XML.

Další informace o datových typech XML naleznete v dokumentu world wide web consortium, XML Schema Part 2: Datatypes.

Datový typ XSD	Datový typ .NET
Anyuri	String
Base64binary	Byte Pole objektů
Boolean	Boolean
byte	SByte
date	DateTime
datum a čas	DateTime
desítkové číslo	Decimal
dvojitý	Double
ENTITY	String
ENTITY	String
float	Single
gDay	String
gMonth	String
gMonthDay	String
gYear	String
gYearMonth	String
Hexbinary	Byte Pole objektů
ID	String
IDREF	String
IDREFS	String
int	Int32
integer	String
jazyk	String
long	Int64
název	String
Ncname	String
negativeInteger	String
NMTOKEN	String
NMTOKENS	String
normalizedString	String
nonNegativeInteger	String
nonPositiveInteger	String
ZÁPIS	String
positiveInteger	String
QName	XmlQualifiedName
duration	String
řetězec	String
short	Int16
time	DateTime
token	String
bezznaménkový bajt	Byte
neznačené celé číslo	UInt32
unsignedLong	UInt64
unsignedShort (nepodepsaný krátký)	UInt16