XmlAttributes Sınıf

Tanım

Ad Alanı:

System.Xml.Serialization

Bütünleştirilmiş Kod:

System.Xml.XmlSerializer.dll

Bütünleştirilmiş Kod:

System.Xml.dll

Bütünleştirilmiş Kod:

netstandard.dll

Bir nesneyi seri hale getirme ve seri durumdan çıkarma işlemini XmlSerializer denetleen öznitelik nesneleri koleksiyonunu temsil eder.

public ref class XmlAttributes

public class XmlAttributes

type XmlAttributes = class

Public Class XmlAttributes

Devralma

Object

XmlAttributes

Örnekler

Aşağıdaki örnek, bir nesne dizisi döndüren adlı tek bir alan içeren adlı Orchestra``Instruments sınıfın örneğini Instrument serileştirir. adlı Brass ikinci sınıf sınıfından devralır Instrument . Örnek, alanı geçersiz kılmak için bir XmlAttributes nesne oluşturur ve alanın nesneleri kabul Brass etmesine izin verir ve nesneyi sınıfın XmlAttributeOverrides bir örneğine eklerXmlAttributes.Instrument

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

using namespace System;
using namespace System::IO;
using namespace System::Xml::Serialization;
public ref class Instrument
{
public:
   String^ Name;
};

public ref class Brass: public Instrument
{
public:
   bool IsValved;
};

public ref class Orchestra
{
public:
   array<Instrument^>^Instruments;
};

void SerializeObject( String^ filename )
{
   /* Each overridden field, property, or type requires 
      an XmlAttributes object. */
   XmlAttributes^ attrs = gcnew XmlAttributes;

   /* Create an XmlElementAttribute to override the 
      field that returns Instrument objects. The overridden field
      returns Brass objects instead. */
   XmlElementAttribute^ attr = gcnew XmlElementAttribute;
   attr->ElementName = "Brass";
   attr->Type = Brass::typeid;

   // Add the element to the collection of elements.
   attrs->XmlElements->Add( attr );

   // Create the XmlAttributeOverrides object.
   XmlAttributeOverrides^ attrOverrides = gcnew XmlAttributeOverrides;

   /* Add the type of the class that contains the overridden 
      member and the XmlAttributes to override it with to the 
      XmlAttributeOverrides object. */
   attrOverrides->Add( Orchestra::typeid, "Instruments", attrs );

   // Create the XmlSerializer using the XmlAttributeOverrides.
   XmlSerializer^ s = gcnew XmlSerializer( Orchestra::typeid,attrOverrides );

   // Writing the file requires a TextWriter.
   TextWriter^ writer = gcnew StreamWriter( filename );

   // Create the object that will be serialized.
   Orchestra^ band = gcnew Orchestra;

   // Create an object of the derived type.
   Brass^ i = gcnew Brass;
   i->Name = "Trumpet";
   i->IsValved = true;
   array<Instrument^>^myInstruments = {i};
   band->Instruments = myInstruments;

   // Serialize the object.
   s->Serialize( writer, band );
   writer->Close();
}

void DeserializeObject( String^ filename )
{
   XmlAttributeOverrides^ attrOverrides = gcnew XmlAttributeOverrides;
   XmlAttributes^ attrs = gcnew XmlAttributes;

   // Create an XmlElementAttribute to override the Instrument.
   XmlElementAttribute^ attr = gcnew XmlElementAttribute;
   attr->ElementName = "Brass";
   attr->Type = Brass::typeid;

   // Add the element to the collection of elements.
   attrs->XmlElements->Add( attr );
   attrOverrides->Add( Orchestra::typeid, "Instruments", attrs );

   // Create the XmlSerializer using the XmlAttributeOverrides.
   XmlSerializer^ s = gcnew XmlSerializer( Orchestra::typeid,attrOverrides );
   FileStream^ fs = gcnew FileStream( filename,FileMode::Open );
   Orchestra^ band = dynamic_cast<Orchestra^>(s->Deserialize( fs ));
   Console::WriteLine( "Brass:" );

   /* The difference between deserializing the overridden 
      XML document and serializing it is this: To read the derived 
      object values, you must declare an object of the derived type 
      (Brass), and cast the Instrument instance to it. */
   Brass^ b;
   System::Collections::IEnumerator^ myEnum = band->Instruments->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Instrument^ i = safe_cast<Instrument^>(myEnum->Current);
      b = dynamic_cast<Brass^>(i);
      Console::WriteLine( "{0}\n{1}", b->Name, b->IsValved );
   }
}

int main()
{
   SerializeObject( "Override.xml" );
   DeserializeObject( "Override.xml" );
}

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

public class Orchestra
{
   public Instrument[] Instruments;
}

public class Instrument
{
   public string Name;
}

public class Brass:Instrument
{
   public bool IsValved;
}

public class Run
{
    public static void Main()
    {
       Run test = new Run();
       test.SerializeObject("Override.xml");
       test.DeserializeObject("Override.xml");
    }

    public void SerializeObject(string filename)
    {
      /* Each overridden field, property, or type requires
      an XmlAttributes object. */
      XmlAttributes attrs = new XmlAttributes();

      /* Create an XmlElementAttribute to override the
      field that returns Instrument objects. The overridden field
      returns Brass objects instead. */
      XmlElementAttribute attr = new XmlElementAttribute();
      attr.ElementName = "Brass";
      attr.Type = typeof(Brass);

      // Add the element to the collection of elements.
      attrs.XmlElements.Add(attr);

      // Create the XmlAttributeOverrides object.
      XmlAttributeOverrides attrOverrides = new XmlAttributeOverrides();

      /* Add the type of the class that contains the overridden
      member and the XmlAttributes to override it with to the
      XmlAttributeOverrides object. */
      attrOverrides.Add(typeof(Orchestra), "Instruments", attrs);

      // Create the XmlSerializer using the XmlAttributeOverrides.
      XmlSerializer s =
      new XmlSerializer(typeof(Orchestra), attrOverrides);

      // Writing the file requires a TextWriter.
      TextWriter writer = new StreamWriter(filename);

      // Create the object that will be serialized.
      Orchestra band = new Orchestra();

      // Create an object of the derived type.
      Brass i = new Brass();
      i.Name = "Trumpet";
      i.IsValved = true;
      Instrument[] myInstruments = {i};
      band.Instruments = myInstruments;

      // Serialize the object.
      s.Serialize(writer,band);
      writer.Close();
   }

   public void DeserializeObject(string filename)
   {
      XmlAttributeOverrides attrOverrides =
         new XmlAttributeOverrides();
      XmlAttributes attrs = new XmlAttributes();

      // Create an XmlElementAttribute to override the Instrument.
      XmlElementAttribute attr = new XmlElementAttribute();
      attr.ElementName = "Brass";
      attr.Type = typeof(Brass);

      // Add the element to the collection of elements.
      attrs.XmlElements.Add(attr);

      attrOverrides.Add(typeof(Orchestra), "Instruments", attrs);

      // Create the XmlSerializer using the XmlAttributeOverrides.
      XmlSerializer s =
      new XmlSerializer(typeof(Orchestra), attrOverrides);

      FileStream fs = new FileStream(filename, FileMode.Open);
      Orchestra band = (Orchestra) s.Deserialize(fs);
      Console.WriteLine("Brass:");

      /* The difference between deserializing the overridden
      XML document and serializing it is this: To read the derived
      object values, you must declare an object of the derived type
      (Brass), and cast the Instrument instance to it. */
      Brass b;
      foreach(Instrument i in band.Instruments)
      {
         b = (Brass)i;
         Console.WriteLine(
         b.Name + "\n" +
         b.IsValved);
      }
   }
}

Imports System.IO
Imports System.Xml.Serialization

Public Class Orchestra
    Public Instruments() As Instrument
End Class

Public Class Instrument
    Public Name As String
End Class

Public Class Brass
    Inherits Instrument
    Public IsValved As Boolean
End Class


Public Class Run
    
    Public Shared Sub Main()
        Dim test As New Run()
        test.SerializeObject("Override.xml")
        test.DeserializeObject("Override.xml")
    End Sub    
    
    Public Sub SerializeObject(ByVal filename As String)
        ' Each overridden field, property, or type requires
        ' an XmlAttributes object. 
        Dim attrs As New XmlAttributes()
        
        ' Create an XmlElementAttribute to override the
        ' field that returns Instrument objects. The overridden field
        ' returns Brass objects instead. 
        Dim attr As New XmlElementAttribute()
        attr.ElementName = "Brass"
        attr.Type = GetType(Brass)
        
        ' Add the element to the collection of elements.
        attrs.XmlElements.Add(attr)
        
        ' Create the XmlAttributeOverrides object.
        Dim attrOverrides As New XmlAttributeOverrides()
        
        ' Add the type of the class that contains the overridden
        ' member and the XmlAttributes to override it with to the
        ' XmlAttributeOverrides object. 
        attrOverrides.Add(GetType(Orchestra), "Instruments", attrs)
        
        ' Create the XmlSerializer using the XmlAttributeOverrides.
        Dim s As New XmlSerializer(GetType(Orchestra), attrOverrides)
        
        ' Writing the file requires a TextWriter.
        Dim writer As New StreamWriter(filename)
        
        ' Create the object that will be serialized.
        Dim band As New Orchestra()
        
        ' Create an object of the derived type.
        Dim i As New Brass()
        i.Name = "Trumpet"
        i.IsValved = True
        Dim myInstruments() As Instrument = {i}
        band.Instruments = myInstruments
        
        ' Serialize the object.
        s.Serialize(writer, band)
        writer.Close()
    End Sub
    
    
    Public Sub DeserializeObject(ByVal filename As String)
        Dim attrOverrides As New XmlAttributeOverrides()
        Dim attrs As New XmlAttributes()
        
        ' Create an XmlElementAttribute to override the Instrument.
        Dim attr As New XmlElementAttribute()
        attr.ElementName = "Brass"
        attr.Type = GetType(Brass)
        
        ' Add the element to the collection of elements.
        attrs.XmlElements.Add(attr)
        
        attrOverrides.Add(GetType(Orchestra), "Instruments", attrs)
        
        ' Create the XmlSerializer using the XmlAttributeOverrides.
        Dim s As New XmlSerializer(GetType(Orchestra), attrOverrides)
        
        Dim fs As New FileStream(filename, FileMode.Open)
        Dim band As Orchestra = CType(s.Deserialize(fs), Orchestra)
        Console.WriteLine("Brass:")
        
        ' The difference between deserializing the overridden
        ' XML document and serializing it is this: To read the derived
        ' object values, you must declare an object of the derived type
        ' (Brass), and cast the Instrument instance to it. 
        Dim b As Brass
        Dim i As Instrument
        For Each i In  band.Instruments
            b = CType(i, Brass)
            Console.WriteLine(b.Name + ControlChars.Cr + _
                              b.IsValved.ToString())
        Next i
    End Sub
End Class

Açıklamalar

XmlAttributes oluşturmak, sınıf örneklerini seri hale getirmenin varsayılan yolunu XmlSerializer geçersiz kılan bir işlemin parçasıdır. Örneğin, erişilemeyen bir kaynağa sahip bir DLL'den oluşturulan bir nesneyi seri hale getirmek istediğinizi varsayalım. kullanarak nesnenin XmlAttributeOverridesseri hale nasıl getirilebileceğini genişletebilir veya başka bir şekilde denetleyebilirsiniz.

Sınıfın üyeleri, serileştirmeyi XmlAttributes denetleen öznitelik sınıflarının bir ailesine doğrudan karşılık gelir. Örneğin, XmlText özelliği, özellik değerini XML metni olarak seri hale getirme yönergesi XmlSerializer vererek bir alan veya özelliğin serileştirmesini geçersiz kılmanıza olanak tanıyan bir olarak ayarlanmalıdırXmlTextAttribute. Serileştirmeyi denetleen özniteliklerin tam listesi için bkz XmlSerializer. .

sınıfıyla kullanma XmlAttributeOverrides hakkında XmlAttributes daha fazla ayrıntı için bkz . Nasıl yapılır: XML Akışı için Alternatif Öğe Adı Belirtme.

Oluşturucular

XmlAttributes()	XmlAttributes sınıfının yeni bir örneğini başlatır.
XmlAttributes(ICustomAttributeProvider)	sınıfının yeni bir örneğini XmlAttributes başlatır ve nesnesinin XmlSerializer serileştirme ve seri durumdan çıkarma şeklini özelleştirir.

Özellikler

XmlAnyAttribute	geçersiz kılmak için öğesini XmlAnyAttributeAttribute alır veya ayarlar.
XmlAnyElements	Geçersiz kılınacak nesne koleksiyonunu XmlAnyElementAttribute alır.
XmlArray	Bir ortak alanı veya bir dizi döndüren okuma/yazma özelliğinin nasıl XmlSerializer seri hale getirildiğini belirten bir nesnesi alır veya ayarlar.
XmlArrayItems	Bir ortak alan veya okuma/yazma özelliği tarafından döndürülen bir diziye eklenen öğelerin nasıl XmlSerializer seri hale getirileceğini belirten bir nesne koleksiyonunu alır veya ayarlar.
XmlAttribute	Bir ortak alanı veya genel okuma/yazma özelliğini XML özniteliği olarak nasıl XmlSerializer serileştirdiğini belirten bir nesnesi alır veya ayarlar.
XmlChoiceIdentifier	Bir dizi seçenek arasında ayrım yapmanızı sağlayan bir nesneyi alır veya ayarlar.
XmlDefaultValue	XML öğesinin veya özniteliğinin varsayılan değerini alır veya ayarlar.
XmlElements	Bir ortak alanı veya okuma/yazma özelliğini XML öğesi olarak nasıl XmlSerializer seri hale getireceğini belirten bir nesne koleksiyonu alır.
XmlEnum	Bir sabit listesi üyesini XmlSerializer nasıl serileştirdiğini belirten bir nesneyi alır veya ayarlar.
XmlIgnore	Bir ortak alanın veya genel okuma/yazma özelliğinin XmlSerializer serileştirilip serileştirilmeyeceğini belirten bir değer alır veya ayarlar.
Xmlns	Nesne döndüren bir üye içeren bir nesne geçersiz kılındığında tüm ad alanı bildirimlerinin tutulup tutulmayacağını belirten bir XmlSerializerNamespaces değeri alır veya ayarlar.
XmlRoot	Bir sınıfı XML kök öğesi olarak nasıl XmlSerializer serileştirdiğini belirten bir nesneyi alır veya ayarlar.
XmlText	bir ortak alanı veya ortak okuma/yazma özelliğini XML metni olarak seri hale getirmesini belirten XmlSerializer bir nesnesi alır veya ayarlar.
XmlType	öğesinin uygulandığı bir sınıfı XmlTypeAttribute nasıl XmlSerializer serileştirdiğini belirten bir nesnesi alır veya ayarlar.

Yöntemler

Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• XmlAttributeOverrides
• XmlSerializer
• XmlAttributes
• XML Serileştirmeye Giriş
• Nasıl yapılır: XML Akışı için Alternatif Öğe Adı Belirtme
• Öznitelikleri Kullanarak XML Serileştirmeyi Denetleme
• XML Serileştirme Örnekleri
• XML şema tanımı Aracı (XSD.exe'nin)