XmlElementAttributes Clase

Definición

Espacio de nombres:

System.Xml.Serialization

Ensamblado:

System.Xml.XmlSerializer.dll

Ensamblado:

System.Xml.dll

Ensamblado:

netstandard.dll

Representa una colección de objetos XmlElementAttribute que XmlSerializer usa para reemplazar el modo predeterminado en que serializa una clase.

public ref class XmlElementAttributes : System::Collections::IList

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

public class XmlElementAttributes : System.Collections.IList

public class XmlElementAttributes : System.Collections.CollectionBase

type XmlElementAttributes = class
    interface ICollection
    interface IEnumerable
    interface IList

type XmlElementAttributes = class
    inherit CollectionBase

Public Class XmlElementAttributes
Implements IList

Public Class XmlElementAttributes
Inherits CollectionBase

Herencia

Object

XmlElementAttributes

Herencia

Object

CollectionBase

XmlElementAttributes

Implementaciones

ICollection IEnumerable IList

Ejemplos

En el ejemplo siguiente se serializa la Transportation clase , que contiene un único campo denominado Vehicles que devuelve .ArrayList En primer lugar, el ejemplo aplica dos instancias de la XmlElementAttribute clase al Vehicles campo que especifica los tipos de objetos que inserta XmlSerializer en la matriz. A continuación, el ejemplo crea dos XmlElementAttribute objetos para invalidar el comportamiento de los atributos aplicados a la Vehicles propiedad . Los dos objetos que reemplazan se agregan a la XmlElementAttributes colección de .XmlAttributes Por último, el ejemplo agrega a XmlAttributes , XmlAttributeOverrideslo que permite XmlSerializer insertar los nuevos tipos de objeto en el ArrayList devuelto por el Vehicles campo .

#using <System.Xml.dll>
#using <System.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml::Serialization;
using namespace System::Collections;
using namespace System::Xml;

public ref class Car
{
public:
   String^ Name;
};

public ref class Plane
{
public:
   String^ Name;
};

public ref class Truck
{
public:
   String^ Name;
};

public ref class Train
{
public:
   String^ Name;
};

public ref class Transportation
{
public:

   // Override these two XmlElementAttributes.

   [XmlElement(Car::typeid),
   XmlElement(Plane::typeid)]
   ArrayList^ Vehicles;
};

XmlSerializer^ CreateOverrider()
{
   // Create XmlAtrributes and XmlAttributeOverrides instances. 
   XmlAttributes^ attrs = gcnew XmlAttributes;
   XmlAttributeOverrides^ xOver = gcnew XmlAttributeOverrides;

   /* Create an XmlElementAttributes object to override 
      one of the attributes applied to the Vehicles property. */
   XmlElementAttribute^ xElement1 = gcnew XmlElementAttribute( Truck::typeid );

   // Add the XmlElementAttribute to the collection.
   attrs->XmlElements->Add( xElement1 );

   /* Create a second XmlElementAttribute and 
      add it to the collection. */
   XmlElementAttribute^ xElement2 = gcnew XmlElementAttribute( Train::typeid );
   attrs->XmlElements->Add( xElement2 );

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

   // Create the XmlSerializer, and return it.
   XmlSerializer^ xSer = gcnew XmlSerializer( Transportation::typeid,xOver );
   return xSer;
}

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

   // Create the object.
   Transportation^ myTransportation = gcnew Transportation;

   /* Create two new, overriding objects that can be
      inserted into the Vehicles array. */
   myTransportation->Vehicles = gcnew ArrayList;
   Truck^ myTruck = gcnew Truck;
   myTruck->Name = "MyTruck";
   Train^ myTrain = gcnew Train;
   myTrain->Name = "MyTrain";
   myTransportation->Vehicles->Add( myTruck );
   myTransportation->Vehicles->Add( myTrain );
   TextWriter^ writer = gcnew StreamWriter( filename );
   xSer->Serialize( writer, myTransportation );
}

int main()
{
   SerializeObject( "OverrideElement.xml" );
}

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

Comentarios

XmlElementAttributes La propiedad de la XmlAttributes clase devuelve XmlElements . Mediante el uso de la XmlAttributeOverrides clase y la XmlAttributes clase , puede invalidar la manera predeterminada de serializar XmlSerializer una clase.

Constructores

XmlElementAttributes()

Inicializa una nueva instancia de la clase XmlElementAttributes.

Propiedades

Capacity	Obtiene o establece el número de elementos que puede contener CollectionBase. (Heredado de CollectionBase)
Count	Obtiene el número de elementos incluidos en ICollection.
Count	Obtiene el número de elementos contenidos en la instancia de CollectionBase. Esta propiedad no se puede invalidar. (Heredado de CollectionBase)
InnerList	Obtiene una colección ArrayList que contiene la lista de elementos incluidos en la instancia de CollectionBase. (Heredado de CollectionBase)
Item[Int32]	Obtiene o establece el elemento en el índice especificado.
List	Obtiene una colección IList que contiene la lista de elementos incluidos en la instancia de CollectionBase. (Heredado de CollectionBase)

Métodos

Add(XmlElementAttribute)	Agrega un objeto XmlElementAttribute a la colección.
Clear()	Quita todos los elementos de IList.
Clear()	Elimina todos los objetos de la instancia de CollectionBase. Este método no se puede invalidar. (Heredado de CollectionBase)
Contains(XmlElementAttribute)	Determina si la recopilación contiene el objeto especificado.
CopyTo(XmlElementAttribute[], Int32)	Copia XmlElementAttributes o una parte de la misma en una matriz unidimensional.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetEnumerator()	Devuelve un enumerador que recorre en iteración una colección.
GetEnumerator()	Devuelve un enumerador que recorre en iteración la instancia de CollectionBase. (Heredado de CollectionBase)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IndexOf(XmlElementAttribute)	Obtiene el índice del objeto XmlElementAttribute especificado.
Insert(Int32, XmlElementAttribute)	Inserta un objeto XmlElementAttribute en la colección.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnClear()	Realiza procesos personalizados adicionales al borrar el contenido de la instancia CollectionBase. (Heredado de CollectionBase)
OnClearComplete()	Realiza procesos personalizados adicionales después de borrar el contenido de la instancia de CollectionBase. (Heredado de CollectionBase)
OnInsert(Int32, Object)	Realiza procesos personalizados adicionales antes de insertar un nuevo elemento en la instancia de CollectionBase. (Heredado de CollectionBase)
OnInsertComplete(Int32, Object)	Realiza procesos personalizados adicionales después de insertar un nuevo elemento en la instancia de CollectionBase. (Heredado de CollectionBase)
OnRemove(Int32, Object)	Realiza procesos de personalización adicionales al quitar un elemento de la instancia de CollectionBase. (Heredado de CollectionBase)
OnRemoveComplete(Int32, Object)	Realiza procesos personalizados adicionales después de quitar un elemento de la instancia de CollectionBase. (Heredado de CollectionBase)
OnSet(Int32, Object, Object)	Realiza procesos personalizados adicionales antes de establecer un valor en la instancia de CollectionBase. (Heredado de CollectionBase)
OnSetComplete(Int32, Object, Object)	Realiza procesos personalizados adicionales después de establecer un valor en la instancia de CollectionBase. (Heredado de CollectionBase)
OnValidate(Object)	Realiza procesos de personalización adicionales al validar un valor. (Heredado de CollectionBase)
Remove(XmlElementAttribute)	Quita el objeto especificado de la colección.
RemoveAt(Int32)	Quita el elemento de la interfaz IList que se encuentra en el índice especificado.
RemoveAt(Int32)	Quita el elemento que se encuentra en el índice especificado de la instancia de CollectionBase. Este método no se puede reemplazar. (Heredado de CollectionBase)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

ICollection.CopyTo(Array, Int32)	Copia los elementos de ICollection en Array, empezando por un índice determinado de Array.
ICollection.CopyTo(Array, Int32)	Copia la totalidad de CollectionBase en una matriz Array unidimensional compatible, comenzando en el índice especificado de la matriz de destino. (Heredado de CollectionBase)
ICollection.IsSynchronized	Obtiene un valor que indica si el acceso a la interfaz ICollection está sincronizado (es seguro para subprocesos).
ICollection.IsSynchronized	Obtiene un valor que indica si el acceso a la interfaz CollectionBase está sincronizado (es seguro para subprocesos). (Heredado de CollectionBase)
ICollection.SyncRoot	Obtiene un objeto que se puede usar para sincronizar el acceso a ICollection.
ICollection.SyncRoot	Obtiene un objeto que se puede usar para sincronizar el acceso a CollectionBase. (Heredado de CollectionBase)
IList.Add(Object)	Agrega un elemento a IList.
IList.Add(Object)	Agrega un objeto al final de CollectionBase. (Heredado de CollectionBase)
IList.Contains(Object)	Determina si IList contiene un valor específico.
IList.Contains(Object)	Determina si CollectionBase contiene un elemento específico. (Heredado de CollectionBase)
IList.IndexOf(Object)	Determina el índice de un elemento específico de IList.
IList.IndexOf(Object)	Busca el objeto Object especificado y devuelve el índice de base cero de la primera aparición en toda la colección CollectionBase. (Heredado de CollectionBase)
IList.Insert(Int32, Object)	Inserta un elemento en la interfaz IList, en el índice especificado.
IList.Insert(Int32, Object)	Inserta un elemento en CollectionBase en el índice especificado. (Heredado de CollectionBase)
IList.IsFixedSize	Obtiene un valor que indica si la interfaz IList tiene un tamaño fijo.
IList.IsFixedSize	Obtiene un valor que indica si la interfaz CollectionBase tiene un tamaño fijo. (Heredado de CollectionBase)
IList.IsReadOnly	Obtiene un valor que indica si IList es de solo lectura.
IList.IsReadOnly	Obtiene un valor que indica si CollectionBase es de solo lectura. (Heredado de CollectionBase)
IList.Item[Int32]	Obtiene o establece el elemento en el índice especificado.
IList.Item[Int32]	Obtiene o establece el elemento en el índice especificado. (Heredado de CollectionBase)
IList.Remove(Object)	Quita la primera aparición de un objeto específico de la interfaz IList.
IList.Remove(Object)	Quita la primera aparición de un objeto específico de la interfaz CollectionBase. (Heredado de CollectionBase)

Métodos de extensión

Cast<TResult>(IEnumerable)	Convierte los elementos de IEnumerable en el tipo especificado.
OfType<TResult>(IEnumerable)	Filtra los elementos de IEnumerable en función de un tipo especificado.
AsParallel(IEnumerable)	Habilita la paralelización de una consulta.
AsQueryable(IEnumerable)	Convierte una interfaz IEnumerable en IQueryable.

Consulte también

• XmlAttributes
• Introducir la serialización XML
• Procedimiento para especificar un nombre de elemento alternativo para una secuencia XML
• Controlar la serialización XML mediante atributos
• Ejemplos de serialización XML
• XML Schema Definition Tool (Xsd.exe)