XmlAttributeAttribute Kelas

Definisi

Ruang nama:

System.Xml.Serialization

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlAttributeAttribute.cs

Menentukan bahwa XmlSerializer harus membuat serialisasi anggota kelas sebagai atribut XML.

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

Warisan

Object

Attribute

XmlAttributeAttribute

Atribut

AttributeUsageAttribute

Contoh

Contoh berikut menserialisasikan kelas yang berisi beberapa bidang yang XmlAttributeAttribute diterapkan.

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

Keterangan

XmlAttributeAttribute milik keluarga atribut yang mengontrol bagaimana XmlSerializer serialisasi, atau deserialisasi, objek. Untuk daftar lengkap atribut serupa, lihat Atribut yang Mengontrol Serialisasi XML.

Saat diterapkan ke bidang atau properti publik, XmlAttributeAttribute menginformasikan untuk menserialisasikan XmlSerializer anggota sebagai atribut XML. Secara default, menserialisasikan XmlSerializer bidang dan properti publik sebagai elemen XML.

Anda dapat menetapkan XmlAttributeAttribute satu-satunya ke bidang publik atau properti publik yang mengembalikan nilai (atau array nilai) yang dapat dipetakan ke salah satu jenis sederhana bahasa definisi Skema XML (XSD) (termasuk semua jenis data bawaan yang berasal dari jenis XSD anySimpleType ). Jenis yang mungkin mencakup apa pun yang dapat dipetakan ke jenis sederhana XSD, termasuk Guid, Char, dan enumerasi. DataType Lihat properti untuk daftar jenis XSD dan bagaimana jenis data dipetakan to.NET.

Ada dua atribut khusus yang dapat diatur dengan XmlAttributeAttribute atribut : xml:lang (menentukan bahasa) dan xml:space (menentukan cara menangani spasi kosong). Atribut ini dimaksudkan untuk menyampaikan informasi yang hanya relevan dengan aplikasi yang memproses XML. Contoh pengaturan ini ditampilkan dalam kode berikut.

[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

Untuk informasi selengkapnya tentang menggunakan atribut, lihat Atribut.

Nota

Anda dapat menggunakan kata XmlAttribute dalam kode Anda alih-alih lebih lama XmlAttributeAttribute.

Konstruktor

Nama	Deskripsi
XmlAttributeAttribute()	Menginisialisasi instans baru dari kelas XmlAttributeAttribute.
XmlAttributeAttribute(String, Type)	Menginisialisasi instans baru dari kelas XmlAttributeAttribute.
XmlAttributeAttribute(String)	Menginisialisasi instans XmlAttributeAttribute baru kelas dan menentukan nama atribut XML yang dihasilkan.
XmlAttributeAttribute(Type)	Menginisialisasi instans baru dari kelas XmlAttributeAttribute.

Properti

Nama	Deskripsi
AttributeName	Mendapatkan atau mengatur nama atribut XML.
DataType	Mendapatkan atau mengatur jenis data XSD dari atribut XML yang dihasilkan oleh XmlSerializer.
Form	Mendapatkan atau menetapkan nilai yang menunjukkan apakah nama atribut XML yang dihasilkan oleh XmlSerializer memenuhi syarat.
Namespace	Mendapatkan atau mengatur namespace XML atribut XML.
Type	Mendapatkan atau mengatur jenis kompleks atribut XML.
TypeId	Ketika diimplementasikan dalam kelas turunan, mendapatkan pengidentifikasi unik untuk Attributeini. (Diperoleh dari Attribute)

Metode

Nama	Deskripsi
Equals(Object)	Mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari Attribute)
GetHashCode()	Mengembalikan kode hash untuk instans ini. (Diperoleh dari Attribute)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
IsDefaultAttribute()	Ketika ditimpa dalam kelas turunan, menunjukkan apakah nilai instans ini adalah nilai default untuk kelas turunan. (Diperoleh dari Attribute)
Match(Object)	Saat ditimpa dalam kelas turunan, mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari Attribute)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)