XmlAnyAttributeAttribute Clase

Definición

Espacio de nombres:

System.Xml.Serialization

Ensamblados:

netstandard.dll, System.Xml.ReaderWriter.dll

Source:

XmlAnyAttributeAttribute.cs

Especifica que el miembro (un campo que devuelve una matriz de objetos XmlAttribute) puede contener cualquier atributo XML.

C#

[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property | System.AttributeTargets.ReturnValue, AllowMultiple=false)]
public class XmlAnyAttributeAttribute : Attribute

Herencia

Object

Attribute

XmlAnyAttributeAttribute

Atributos

AttributeUsageAttribute

Ejemplos

En el ejemplo siguiente se recopilan todos los atributos desconocidos en una matriz de XmlAttribute objetos . Para probar el ejemplo, cree un archivo denominado UnknownAttributes.xml que contenga el siguiente XML:

<?xml version="1.0" encoding="utf-8"?>  
<Group xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"   
xmlns:xsd="http://www.w3.org/2001/XMLSchema"   
GroupType = 'Technical' GroupNumber = '42' GroupBase = 'Red'>  
  <GroupName>MyGroup</GroupName>  
</Group>  

C#

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

public class Group{
   public string GroupName;
   // The UnknownAttributes array will be used to collect all unknown
   // attributes found when deserializing.
   [XmlAnyAttribute]
    public XmlAttribute[]XAttributes;
}

public class Test{
   static void Main(){
      Test t = new Test();
      // Deserialize the file containing unknown attributes.

      t.DeserializeObject("UnknownAttributes.xml");
   }

   private void DeserializeObject(string filename){
      XmlSerializer ser = new XmlSerializer(typeof(Group));
      // A FileStream is needed to read the XML document.
     FileStream fs = new FileStream(filename, FileMode.Open);
     Group g = (Group) ser.Deserialize(fs);
     fs.Close();
     // Write out the data, including unknown attributes.
     Console.WriteLine(g.GroupName);
     Console.WriteLine("Number of unknown attributes: " + 
     g.XAttributes.Length);
     foreach(XmlAttribute xAtt in g.XAttributes){
     Console.WriteLine(xAtt.Name + ": " + xAtt.InnerXml);
     }
     // Serialize the object again with the attributes added.
     this.SerializeObject("AttributesAdded.xml",g);
   }

   private void SerializeObject(string filename, object g){
      XmlSerializer ser = new XmlSerializer(typeof(Group));
      TextWriter writer = new StreamWriter(filename);
      ser.Serialize(writer, g);
      writer.Close();
   }
}

Comentarios

XmlAnyAttributeAttribute Use para contener datos arbitrarios (como atributos XML) que se envían como parte de un documento XML, como metadatos enviados como parte del documento.

Aplique a XmlAnyAttributeAttribute un campo que devuelva una matriz de XmlAttribute objetos o XmlNode . Cuando se llama al Deserialize método de la XmlSerializer clase , todos los atributos XML que no tienen un miembro correspondiente en la clase que se deserializa se recopilan en la matriz. Después de la deserialización, puede recorrer en iteración la colección de XmlAttribute elementos para procesar los datos.

Los UnknownNode eventos y UnknownAttribute de XmlSerializer no se producen si se aplica a XmlAnyAttributeAttribute un miembro de una clase .

Nota

Puede usar la palabra XmlAnyAttribute en el código en lugar del más largo XmlAnyAttributeAttribute.

Para obtener más información sobre el uso de atributos, vea Atributos.

Constructores

XmlAnyAttributeAttribute()

Construye una nueva instancia de la clase XmlAnyAttributeAttribute.

Propiedades

TypeId

Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute. (Heredado de Attribute)

Métodos

Equals(Object)	Devuelve un valor que indica si esta instancia es igual que un objeto especificado. (Heredado de Attribute)
GetHashCode()	Devuelve el código hash de esta instancia. (Heredado de Attribute)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IsDefaultAttribute()	Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada. (Heredado de Attribute)
Match(Object)	Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado. (Heredado de Attribute)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Se aplica a

Consulte también

• XmlAnyElementAttribute
• XmlSerializer
• XmlAttributes
• Introducción a la serialización XML
• Cómo: Especificar un nombre de elemento alternativo para una secuencia XML
• Controlar la serialización XML mediante atributos
• Ejemplos de serialización XML
• Herramienta de definición de esquema XML (Xsd.exe)