XmlElementAttributes Kelas

Definisi

Ruang nama:

System.Xml.Serialization

Rakitan:

netstandard.dll, System.Xml.XmlSerializer.dll

Sumber:

XmlElementAttributes.cs

Mewakili kumpulan XmlElementAttribute objek yang digunakan oleh XmlSerializer untuk mengambil alih cara default menserialisasi kelas.

public ref class XmlElementAttributes : System::Collections::CollectionBase

public class XmlElementAttributes : System.Collections.CollectionBase

type XmlElementAttributes = class
    inherit CollectionBase

Public Class XmlElementAttributes
Inherits CollectionBase

Warisan

Object

CollectionBase

XmlElementAttributes

Contoh

Contoh berikut menserialisasikan Transportation kelas, yang berisi satu bidang bernama Vehicles yang mengembalikan ArrayList. Contoh pertama menerapkan dua instans XmlElementAttribute kelas ke Vehicles bidang yang menentukan jenis objek yang dimasukkan XmlSerializer ke dalam array. Contoh kemudian membuat dua XmlElementAttribute objek untuk mengambil alih perilaku atribut yang diterapkan ke Vehicles properti . Dua objek penimpaan ditambahkan ke XmlElementAttributes koleksi XmlAttributes. Terakhir, contoh menambahkan XmlAttributes ke XmlAttributeOverrides, yang memungkinkan XmlSerializer untuk menyisipkan jenis objek baru ke dalam yang ArrayList dikembalikan oleh Vehicles bidang .

using System;
using System.IO;
using System.Xml.Serialization;
using System.Collections;
using System.Xml;

public class Transportation
{
   // Override these two XmlElementAttributes.
   [XmlElement(typeof(Car)),
   XmlElement(typeof(Plane))]
   public ArrayList Vehicles;
}

public class Car
{
   public string Name;
}

public class Plane
{
   public string Name;
}

public class Truck
{
   public string Name;
}

public class Train
{
   public string Name;
}

public class Test
{
   public static void Main()
   {
      Test t = new Test();
      t.SerializeObject("OverrideElement.xml");
   }

   public XmlSerializer CreateOverrider()
   {
      // Create XmlAtrributes and XmlAttributeOverrides instances.

      XmlAttributes attrs = new XmlAttributes();

      XmlAttributeOverrides xOver =
      new XmlAttributeOverrides();

      /* Create an XmlElementAttributes object to override
      one of the attributes applied to the Vehicles property. */
      XmlElementAttribute xElement1 =
      new XmlElementAttribute(typeof(Truck));
      // Add the XmlElementAttribute to the collection.
      attrs.XmlElements.Add(xElement1);

      /* Create a second XmlElementAttribute and
      add it to the collection. */
      XmlElementAttribute xElement2 =
      new XmlElementAttribute(typeof(Train));
      attrs.XmlElements.Add(xElement2);

      /* Add the XmlAttributes to the XmlAttributeOverrides,
      specifying the member to override. */
      xOver.Add(typeof(Transportation), "Vehicles", attrs);

      // Create the XmlSerializer, and return it.
      XmlSerializer xSer = new XmlSerializer
      (typeof(Transportation), xOver);
      return xSer;
   }

   public void SerializeObject(string filename)
   {
      // Create an XmlSerializer instance.
      XmlSerializer xSer = CreateOverrider();

      // Create the object.
      Transportation myTransportation =
      new Transportation();

      /* Create two new, overriding objects that can be
      inserted into the Vehicles array. */
      myTransportation.Vehicles = new ArrayList();
      Truck myTruck = new Truck();
      myTruck.Name = "MyTruck";

      Train myTrain = new Train();
      myTrain.Name = "MyTrain";

      myTransportation.Vehicles.Add(myTruck);
      myTransportation.Vehicles.Add(myTrain);

      TextWriter writer = new StreamWriter(filename);
      xSer.Serialize(writer, myTransportation);
   }
}

Imports System.IO
Imports System.Xml.Serialization
Imports System.Collections
Imports System.Xml


Public Class Transportation
    ' Override these two XmlElementAttributes.
    <XmlElement(GetType(Car)), _
     XmlElement(GetType(Plane))> _
    Public Vehicles As ArrayList
End Class

Public Class Car
    Public Name As String
End Class

Public Class Plane
    Public Name As String
End Class

Public Class Truck
    Public Name As String
End Class

Public Class Train
    Public Name As String
End Class

Public Class Test
    
    Public Shared Sub Main()
        Dim t As New Test()
        t.SerializeObject("OverrideElement.xml")
    End Sub
    
    
    Public Function CreateOverrider() As XmlSerializer
        ' Create XmlAtrributes and XmlAttributeOverrides instances. 
        Dim attrs As New XmlAttributes()
        
        Dim xOver As New XmlAttributeOverrides()
        
        ' Create an XmlElementAttributes object to override
        ' one of the attributes applied to the Vehicles property. 
        Dim xElement1 As New XmlElementAttribute(GetType(Truck))
        ' Add the XmlElementAttribute to the collection.
        attrs.XmlElements.Add(xElement1)
        
        ' Create a second XmlElementAttribute and
        ' add it to the collection. 
        Dim xElement2 As New XmlElementAttribute(GetType(Train))
        attrs.XmlElements.Add(xElement2)
        
        ' Add the XmlAttributes to the XmlAttributeOverrides,
        ' specifying the member to override. 
        xOver.Add(GetType(Transportation), "Vehicles", attrs)
        
        ' Create the XmlSerializer, and return it.
        Dim xSer As New XmlSerializer(GetType(Transportation), xOver)
        Return xSer
    End Function
    
    
    Public Sub SerializeObject(ByVal filename As String)
        ' Create an XmlSerializer instance.
        Dim xSer As XmlSerializer = CreateOverrider()
        
        ' Create the object.
        Dim myTransportation As New Transportation()
        
        ' Create two new, overriding objects that can be
        ' inserted into the Vehicles array. 
        myTransportation.Vehicles = New ArrayList()
        Dim myTruck As New Truck()
        myTruck.Name = "MyTruck"
        
        Dim myTrain As New Train()
        myTrain.Name = "MyTrain"
        
        myTransportation.Vehicles.Add(myTruck)
        myTransportation.Vehicles.Add(myTrain)
        
        Dim writer As New StreamWriter(filename)
        xSer.Serialize(writer, myTransportation)
    End Sub
End Class

Keterangan

XmlElementAttributes dikembalikan oleh XmlElements properti kelas XmlAttributes . Dengan menggunakan XmlAttributeOverrides kelas dan XmlAttributes kelas , Anda dapat mengambil alih cara default yang menserialisasikan XmlSerializer kelas.

Konstruktor

Nama	Deskripsi
XmlElementAttributes()	Menginisialisasi instans baru dari kelas XmlElementAttributes.

Properti

Nama	Deskripsi
Capacity	Mendapatkan atau mengatur jumlah elemen yang dapat dikandung CollectionBase . (Diperoleh dari CollectionBase)
Count	Mendapatkan jumlah elemen yang terkandung dalam CollectionBase instans. Properti ini tidak dapat ditimpa. (Diperoleh dari CollectionBase)
InnerList	Mendapatkan yang ArrayList berisi daftar elemen dalam CollectionBase instans. (Diperoleh dari CollectionBase)
Item[Int32]	Mendapatkan atau mengatur elemen pada indeks yang ditentukan.
List	Mendapatkan yang IList berisi daftar elemen dalam CollectionBase instans. (Diperoleh dari CollectionBase)

Metode

Nama	Deskripsi
Add(XmlElementAttribute)	XmlElementAttribute Menambahkan ke koleksi.
Clear()	Menghapus semua objek dari CollectionBase instans. Metode ini tidak dapat ditimpa. (Diperoleh dari CollectionBase)
Contains(XmlElementAttribute)	Menentukan apakah koleksi berisi objek yang ditentukan.
CopyTo(XmlElementAttribute[], Int32)	XmlElementAttributesMenyalin , atau sebagiannya ke array satu dimensi.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetEnumerator()	Mengembalikan enumerator yang melakukan iterasi melalui CollectionBase instans. (Diperoleh dari CollectionBase)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
IndexOf(XmlElementAttribute)	Mendapatkan indeks dari XmlElementAttribute.
Insert(Int32, XmlElementAttribute)	Menyisipkan ke XmlElementAttribute dalam koleksi.
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
OnClear()	Melakukan proses kustom tambahan saat menghapus konten instans CollectionBase . (Diperoleh dari CollectionBase)
OnClearComplete()	Melakukan proses kustom tambahan setelah menghapus konten instans CollectionBase . (Diperoleh dari CollectionBase)
OnInsert(Int32, Object)	Melakukan proses kustom tambahan sebelum memasukkan elemen baru ke CollectionBase dalam instans. (Diperoleh dari CollectionBase)
OnInsertComplete(Int32, Object)	Melakukan proses kustom tambahan setelah menyisipkan elemen baru ke CollectionBase dalam instans. (Diperoleh dari CollectionBase)
OnRemove(Int32, Object)	Melakukan proses kustom tambahan saat menghapus elemen dari CollectionBase instans. (Diperoleh dari CollectionBase)
OnRemoveComplete(Int32, Object)	Melakukan proses kustom tambahan setelah menghapus elemen dari CollectionBase instans. (Diperoleh dari CollectionBase)
OnSet(Int32, Object, Object)	Melakukan proses kustom tambahan sebelum mengatur nilai dalam CollectionBase instans. (Diperoleh dari CollectionBase)
OnSetComplete(Int32, Object, Object)	Melakukan proses kustom tambahan setelah menetapkan nilai dalam CollectionBase instans. (Diperoleh dari CollectionBase)
OnValidate(Object)	Melakukan proses kustom tambahan saat memvalidasi nilai. (Diperoleh dari CollectionBase)
Remove(XmlElementAttribute)	Menghapus objek yang ditentukan dari koleksi.
RemoveAt(Int32)	Menghapus elemen pada indeks instans yang CollectionBase ditentukan. Metode ini tidak dapat diganti. (Diperoleh dari CollectionBase)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
ICollection.CopyTo(Array, Int32)	Menyalin seluruh CollectionBase ke satu dimensi Arrayyang kompatibel , dimulai pada indeks array target yang ditentukan. (Diperoleh dari CollectionBase)
ICollection.IsSynchronized	Mendapatkan nilai yang menunjukkan apakah akses ke CollectionBase disinkronkan (utas aman). (Diperoleh dari CollectionBase)
ICollection.SyncRoot	Mendapatkan objek yang dapat digunakan untuk menyinkronkan akses ke CollectionBase. (Diperoleh dari CollectionBase)
IList.Add(Object)	Menambahkan objek ke akhir CollectionBase. (Diperoleh dari CollectionBase)
IList.Contains(Object)	Menentukan apakah CollectionBase berisi elemen tertentu. (Diperoleh dari CollectionBase)
IList.IndexOf(Object)	Mencari yang ditentukan Object dan mengembalikan indeks berbasis nol dari kemunculan pertama dalam seluruh CollectionBase. (Diperoleh dari CollectionBase)
IList.Insert(Int32, Object)	Menyisipkan elemen ke CollectionBase dalam pada indeks yang ditentukan. (Diperoleh dari CollectionBase)
IList.IsFixedSize	Mendapatkan nilai yang menunjukkan apakah CollectionBase memiliki ukuran tetap. (Diperoleh dari CollectionBase)
IList.IsReadOnly	Mendapatkan nilai yang menunjukkan apakah CollectionBase bersifat baca-saja. (Diperoleh dari CollectionBase)
IList.Item[Int32]	Mendapatkan atau mengatur elemen pada indeks yang ditentukan. (Diperoleh dari CollectionBase)
IList.Remove(Object)	Menghapus kemunculan pertama objek tertentu dari CollectionBase. (Diperoleh dari CollectionBase)

Metode Ekstensi

Nama	Deskripsi
AsParallel(IEnumerable)	Mengaktifkan paralelisasi kueri.
AsQueryable(IEnumerable)	Mengonversi IEnumerable menjadi IQueryable.
Cast<TResult>(IEnumerable)	Melemparkan elemen IEnumerable ke jenis yang ditentukan.
OfType<TResult>(IEnumerable)	Memfilter elemen IEnumerable berdasarkan jenis tertentu.

Lihat juga

• XmlAttributes
• Memperkenalkan Serialisasi XML
• Cara: Menentukan Nama Elemen Alternatif untuk Aliran XML
• Mengontrol Serialisasi XML Menggunakan Atribut
• Contoh Serialisasi XML
• Alat Definisi Skema XML (Xsd.exe)