XmlAttributeAttribute.AttributeName Propriedade
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.
Recebe ou define o nome do atributo XML.
public:
property System::String ^ AttributeName { System::String ^ get(); void set(System::String ^ value); };
public string AttributeName { get; set; }
member this.AttributeName : string with get, set
Public Property AttributeName As String
Valor de Propriedade
O nome do atributo XML. O padrão é o nome do membro.
Exemplos
O exemplo seguinte estabelece a AttributeName propriedade de um XmlAttributeAttribute.
using System;
using System.IO;
using System.Xml;
using System.Xml.Serialization;
public class Group
{
// Change the XML attribute name.
[XmlAttribute(AttributeName = "MgrName")]
public string Name;
/* Use the AttributeName to collect all the XML attributes
in the XML-document instance. */
}
public class Run
{
public static void Main()
{
Run test = new Run();
/* To use the AttributeName to collect all the
XML attributes. Call SerializeObject to generate
an XML document and alter the document by adding
new XML attributes to it. Then comment out the SerializeObject
method, and call DeserializeObject. */
test.SerializeObject("MyAtts.xml");
test.DeserializeObject("MyAtts.xml");
}
public void SerializeObject(string filename)
{
Console.WriteLine("Serializing");
// Create an instance of the XmlSerializer class.
XmlSerializer mySerializer = new XmlSerializer(typeof(Group));
// Writing the file requires a TextWriter.
TextWriter writer = new StreamWriter(filename);
// Create an instance of the class that will be serialized.
Group myGroup = new Group();
/* Set the Name property, which will be generated
as an XML attribute. */
myGroup.Name = "Wallace";
// Serialize the class, and close the TextWriter.
mySerializer.Serialize(writer, myGroup);
writer.Close();
}
public void DeserializeObject(string filename)
{
Console.WriteLine("Deserializing");
XmlSerializer mySerializer =
new XmlSerializer(typeof(Group));
FileStream fs = new FileStream(filename, FileMode.Open);
Group myGroup = (Group)
mySerializer.Deserialize(fs);
Console.WriteLine(myGroup.Name);
}
}
Option Explicit
Option Strict
Imports System.IO
Imports System.Xml
Imports System.Xml.Serialization
Public Class Group
' Change the XML attribute name.
<XmlAttribute(AttributeName := "MgrName")> Public Name As String
' Use the AttributeName to collect all the XML attributes
' in the XML-document instance.
<XmlAttribute(AttributeName := "*")> Public Attrs() As XmlAttribute
End Class
Public Class Run
Public Shared Sub Main()
Dim test As New Run()
' To use the AttributeName to collect all the
' XML attributes. Call SerializeObject to generate
' an XML document and alter the document by adding
' new XML attributes to it. Then comment out the SerializeObject
' method, and call DeserializeObject.
test.SerializeObject("MyAtts.xml")
test.DeserializeObject("MyAtts.xml")
End Sub
Public Sub SerializeObject(ByVal filename As String)
Console.WriteLine("Serializing")
' Create an instance of the XmlSerializer class.
Dim mySerializer As New XmlSerializer(GetType(Group))
' Writing the file requires a TextWriter.
Dim writer As New StreamWriter(filename)
' Create an instance of the class that will be serialized.
Dim myGroup As New Group()
' Set the Name property, which will be generated
' as an XML attribute.
myGroup.Name = "Wallace"
' Serialize the class, and close the TextWriter.
mySerializer.Serialize(writer, myGroup)
writer.Close()
End Sub
Public Sub DeserializeObject(ByVal filename As String)
Console.WriteLine("Deserializing")
Dim mySerializer As New XmlSerializer(GetType(Group))
Dim fs As New FileStream(filename, FileMode.Open)
Dim myGroup As Group = CType(mySerializer.Deserialize(fs), Group)
' The following code prints all the attributes in the
' XML document. To collect the attributes, the AttributeName of the
' XmlAttributeAttribute must be set to "*".
Dim xAtt As XmlAttribute
For Each xAtt In myGroup.Attrs
Console.WriteLine(xAtt.Name & ":" & xAtt.Value)
Next xAtt
End Sub
End Class
Observações
Use a AttributeName propriedade para especificar um nome de atributo XML quando o valor padrão não pode ser usado. Por exemplo, se o nome do atributo XML for inválido como identificador de membro, pode usar um nome válido para o identificador enquanto define o AttributeName como um nome inválido.