XmlEnumAttribute Construtores
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.
Inicializa uma nova instância da XmlEnumAttribute classe.
Sobrecargas
| Name | Description |
|---|---|
| XmlEnumAttribute() |
Inicializa uma nova instância da XmlEnumAttribute classe. |
| XmlEnumAttribute(String) |
Inicializa uma nova instância da XmlEnumAttribute classe e especifica o valor XML que gera XmlSerializer ou reconhece (quando serializa ou desserializa a enumeração, respetivamente). |
XmlEnumAttribute()
Inicializa uma nova instância da XmlEnumAttribute classe.
public:
XmlEnumAttribute();
public XmlEnumAttribute();
Public Sub New ()
Exemplos
O exemplo seguinte serializa duas classes nomeadas Food e FoodType. A FoodType classe contém duas enumerações que são sobrepostas e, para cada enumeração, o exemplo cria um XmlEnumAttribute objeto que é atribuído à XmlEnum propriedade de um XmlAttributes objeto. O exemplo então adiciona o XmlAttributes objeto a um XmlAttributeOverrides objeto, que é usado para criar um XmlSerializer.
using System;
using System.IO;
using System.Xml;
using System.Xml.Serialization;
// This is the class that will be serialized.
public class Food
{
public FoodType Type;
}
public enum FoodType
{
// Subsequent code overrides these enumerations.
Low,
High
}
public class Run
{
public static void Main()
{
Run test = new Run();
test.SerializeObject("OverrideEnum.xml");
test.DeserializeObject("OverrideEnum.xml");
}
// Return an XmlSerializer used for overriding.
public XmlSerializer CreateOverrider()
{
// Create the XmlOverrides and XmlAttributes objects.
XmlAttributeOverrides xOver = new XmlAttributeOverrides();
XmlAttributes xAttrs = new XmlAttributes();
// Add an XmlEnumAttribute for the FoodType.Low enumeration.
XmlEnumAttribute xEnum = new XmlEnumAttribute();
xEnum.Name = "Cold";
xAttrs.XmlEnum = xEnum;
xOver.Add(typeof(FoodType), "Low", xAttrs);
// Add an XmlEnumAttribute for the FoodType.High enumeration.
xAttrs = new XmlAttributes();
xEnum = new XmlEnumAttribute();
xEnum.Name = "Hot";
xAttrs.XmlEnum = xEnum;
xOver.Add(typeof(FoodType), "High", xAttrs);
// Create the XmlSerializer, and return it.
return new XmlSerializer(typeof(Food), xOver);
}
public void SerializeObject(string filename)
{
// Create an instance of the XmlSerializer class.
XmlSerializer mySerializer = CreateOverrider();
// Writing the file requires a TextWriter.
TextWriter writer = new StreamWriter(filename);
// Create an instance of the class that will be serialized.
Food myFood = new Food();
// Set the object properties.
myFood.Type = FoodType.High;
// Serialize the class, and close the TextWriter.
mySerializer.Serialize(writer, myFood);
writer.Close();
}
public void DeserializeObject(string filename)
{
XmlSerializer mySerializer = CreateOverrider();
FileStream fs = new FileStream(filename, FileMode.Open);
Food myFood = (Food)
mySerializer.Deserialize(fs);
Console.WriteLine(myFood.Type);
}
}
Imports System.IO
Imports System.Xml
Imports System.Xml.Serialization
' This is the class that will be serialized.
Public Class Food
Public Type As FoodType
End Class
Public Enum FoodType
' Subsequent code overrides these enumerations.
Low
High
End Enum
Public Class Run
Public Shared Sub Main()
Dim test As New Run()
test.SerializeObject("OverrideEnum.xml")
test.DeserializeObject("OverrideEnum.xml")
End Sub
' Return an XmlSerializer used for overriding.
Public Function CreateOverrider() As XmlSerializer
' Create the XmlOverrides and XmlAttributes objects.
Dim xOver As New XmlAttributeOverrides()
Dim xAttrs As New XmlAttributes()
' Add an XmlEnumAttribute for the FoodType.Low enumeration.
Dim xEnum As New XmlEnumAttribute()
xEnum.Name = "Cold"
xAttrs.XmlEnum = xEnum
xOver.Add(GetType(FoodType), "Low", xAttrs)
' Add an XmlEnumAttribute for the FoodType.High enumeration.
xAttrs = New XmlAttributes()
xEnum = New XmlEnumAttribute()
xEnum.Name = "Hot"
xAttrs.XmlEnum = xEnum
xOver.Add(GetType(FoodType), "High", xAttrs)
' Create the XmlSerializer, and return it.
Return New XmlSerializer(GetType(Food), xOver)
End Function
Public Sub SerializeObject(ByVal filename As String)
' Create an instance of the XmlSerializer class.
Dim mySerializer As XmlSerializer = CreateOverrider()
' Writing the file requires a TextWriter.
Dim writer As New StreamWriter(filename)
' Create an instance of the class that will be serialized.
Dim myFood As New Food()
' Set the object properties.
myFood.Type = FoodType.High
' Serialize the class, and close the TextWriter.
mySerializer.Serialize(writer, myFood)
writer.Close()
End Sub
Public Sub DeserializeObject(ByVal filename As String)
Dim mySerializer As XmlSerializer = CreateOverrider()
Dim fs As New FileStream(filename, FileMode.Open)
Dim myFood As Food = CType(mySerializer.Deserialize(fs), Food)
Console.WriteLine(myFood.Type)
End Sub
End Class
Observações
Pode usar o XmlEnumAttribute para sobrescrever uma enumeração existente.
Note
Podes usar a palavra XmlEnum no teu código em vez do mais longo XmlEnumAttribute.
Ver também
Aplica-se a
XmlEnumAttribute(String)
Inicializa uma nova instância da XmlEnumAttribute classe e especifica o valor XML que gera XmlSerializer ou reconhece (quando serializa ou desserializa a enumeração, respetivamente).
public:
XmlEnumAttribute(System::String ^ name);
public XmlEnumAttribute(string name);
new System.Xml.Serialization.XmlEnumAttribute : string -> System.Xml.Serialization.XmlEnumAttribute
Public Sub New (name As String)
Parâmetros
- name
- String
O nome predominante do membro da enumeração.
Exemplos
O exemplo seguinte aplica-se aos XmlEnumAttribute membros de uma enumeração. Quando gera XmlSerializer dados XML para esta enumeração, os dados cumprem os valores das Name propriedades.
public enum EmployeeStatus
{
[XmlEnum("Single")]
One,
[XmlEnum("Double")]
Two,
[XmlEnum("Triple")]
Three
}
Public Enum EmployeeStatus
<XmlEnumAttribute("Single")> One
<XmlEnumAttribute("Double")> Two
<XmlEnumAttribute("Triple")> Three
End Enum
Observações
Note
Podes usar a palavra XmlEnum no teu código em vez do mais longo XmlEnumAttribute.