XmlElementAttributes Класс

Определение

Пространство имен:

System.Xml.Serialization

Сборки:

netstandard.dll, System.Xml.XmlSerializer.dll

Исходный код:

XmlElementAttributes.cs

Представляет коллекцию объектов, используемых XmlElementAttributeXmlSerializer для переопределения способом сериализации класса по умолчанию.

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

public class XmlElementAttributes : System.Collections.CollectionBase

type XmlElementAttributes = class
    inherit CollectionBase

Public Class XmlElementAttributes
Inherits CollectionBase

Наследование

Object

CollectionBase

XmlElementAttributes

Примеры

В следующем примере сериализуется Transportation класс, содержащий одно поле с именем Vehicles , которое возвращает ArrayListзначение. В примере сначала применяется два экземпляра XmlElementAttribute класса к Vehicles полю, указывающее типы объектов XmlSerializer , вставляемых в массив. Затем в примере создаются два XmlElementAttribute объекта для переопределения поведения атрибутов, примененных к свойству Vehicles . Два переопределяющих объекта добавляются в XmlElementAttributes коллекцию XmlAttributesобъекта. Наконец, в примере добавляется к XmlAttributes объекту XmlAttributeOverrides, что позволяет XmlSerializer вставлять новые типы объектов в ArrayList возвращаемое Vehicles поле.

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

Комментарии

Возвращается XmlElementAttributes свойством XmlElementsXmlAttributes класса. Используя XmlAttributeOverrides класс и XmlAttributes класс, можно переопределить стандартный способ XmlSerializer сериализации класса.

Конструкторы

Имя	Описание
XmlElementAttributes()	Инициализирует новый экземпляр класса XmlElementAttributes.

Свойства

Имя	Описание
Capacity	Возвращает или задает количество элементов, которые CollectionBase могут содержаться. (Унаследовано от CollectionBase)
Count	Возвращает количество элементов, содержащихся в экземпляре CollectionBase . Это свойство нельзя переопределить. (Унаследовано от CollectionBase)
InnerList	ArrayList Возвращает список элементов в экземпляреCollectionBase. (Унаследовано от CollectionBase)
Item[Int32]	Возвращает или задает элемент по указанному индексу.
List	IList Возвращает список элементов в экземпляреCollectionBase. (Унаследовано от CollectionBase)

Методы

Имя	Описание
Add(XmlElementAttribute)	Добавляет в XmlElementAttribute коллекцию.
Clear()	Удаляет все объекты из экземпляра CollectionBase . Этот метод нельзя переопределить. (Унаследовано от CollectionBase)
Contains(XmlElementAttribute)	Определяет, содержит ли коллекция указанный объект.
CopyTo(XmlElementAttribute[], Int32)	Копирует XmlElementAttributesчасть или часть ее в одномерный массив.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetEnumerator()	Возвращает перечислитель, который выполняет итерацию по экземпляру CollectionBase . (Унаследовано от CollectionBase)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
IndexOf(XmlElementAttribute)	Возвращает индекс указанного XmlElementAttribute.
Insert(Int32, XmlElementAttribute)	Вставляется XmlElementAttribute в коллекцию.
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
OnClear()	Выполняет дополнительные пользовательские процессы при очистке содержимого экземпляра CollectionBase . (Унаследовано от CollectionBase)
OnClearComplete()	Выполняет дополнительные пользовательские процессы после очистки содержимого экземпляра CollectionBase . (Унаследовано от CollectionBase)
OnInsert(Int32, Object)	Выполняет дополнительные пользовательские процессы перед вставкой нового элемента в CollectionBase экземпляр. (Унаследовано от CollectionBase)
OnInsertComplete(Int32, Object)	Выполняет дополнительные пользовательские процессы после вставки нового элемента в CollectionBase экземпляр. (Унаследовано от CollectionBase)
OnRemove(Int32, Object)	Выполняет дополнительные пользовательские процессы при удалении элемента из экземпляра CollectionBase . (Унаследовано от CollectionBase)
OnRemoveComplete(Int32, Object)	Выполняет дополнительные пользовательские процессы после удаления элемента из экземпляра CollectionBase . (Унаследовано от CollectionBase)
OnSet(Int32, Object, Object)	Выполняет дополнительные пользовательские процессы перед заданием значения в экземпляре CollectionBase . (Унаследовано от CollectionBase)
OnSetComplete(Int32, Object, Object)	Выполняет дополнительные пользовательские процессы после задания значения в экземпляре CollectionBase . (Унаследовано от CollectionBase)
OnValidate(Object)	Выполняет дополнительные пользовательские процессы при проверке значения. (Унаследовано от CollectionBase)
Remove(XmlElementAttribute)	Удаляет указанный объект из коллекции.
RemoveAt(Int32)	Удаляет элемент по указанному индексу экземпляра CollectionBase . Этот метод не переопределяется. (Унаследовано от CollectionBase)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

Явные реализации интерфейса

Имя	Описание
ICollection.CopyTo(Array, Int32)	Копирует весь CollectionBase в совместимую одномерную Array, начиная с указанного индекса целевого массива. (Унаследовано от CollectionBase)
ICollection.IsSynchronized	Возвращает значение, указывающее, синхронизирован ли доступ к CollectionBase (потокобезопасный). (Унаследовано от CollectionBase)
ICollection.SyncRoot	Получает объект, который можно использовать для синхронизации доступа к объекту CollectionBase. (Унаследовано от CollectionBase)
IList.Add(Object)	Добавляет объект в конец CollectionBase. (Унаследовано от CollectionBase)
IList.Contains(Object)	Определяет, содержит ли CollectionBase определенный элемент. (Унаследовано от CollectionBase)
IList.IndexOf(Object)	Выполняет поиск указанного Object и возвращает отсчитываемый от нуля индекс первого вхождения в течение всего CollectionBase. (Унаследовано от CollectionBase)
IList.Insert(Int32, Object)	Вставляет элемент в CollectionBase по указанному индексу. (Унаследовано от CollectionBase)
IList.IsFixedSize	Возвращает значение, указывающее, имеет ли CollectionBase фиксированный размер. (Унаследовано от CollectionBase)
IList.IsReadOnly	Возвращает значение, указывающее, доступен ли CollectionBase только для чтения. (Унаследовано от CollectionBase)
IList.Item[Int32]	Возвращает или задает элемент по указанному индексу. (Унаследовано от CollectionBase)
IList.Remove(Object)	Удаляет первое вхождение определенного объекта из CollectionBase. (Унаследовано от CollectionBase)

Методы расширения

Имя	Описание
AsParallel(IEnumerable)	Включает параллелизацию запроса.
AsQueryable(IEnumerable)	Преобразует IEnumerable в IQueryable.
Cast<TResult>(IEnumerable)	Приведение элементов IEnumerable к указанному типу.
OfType<TResult>(IEnumerable)	Фильтрует элементы IEnumerable на основе указанного типа.

См. также раздел

• XmlAttributes
• Введение в сериализацию XML
• Практическое руководство. Указание альтернативного имени элемента для XML-потока
• Управление сериализацией XML с помощью атрибутов
• Примеры сериализации XML
• Инструмент определения схемы XML (Xsd.exe)