XmlAttributeAttribute.DataType プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

XmlAttributeAttribute.DataType プロパティ

XmlSerializer によって生成された XML 属性の XSD データ型を取得または設定します。

名前空間: System.Xml.Serialization
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Property DataType As
 String

Visual Basic (使用法)

Dim instance As XmlAttributeAttribute
Dim value As String

value = instance.DataType

instance.DataType = value

public string DataType { get;
 set; }

C++

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

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

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

JScript

public function get DataType
 () : String

public function set DataType
 (value : String)

プロパティ値
W3C (World Wide Web Consortium) (www.w3.org) のドキュメント『XML Schema: DataTypes』で定義されている XSD (XML スキーマドキュメント) データ型。

解説

XSD の単純データ型と、それに相当する .NET データ型の表を次に示します。

XSD base64Binary データ型と XSD hexBinary データ型の場合は、Byte 構造体の配列を使用し、DataType プロパティがデータ型に応じて "base64Binary" または "hexBinary" に設定されている XmlArrayItemAttribute を適用します。XSD time データ型と XSD date データ型の場合は、DateTime 型を使用し、DataType が "date" または "time" に設定されている XmlAttributeAttribute を適用します。

文字列に割り当てられたすべての XSD 型について、DataType プロパティが XSD 型に設定されている XmlAttributeAttribute を適用します。ただし、これで変更されるのはメンバのスキーマだけであり、シリアル化形式は変更されません。

メモ
プロパティは、大文字小文字を区別します。このため、各 XSD データ型を正確に設定する必要があります。

メモ
バイナリデータは、XML 属性として渡すよりも XML 要素として渡す方が効率的です。

XML データ型の詳細については、W3C (World Wide Web Consortium) (www.w3.org) のドキュメント『XML Schema Part 2: Datatypes』を参照してください。

XSD データ型	.NET データ型
anyURI	String
base64Binary	Byte オブジェクトの配列
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	Byte オブジェクトの配列
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

使用例

XmlAttributeAttribute を 2 つのメンバに適用し、DataType プロパティセットに異なる値を設定する例を次に示します。

Visual Basic

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;
}

C++

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