XmlAttributeAttribute.DataType-Eigenschaft

Artikel
08/20/2007

Ruft den XSD-Datentyp des vom XmlSerializer generierten XML-Attributs ab oder legt diesen fest.

Namespace: System.Xml.Serialization
Assembly: System.Xml (in system.xml.dll)

Syntax

'Declaration
Public Property DataType As String
'Usage
Dim instance As XmlAttributeAttribute
Dim value As String

value = instance.DataType

instance.DataType = value

public string DataType { get; set; }

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

/** @property */
public String get_DataType ()

/** @property */
public void set_DataType (String value)

public function get DataType () : String

public function set DataType (value : String)

Eigenschaftenwert

Ein XSD-Datentyp (XML-Schemadokument) laut Definition im Dokument "XML Schema: DataTypes" des World Wide Web Consortium (www.w3.org ).

Hinweise

In der folgenden Tabelle sind die einfachen XSD-Datentypen und ihre Entsprechungen in .NET aufgelistet.

Verwenden Sie beim XSD-Datentyp base64Binary und hexBinary ein Array von Byte-Strukturen, und weisen Sie ein XmlArrayItemAttribute zu, wobei die DataType-Eigenschaft auf "base64Binary" bzw. "hexBinary" festgelegt wird. Verwenden Sie beim XSD-Datentyp time und date den DateTime-Typ, und weisen Sie das XmlAttributeAttribute zu, wobei DataType auf "date" oder "time" festgelegt ist.

Weisen Sie bei jedem einer Zeichenfolge zugeordneten XSD-Typ das XmlAttributeAttribute zu, wobei die DataType-Eigenschaft auf den XSD-Typ festgelegt ist. Allerdings wird dadurch nicht das Serialisierungsformat geändert, sondern nur das Schema für den Member.

Hinweis

Bei der Eigenschaft wird die Groß- und Kleinschreibung berücksichtigt, sodass diese genau auf einen der XSD-Datentypen festgelegt werden muss.

Hinweis

Das Übergeben von binären Daten als XML-Element ist effizienter als die Übergabe als XML-Attribut.

Weitere Informationen über XML-Datentypen finden Sie im Dokument "XML Schema Part 2: Datatypes" des World Wide Web Consortium (www.w3.org).

XSD-Datentyp	.NET-Datentyp
anyURI	String
base64Binary	Array von Byte-Objekten
boolean	Boolean
byte	SByte
date	DateTime
dateTime	DateTime
decimal	Decimal
double	Double
ENTITY	String
ENTITIES	String
float	Single
gDay	String
gMonth	String
gMonthDay	String
gYear	String
gYearMonth	String
hexBinary	Array von Byte-Objekten
ID	String
IDREF	String
IDREFS	String
int	Int32
integer	String
language	String
long	Int64
Name	String
NCName	String
negativeInteger	String
NMTOKEN	String
NMTOKENS	String
normalizedString	String
nonNegativeInteger	String
nonPositiveInteger	String
NOTATION	String
positiveInteger	String
QName	XmlQualifiedName
duration	String
string	String
short	Int16
time	DateTime
token	String
unsignedByte	Byte
unsignedInt	UInt32
unsignedLong	UInt64
unsignedShort	UInt16

Beispiel

Im folgenden Beispiel wird das XmlAttributeAttribute zwei Membern zugewiesen und die DataType-Eigenschaft auf verschiedene Werte festgelegt.

public class Group
    <XmlAttribute(DataType := "string")> _
    public Name As string 

    <XmlAttribute (DataType := "base64Binary")> _
    public Hex64Code () As byte 
End Class

public class Group{
   [XmlAttribute(DataType = "string")]
   public string Name;
    
   [XmlAttribute (DataType = "base64Binary")]
   public byte[] Hex64Code;
}

public ref class Group
{
public:

   [XmlAttributeAttribute(DataType="string")]
   String^ Name;

   [XmlAttributeAttribute(DataType="base64Binary")]
   array<Byte>^Hex64Code;
};

public class Group
{
    /** @attribute XmlAttribute(DataType = "string")
     */
    public String name;
    /** @attribute XmlAttribute(DataType = "base64Binary")
     */
    public ubyte hex64Code[];
} //Group

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

XmlAttributeAttribute-Klasse
XmlAttributeAttribute-Member
System.Xml.Serialization-Namespace

Freigeben über