XmlEnumAttribute 類別

定義

控制 XmlSerializer 序列化列舉型別 (Enumeration) 成員的方式。

public ref class XmlEnumAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.Field)]
public class XmlEnumAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.Field)>]
type XmlEnumAttribute = class
    inherit Attribute
Public Class XmlEnumAttribute
Inherits Attribute
繼承
XmlEnumAttribute
屬性

範例

下列範例會將 XmlEnumAttribute 套用至 列舉的成員。 XmlSerializer當 產生這個列舉的 Name XML 資料時,資料會符合屬性的值。

public enum class EmployeeStatus
{
   [XmlEnum(Name = "Single")]
   One,
   [XmlEnum(Name = "Double")]
   Two,
   [XmlEnum(Name = "Triple")]
   Three
};
public enum EmployeeStatus
{
   [XmlEnum(Name = "Single")]
   One,
   [XmlEnum(Name = "Double")]
   Two,
   [XmlEnum(Name = "Triple")]
   Three
}
Public Enum EmployeeStatus
   <XmlEnum("Single")> One = 1
   <XmlEnum("Double")> Two = 2
   <XmlEnum("Triple")> Three = 3
End Enum

注意

您可以在程式碼中使用這個字, XmlEnum 而不是較長 XmlEnumAttribute 的 。

備註

XmlEnumAttribute屬於一系列屬性,可控制序列化或還原序列化物件的方式 XmlSerializer 。 如需類似屬性的完整清單,請參閱 控制 XML 序列化的屬性

使用 來 XmlEnumAttribute 變更 在分別序列化或還原序列化) 類別時,產生或辨識 (的列舉 XmlSerializer 。 例如,如果列舉包含名為 One 的成員,但您偏好將 XML 輸出命名 Single 為 ,請將 套用 XmlEnumAttribute 至列舉成員,並將 屬性設定 Name 為 「Single」。

您可以建立 類別的 XmlEnumAttribute 實例,並將它指派給 XmlEnum 物件的 屬性,以覆寫 NameXmlAttributes 屬性值 XmlEnumAttribute 。 如需詳細資訊,請參閱 類別 XmlAttributeOverrides

注意

您可以在程式碼中使用這個字, XmlEnum 而不是較長 XmlEnumAttribute 的 。

建構函式

XmlEnumAttribute()

初始化 XmlEnumAttribute 類別的新執行個體。

XmlEnumAttribute(String)

初始化 XmlEnumAttribute 類別的新執行個體,並指定 XmlSerializer 分別在序列化或還原序列化列舉型別時所產生或識別的 XML 值。

屬性

Name

取得或設定當 XmlSerializer 序列化列舉型別時,在 XML 文件執行個體所產生的值,或是當它還原序列化列舉型別成員時所識別的值。

TypeId

在衍生類別中實作時,取得這個 Attribute 的唯一識別碼。

(繼承來源 Attribute)

方法

Equals(Object)

傳回值,這個值指出此執行個體是否與指定的物件相等。

(繼承來源 Attribute)
GetHashCode()

傳回這個執行個體的雜湊碼。

(繼承來源 Attribute)
GetType()

取得目前執行個體的 Type

(繼承來源 Object)
IsDefaultAttribute()

在衍生類別中覆寫時,表示這個執行個體的值是衍生類別的預設值。

(繼承來源 Attribute)
Match(Object)

在衍生類別中覆寫時,會傳回值,表示這個執行個體是否等於指定物件。

(繼承來源 Attribute)
MemberwiseClone()

建立目前 Object 的淺層複製。

(繼承來源 Object)
ToString()

傳回代表目前物件的字串。

(繼承來源 Object)

明確介面實作

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

將一組名稱對應至一組對應的分派識別項 (Dispatch Identifier)。

(繼承來源 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

擷取物件的類型資訊,可以用來取得介面的類型資訊。

(繼承來源 Attribute)
_Attribute.GetTypeInfoCount(UInt32)

擷取物件提供的類型資訊介面數目 (0 或 1)。

(繼承來源 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

提供物件所公開的屬性和方法的存取權。

(繼承來源 Attribute)

適用於

另請參閱