XmlAttributeAttribute Sınıf

Tanım

Ad Alanı:

System.Xml.Serialization

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

Kaynak:

XmlAttributeAttribute.cs

XmlSerializer sınıf üyesini XML özniteliği olarak seri hale getirmesi gerektiğini belirtir.

public ref class XmlAttributeAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property | System.AttributeTargets.ReturnValue)]
public class XmlAttributeAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property | System.AttributeTargets.ReturnValue)>]
type XmlAttributeAttribute = class
    inherit Attribute

Public Class XmlAttributeAttribute
Inherits Attribute

Devralma

Object

Attribute

XmlAttributeAttribute

Öznitelikler

AttributeUsageAttribute

Örnekler

Aşağıdaki örnek, uygulandığı birkaç alan XmlAttributeAttribute içeren bir sınıfı serileştirir.

using System;
using System.IO;
using System.Xml;
using System.Xml.Serialization;
using System.Xml.Schema;

public class Group
{
   [XmlAttribute (Namespace = "http://www.cpandl.com")]
   public string GroupName;

   [XmlAttribute(DataType = "base64Binary")]
   public Byte [] GroupNumber;

   [XmlAttribute(DataType = "date", AttributeName = "CreationDate")]
   public DateTime Today;
}

public class Run
{
   public static void Main()
   {
      Run test = new Run();
      test.SerializeObject("Attributes.xml");
   }

   public void SerializeObject(string filename)
   {
      // 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 object properties.
      myGroup.GroupName = ".NET";

      Byte [] hexByte = new Byte[2]{Convert.ToByte(100),
      Convert.ToByte(50)};
      myGroup.GroupNumber = hexByte;

      DateTime myDate = new DateTime(2001,1,10);
      myGroup.Today = myDate;

      // Serialize the class, and close the TextWriter.
      mySerializer.Serialize(writer, myGroup);
       writer.Close();
   }
}

Option Explicit
Option Strict

Imports System.IO
Imports System.Xml
Imports System.Xml.Serialization
Imports System.Xml.Schema


Public Class Group
    <XmlAttribute(Namespace := "http://www.cpandl.com")> _
        Public GroupName As String    
    <XmlAttribute(DataType := "base64Binary")> _
        Public GroupNumber() As Byte    
    <XmlAttribute(DataType := "date", AttributeName := "CreationDate")> _
        Public Today As DateTime
End Class

Public Class Run
    
    Public Shared Sub Main()
        Dim test As New Run()
        test.SerializeObject("Attributes.xml")
    End Sub 
    
    Public Sub SerializeObject(ByVal filename As String)
        ' 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 object properties.
        myGroup.GroupName = ".NET"
        
        Dim hexByte() As Byte = {Convert.ToByte(100), Convert.ToByte(50)}
        myGroup.GroupNumber = hexByte
        
        Dim myDate As New DateTime(2001, 1, 10)
        myGroup.Today = myDate
        
        ' Serialize the class, and close the TextWriter.
        mySerializer.Serialize(writer, myGroup)
        writer.Close()
    End Sub
End Class

Açıklamalar

, XmlAttributeAttribute bir nesnenin nasıl serileştirildiğini veya seri durumdan XmlSerializer çıkarıldığını denetleen bir öznitelik ailesine aittir. Benzer özniteliklerin tam listesi için bkz. XML Serileştirmesini Denetleen Öznitelikler.

Bir ortak alana veya özelliğe uygulandığında XmlAttributeAttribute , öğesini üyesini XML özniteliği olarak seri hale getirmesi konusunda bilgilendirmektedir XmlSerializer . Varsayılan olarak, XmlSerializer ortak alanları ve özellikleri XML öğeleri olarak serileştirir.

Yalnızca xml şeması tanım dili (XSD) basit türlerinden birine (XSD anySimpleType türünden türetilen tüm yerleşik veri türleri dahil) eşlenebilen bir değer (veya değer dizisi) döndüren ortak alanlara veya ortak özelliklere atayabilirsinizXmlAttributeAttribute. Olası türler, , Charve numaralandırmaları dahil olmak üzere GuidXSD basit türlerine eşlenebilen herhangi birini içerir. DataType XSD türlerinin listesi ve bunların veri türleri to.NET nasıl eşlendiği için özelliğine bakın.

ile XmlAttributeAttribute ayarlanabilen iki özel öznitelik vardır: xml:lang (dili belirtir) ve xml:space (boşluk işlemeyi belirtir) öznitelikleri. Bu öznitelikler, yalnızca XML'yi işleyen bir uygulamayla ilgili bilgileri iletmeye yöneliktir. Bunları ayarlama örnekleri aşağıdaki kodda gösterilmiştir.

[XmlAttribute("xml:lang")]
 public string Lang;
 // Set this to 'default' or 'preserve'.
 [XmlAttribute("space",
 Namespace = "http://www.w3.org/XML/1998/namespace")]
 public string Space

<XmlAttribute("xml:lang")> _
Public Lang As String
' Set this to 'default' or 'preserve'.
<XmlAttribute("space", _
Namespace:= "http://www.w3.org/XML/1998/namespace")> _
Public Space As String

Öznitelikleri kullanma hakkında daha fazla bilgi için bkz . Öznitelikler.

Uyarı

uzun yerine XmlAttributeAttributekodunuzda sözcüğünü XmlAttribute kullanabilirsiniz.

Oluşturucular

Name	Description
XmlAttributeAttribute()	XmlAttributeAttribute sınıfının yeni bir örneğini başlatır.
XmlAttributeAttribute(String, Type)	XmlAttributeAttribute sınıfının yeni bir örneğini başlatır.
XmlAttributeAttribute(String)	Sınıfının yeni bir örneğini XmlAttributeAttribute başlatır ve oluşturulan XML özniteliğinin adını belirtir.
XmlAttributeAttribute(Type)	XmlAttributeAttribute sınıfının yeni bir örneğini başlatır.

Özellikler

Name	Description
AttributeName	XML özniteliğinin adını alır veya ayarlar.
DataType	tarafından XmlSerializeroluşturulan XML özniteliğinin XSD veri türünü alır veya ayarlar.
Form	tarafından XmlSerializer oluşturulan XML öznitelik adının nitelenmiş olup olmadığını gösteren bir değer alır veya ayarlar.
Namespace	XML özniteliğinin XML ad alanını alır veya ayarlar.
Type	XML özniteliğinin karmaşık türünü alır veya ayarlar.
TypeId	Türetilmiş bir sınıfta uygulandığında, bu Attributeiçin benzersiz bir tanımlayıcı alır. (Devralındığı yer: Attribute)

Yöntemler

Name	Description
Equals(Object)	Bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür. (Devralındığı yer: Attribute)
GetHashCode()	Bu örneğin karma kodunu döndürür. (Devralındığı yer: Attribute)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
IsDefaultAttribute()	Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin değerinin türetilmiş sınıf için varsayılan değer olup olmadığını gösterir. (Devralındığı yer: Attribute)
Match(Object)	Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür. (Devralındığı yer: Attribute)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)