XmlEnumAttribute.Name プロパティ

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

XmlEnumAttribute.Name プロパティ

XmlSerializer が列挙体をシリアル化する場合は XML ドキュメント インスタンスに生成された値を、列挙体メンバを逆シリアル化する場合は認識した値を、取得または設定します。

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

Visual Basic (宣言)

Public Property Name As
 String

Visual Basic (使用法)

Dim instance As XmlEnumAttribute
Dim value As String

value = instance.Name

instance.Name = value

C#

public string Name { get;
 set; }

C++

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

J#

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

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

JScript

public function get Name
 () : String

public function set Name
 (value : String)

プロパティ値
XmlSerializer が列挙体をシリアル化する場合は XML ドキュメント インスタンスに生成された値、列挙体メンバを逆シリアル化する場合は認識した値。

解説

生成された XML データの名前を列挙体の識別子と異なる名前にする場合は、Name を指定します。

メモ
コードでは、XmlEnumAttribute の代わりに XmlEnum という短い語を使用できます。

使用例

XmlEnumAttribute 属性を列挙体のメンバに適用する例を次に示します。生成された XML データは、Name プロパティで設定された値に適合します。

Visual Basic

Public Enum EmployeeStatus
   <XmlEnumAttribute("Single")> One
   <XmlEnumAttribute("Double")> Two
   <XmlEnumAttribute("Triple")> Three
End Enum

C#

public enum EmployeeStatus
{
   [XmlEnum("Single")]
   One,
   [XmlEnum("Double")]
   Two,
   [XmlEnum("Triple")]
   Three
}
   

C++

public enum class EmployeeStatus
{
   [XmlEnum("Single")]
   One,
   [XmlEnum("Double")]
   Two,
   [XmlEnum("Triple")]
   Three
};

J#

public class EmployeeStatus
{
    /** @attribute XmlEnum("Single")
     */
    public static int one;
    /** @attribute XmlEnum("Double")
     */
    public static int two;
    /** @attribute XmlEnum("Triple")
     */
    public static int three;
} //EmployeeStatus

プラットフォーム

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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
XmlEnumAttribute クラス
XmlEnumAttribute メンバ
System.Xml.Serialization 名前空間
Serialize
Deserialize
XmlSerializer