SoapAttributeAttribute.DataType Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define o tipo de dado XML Schema definition language (XSD) do atributo SOAP gerado pelo XmlSerializer.
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
Valor de Propriedade
Um tipo de dado XML Schema.
Exceções
O tipo de dado XML Schema que especificou não pode ser mapeado para o tipo de dado .NET.
Exemplos
O exemplo seguinte serializa uma classe que contém vários campos aos quais a SoapAttributeAttribute é aplicado. A DataType propriedade está definida para os GroupNumber campos e Today .
using System;
using System.IO;
using System.Text;
using System.Xml;
using System.Xml.Serialization;
using System.Xml.Schema;
[SoapInclude(typeof(Vehicle))]
public class Group
{
[SoapAttribute (Namespace = "http://www.cpandl.com")]
public string GroupName;
[SoapAttribute(DataType = "base64Binary")]
public Byte [] GroupNumber;
[SoapAttribute(DataType = "date", AttributeName = "CreationDate")]
public DateTime Today;
[SoapElement(DataType = "nonNegativeInteger", ElementName = "PosInt")]
public string PostitiveInt;
public Vehicle GroupVehicle;
}
public class Vehicle
{
public string licenseNumber;
}
public class Run
{
public static void Main()
{
Run test = new Run();
test.SerializeObject("SoapAtts.xml");
test.DeserializeObject("SoapAtts.xml");
}
public void SerializeObject(string filename)
{
// Create an instance of the XmlSerializer class that
// can generate encoded SOAP messages.
XmlSerializer mySerializer = ReturnSOAPSerializer();
Group myGroup=MakeGroup();
// Writing the file requires a TextWriter.
XmlTextWriter writer =
new XmlTextWriter(filename, Encoding.UTF8);
writer.Formatting = Formatting.Indented;
writer.WriteStartElement("wrapper");
// Serialize the class, and close the TextWriter.
mySerializer.Serialize(writer, myGroup);
writer.WriteEndElement();
writer.Close();
}
private Group MakeGroup(){
// Create an instance of the class that will be serialized.
Group myGroup = new Group();
// Set the object properties.
myGroup.GroupName = ".NET";
Byte [] hexByte = new Byte[2]{Convert.ToByte(100),
Convert.ToByte(50)};
myGroup.GroupNumber = hexByte;
DateTime myDate = new DateTime(2002,5,2);
myGroup.Today = myDate;
myGroup.PostitiveInt= "10000";
myGroup.GroupVehicle = new Vehicle();
myGroup.GroupVehicle.licenseNumber="1234";
return myGroup;
}
public void DeserializeObject(string filename)
{
// Create an instance of the XmlSerializer class that
// can generate encoded SOAP messages.
XmlSerializer mySerializer = ReturnSOAPSerializer();
// Reading the file requires an XmlTextReader.
XmlTextReader reader=
new XmlTextReader(filename);
reader.ReadStartElement("wrapper");
// Deserialize and cast the object.
Group myGroup;
myGroup = (Group) mySerializer.Deserialize(reader);
reader.ReadEndElement();
reader.Close();
}
private XmlSerializer ReturnSOAPSerializer(){
// Create an instance of the XmlSerializer class.
XmlTypeMapping myMapping =
(new SoapReflectionImporter().ImportTypeMapping
(typeof(Group)));
return new XmlSerializer(myMapping);
}
}
Imports System.IO
Imports System.Text
Imports System.Xml
Imports System.Xml.Serialization
Imports System.Xml.Schema
<SoapInclude(GetType(Vehicle))> _
Public Class Group
<SoapAttribute (Namespace:= "http:'www.cpandl.com")> _
Public GroupName As String
<SoapAttribute(DataType:= "base64Binary")> _
Public GroupNumber() As Byte
<SoapAttribute(DataType:= "date", AttributeName:= "CreationDate")> _
Public Today As DateTime
<SoapElement(DataType:= "nonNegativeInteger", _
ElementName:= "PosInt")> _
Public PostitiveInt As String
Public GroupVehicle As Vehicle
End Class
Public Class Vehicle
Public licenseNumber As String
End Class
Public Class Run
Shared Sub Main()
Dim test As Run = New Run()
test.SerializeObject("SoapAtts.xml")
test.DeserializeObject("SoapAtts.xml")
End Sub
Public Sub SerializeObject(filename As String)
' Create an instance of the XmlSerializer Class that
' can generate encoded SOAP messages.
Dim mySerializer As XmlSerializer = ReturnSOAPSerializer()
Dim myGroup As Group = MakeGroup()
' Writing the file requires a TextWriter.
Dim writer As XmlTextWriter = _
New XmlTextWriter(filename, Encoding.UTF8)
writer.Formatting = Formatting.Indented
writer.WriteStartElement("wrapper")
' Serialize the Class, and close the TextWriter.
mySerializer.Serialize(writer, myGroup)
writer.WriteEndElement()
writer.Close()
End Sub
Private Function MakeGroup() As Group
' Create an instance of the Class that will be serialized.
Dim myGroup As Group = New Group()
' Set the object properties.
myGroup.GroupName = ".NET"
Dim hexByte() As Byte= New Byte(1){Convert.ToByte(100), _
Convert.ToByte(50)}
myGroup.GroupNumber = hexByte
Dim myDate As DateTime = New DateTime(2002,5,2)
myGroup.Today = myDate
myGroup.PostitiveInt= "10000"
myGroup.GroupVehicle = New Vehicle()
myGroup.GroupVehicle.licenseNumber="1234"
return myGroup
End Function
Public Sub DeserializeObject(filename As String)
' Create an instance of the XmlSerializer Class that
' can generate encoded SOAP messages.
Dim mySerializer As XmlSerializer = ReturnSOAPSerializer()
' Reading the file requires an XmlTextReader.
Dim reader As XmlTextReader = _
New XmlTextReader(filename)
reader.ReadStartElement("wrapper")
' Deserialize and cast the object.
Dim myGroup As Group
myGroup = _
CType(mySerializer.Deserialize(reader), Group)
reader.ReadEndElement()
reader.Close()
End Sub
private Function ReturnSOAPSerializer() As XmlSerializer
' Create an instance of the XmlSerializer Class.
Dim myMapping As XmlTypeMapping = _
(New SoapReflectionImporter().ImportTypeMapping _
(GetType(Group)))
return New XmlSerializer(myMapping)
End Function
End Class
Observações
A tabela seguinte lista os tipos de dados simples do XML Schema com os seus equivalentes .NET.
Para o XML Schema base64Binary e hexBinary tipos de dados, use um array de Byte estruturas e aplique SoapAttributeAttribute a com o DataType conjunto para "base64Binary" ou "hexBinary", conforme apropriado. Para o XML Schema time e date tipos de dados, use o DateTime tipo e aplique o SoapAttributeAttribute com DataType o conjunto como "data" ou "hora".
Para cada tipo de dado XML Schema que seja mapeado para uma cadeia, aplique o SoapAttributeAttribute com a sua DataType propriedade definida ao tipo de dado XML Schema. Note que isto não altera o formato de serialização, apenas o esquema do membro.
Note
A propriedade é sensível a maiúsculas e minúsculas, por isso deve defini-la exatamente para um dos tipos de dados XML Schema.
Note
Passar dados binários como um elemento XML é mais eficiente do que passá-los como um atributo XML.
Para mais informações sobre os tipos de dados XML Schema, consulte o documento do World Wide Consortium chamado XML Schema Parte 2: Datatypes](https://www.w3.org/TR/xmlschema-2/).
| Tipo de dados XSD | Tipo de dados .NET |
|---|---|
| anyURI | String |
| base64Binary | Array de Byte objetos |
| booleano | Boolean |
| byte | SByte |
| date | DateTime |
| data e hora | DateTime |
| decimal | Decimal |
| duplo | Double |
| ENTIDADE | String |
| ENTIDADES | String |
| float | Single |
| gDay | String |
| gMonth | String |
| gMonthDay | String |
| gYear | String |
| gAnoMes | String |
| hexBinary | Array de Byte objetos |
| ID | String |
| IDREF | String |
| IDREFS | String |
| int | Int32 |
| número inteiro | String |
| linguagem | String |
| longo | Int64 |
| Name | String |
| NCName | String |
| negativoInteger | String |
| NMTOKEN | String |
| NMTOKENS | String |
| normalizedString | String |
| nãoNegativoInteiro | String |
| nãoPositivoInteger | String |
| NOÇÃO | String |
| Inteiro positivo | String |
| QName | XmlQualifiedName |
| duration | String |
| cadeia (de caracteres) | String |
| short | Int16 |
| time | DateTime |
| token | String |
| byte não assinado | Byte |
| inteiroSemSinal | UInt32 |
| não assinadoLong | UInt64 |
| unsignedShort | UInt16 |