XmlAnyElementAttribute Clase

Definición

public ref class XmlAnyElementAttribute : Attribute

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

[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property | System.AttributeTargets.ReturnValue, AllowMultiple=true)>]
type XmlAnyElementAttribute = class
    inherit Attribute

Public Class XmlAnyElementAttribute
Inherits Attribute

Herencia

Object

Attribute

XmlAnyElementAttribute

Atributos

AttributeUsageAttribute

Ejemplos

En el ejemplo siguiente se aplica a XmlAnyElementAttribute un campo denominado AllElements que devuelve una matriz de XmlElement objetos .

public ref class XClass
{
public:

   /* Apply the XmlAnyElementAttribute to a field returning an array
      of XmlElement objects. */

   [XmlAnyElement]
   array<XmlElement^>^AllElements;
};

public ref class Test
{
public:
   void DeserializeObject( String^ filename )
   {
      // Create an XmlSerializer.
      XmlSerializer^ mySerializer = gcnew XmlSerializer( XClass::typeid );

      // To read a file, a FileStream is needed.
      FileStream^ fs = gcnew FileStream( filename,FileMode::Open );

      // Deserialize the class.
      XClass^ x = dynamic_cast<XClass^>(mySerializer->Deserialize( fs ));

      // Read the element names and values.
      System::Collections::IEnumerator^ myEnum = x->AllElements->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         XmlElement^ xel = safe_cast<XmlElement^>(myEnum->Current);
         Console::WriteLine( "{0}: {1}", xel->LocalName, xel->Value );
      }
   }
};

int main()
{
   Test^ t = gcnew Test;
   t->DeserializeObject( "XFile.xml" );
}

public class XClass
{
   /* Apply the XmlAnyElementAttribute to a field returning an array
   of XmlElement objects. */
   [XmlAnyElement]
   public XmlElement[] AllElements;
}

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

   private void DeserializeObject(string filename)
   {
      // Create an XmlSerializer.
      XmlSerializer mySerializer = new XmlSerializer(typeof(XClass));

      // To read a file, a FileStream is needed.
      FileStream fs = new FileStream(filename, FileMode.Open);

      // Deserialize the class.
      XClass x = (XClass) mySerializer.Deserialize(fs);

      // Read the element names and values.
      foreach(XmlElement xel in x.AllElements)
         Console.WriteLine(xel.LocalName + ": " + xel.Value);
   }
}

Public Class XClass
    ' Apply the XmlAnyElementAttribute to a field returning an array
    ' of XmlElement objects.
    <XmlAnyElement()> Public AllElements() As XmlElement
End Class


Public Class Test
    
    Public Shared Sub Main()
        Dim t As New Test()
        t.DeserializeObject("XFile.xml")
    End Sub
    
    
    Private Sub DeserializeObject(filename As String)
        ' Create an XmlSerializer.
        Dim mySerializer As New XmlSerializer(GetType(XClass))
        
        ' To read a file, a FileStream is needed.
        Dim fs As New FileStream(filename, FileMode.Open)
        
        ' Deserialize the class.
        Dim x As XClass = CType(mySerializer.Deserialize(fs), XClass)
        
        ' Read the element names and values.
        Dim xel As XmlElement
        For Each xel In  x.AllElements
            Console.WriteLine((xel.LocalName & ": " & xel.Value))
        Next xel
    End Sub
End Class

Comentarios

XmlAnyElementAttribute Use para contener datos arbitrarios (como elementos XML) que se pueden enviar como parte de un documento XML, como metadatos enviados como parte del documento.

Aplique a XmlAnyElementAttribute un campo que devuelva una matriz de XmlElement objetos o XmlNode . Este campo se puede usar de dos maneras, dependiendo de si un objeto se está serializando o deserializando. Cuando se serializa, el objeto se genera como elementos o nodos XML, aunque no tengan ningún miembro correspondiente (o miembros) en el objeto que se serializa. Si especifica un Name valor de propiedad al aplicar el atributo , todos los XmlElement objetos o XmlNode insertados en la matriz deben tener el mismo nombre de elemento y el espacio de nombres predeterminado, o se produce una excepción. Si establece el valor de propiedad Namespace , también debe establecer la Name propiedad y los XmlElement objetos o XmlNode también deben tener los mismos valores de nombre y espacio de nombres. Si no se especifica ningún Name valor, los XmlElement objetos o XmlNode pueden tener cualquier nombre de elemento.

Cuando se llama al Deserialize método de la XmlSerializer clase , todos los elementos que no tienen un miembro correspondiente en el objeto que se deserializa se recopilan en la matriz. Después de la deserialización, recorra en iteración la colección de XmlElement elementos para procesar los datos. Si especifica un Name valor, la matriz solo contiene elementos XML con ese nombre. Si no especifica un Name valor, la matriz contiene todos los elementos que no tienen ningún miembro correspondiente en la clase . Si una clase contiene más de un campo al que se aplica el atributo, use las Namepropiedades , o Name y Namespace para diferenciar entre el contenido de las matrices. Si esta clase (con varios campos) también contiene un campo que no tiene valores de propiedad diferenciadores establecidos (es decir, Name y Namespace) durante la deserialización, esta matriz contiene los elementos XML desconocidos que aún no están incluidos en las otras matrices. Si una clase contiene más de un campo que no tiene un valor diferenciador Name, o Name y Namespace establecido, no se especifica el comportamiento durante la deserialización.

También puede aplicar a XmlAnyElementAttribute un campo que devuelva un solo XmlElement objeto. Si lo hace, debe usar las propiedades y los métodos de la XmlElement clase para recorrer en iteración recursiva los elementos desconocidos.

Puede aplicar varias instancias de a XmlAnyElementAttribute un miembro de clase, pero cada instancia debe tener un valor de propiedad distinto Name . O bien, si se establece la misma Name propiedad para cada instancia, se debe establecer un valor de propiedad distinto Namespace para cada instancia.

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

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

Constructores

Propiedades

Métodos

Implementaciones de interfaz explícitas

Se aplica a

Consulte también

• XmlAnyAttributeAttribute
• Introducción a la serialización XML