XmlTextAttribute Sınıf

Tanım

Ad Alanı:

System.Xml.Serialization

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

Kaynak:

XmlTextAttribute.cs

XmlSerializer Öğesini içeren sınıf seri hale getirildiğinde veya seri durumdan çıkarıldığında üyenin XML metni olarak kabul edilmesi gerektiğini belirtir.

C#

[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property | System.AttributeTargets.ReturnValue)]
public class XmlTextAttribute : Attribute

Devralma

Object

Attribute

XmlTextAttribute

Öznitelikler

AttributeUsageAttribute

Örnekler

C#

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

public class Group1{
   // The XmlTextAttribute with type set to string informs the
   // XmlSerializer that strings should be serialized as XML text.
   [XmlText(typeof(string))]
   [XmlElement(typeof(int))]
   [XmlElement(typeof(double))]
   public object [] All= new object []{321, "One", 2, 3.0, "Two" };
}

public class Group2{
   [XmlText(Type = typeof(GroupType))]
   public GroupType Type;
}
public enum GroupType{
   Small,
   Medium,
   Large
}

public class Group3{
   [XmlText(Type=typeof(DateTime))]
   public DateTime CreationTime = DateTime.Now;
}

public class Test{
   static void Main(){
      Test t = new Test();
      t.SerializeArray("XmlText1.xml");
      t.SerializeEnum("XmlText2.xml");
      t.SerializeDateTime("XmlText3.xml");
   }

   private void SerializeArray(string filename){
      XmlSerializer ser = new XmlSerializer(typeof(Group1));
      Group1 myGroup1 = new Group1();

      TextWriter writer = new StreamWriter(filename);

      ser.Serialize(writer, myGroup1);
      writer.Close();
   }

   private void SerializeEnum(string filename){
      XmlSerializer ser = new XmlSerializer(typeof(Group2));
      Group2 myGroup = new Group2();
      myGroup.Type = GroupType.Medium;
      TextWriter writer = new StreamWriter(filename);

      ser.Serialize(writer, myGroup);
      writer.Close();
   }

   private void SerializeDateTime(string filename){
      XmlSerializer ser = new XmlSerializer(typeof(Group3));
      Group3 myGroup = new Group3();
      TextWriter writer = new StreamWriter(filename);

      ser.Serialize(writer, myGroup);
      writer.Close();
   }
}

Açıklamalar

, XmlTextAttribute nesnesinin (ve Deserialize yöntemleri aracılığıylaSerialize) nasıl XmlSerializer seri hale getirildiğini ve seri durumdan çıkarıldığını denetleen bir öznitelik ailesine aittir. Benzer özniteliklerin tam listesi için bkz. XML Serileştirmesini Denetleen Öznitelikler.

Sınıfın XmlTextAttribute yalnızca bir örneği bir sınıfa uygulanabilir.

genel alanlara ve temel ve numaralandırma türleri döndüren genel okuma/yazma özelliklerine uygulayabilirsiniz XmlTextAttribute .

dize dizisini XmlTextAttribute döndüren bir alana veya özelliğe uygulayabilirsiniz. Özniteliği bir tür Object dizisine de uygulayabilirsiniz, ancak özelliğini dize olarak ayarlamanız Type gerekir. Bu durumda, diziye eklenen tüm dizeler XML metni olarak serileştirilir.

, XmlTextAttribute veya bir nesne dizisi XmlNode döndüren XmlNode bir alana da uygulanabilir.

Varsayılan olarak, XmlSerializer bir sınıf üyesini XML öğesi olarak serileştirir. Ancak öğesini bir üyeye uygularsanız XmlTextAttribute , XmlSerializer değeri XML metnine çevrilir. Bu, değerin bir XML öğesinin içeriğine kodlanmış olduğu anlamına gelir.

XML Şema Tanımı Aracı (Xsd.exe) bazen XmlTextAttribute bir XML Şema tanımı (XSD) dosyasından sınıf oluştururken oluşturur. Bu, şema karma içerik içeren bir complexType içerdiğinde oluşur; bu durumda, karşılık gelen sınıf, uygulandığı dize dizisini XmlTextAttribute döndüren bir üye içerir. Örneğin, araç bu şemayı işlediğinde Xml Schema Definition :

XML

<xs:schema attributeFormDefault="qualified" elementFormDefault="qualified" targetNamespace=""   
xmlns:xs="http://www.w3.org/2001/XMLSchema">  
  <xs:element name="LinkList" type="LinkList" />  
  <xs:complexType name="LinkList" mixed="true">  
    <xs:sequence>  
      <xs:element minOccurs="1" maxOccurs="1" name="id" type="xs:int" />  
      <xs:element minOccurs="0" maxOccurs="1" name="name" type="xs:string" />  
      <xs:element minOccurs="0" maxOccurs="1" name="next" type="LinkList" />  
    </xs:sequence>  
  </xs:complexType>  
</xs:schema>  

aşağıdaki sınıf oluşturulur (fazladan boşluklar ve açıklamalar kaldırılmıştır):

C#

[System.CodeDom.Compiler.GeneratedCodeAttribute("xsd", "2.0.50727.42")]
[System.SerializableAttribute()]
[System.Diagnostics.DebuggerStepThroughAttribute()]
[System.ComponentModel.DesignerCategoryAttribute("code")]
[System.Xml.Serialization.XmlRootAttribute(Namespace = "", IsNullable = false)]
public partial class LinkList
{

    private int idField;
    private string nameField;
    private LinkList nextField;
    private string[] textField;

    public int id
    {
        get
        {
            return this.idField;
        }
        set
        {
            this.idField = value;
        }
    }

    public string name
    {
        get
        {
            return this.nameField;
        }
        set
        {
            this.nameField = value;
        }
    }

    public LinkList next
    {
        get
        {
            return this.nextField;
        }
        set
        {
            this.nextField = value;
        }
    }

    [System.Xml.Serialization.XmlTextAttribute()]
    public string[] Text
    {
        get
        {
            return this.textField;
        }
        set
        {
            this.textField = value;
        }
    }
}

Öznitelikleri kullanma hakkında daha fazla bilgi için bkz . Öznitelikler.

Not

sözcüğünü XmlText kodunuzda daha uzun XmlTextAttributeyerine kullanabilirsiniz.

Oluşturucular

XmlTextAttribute()	XmlTextAttribute sınıfının yeni bir örneğini başlatır.
XmlTextAttribute(Type)	XmlTextAttribute sınıfının yeni bir örneğini başlatır.

Özellikler

DataType	tarafından XmlSerializeroluşturulan metnin XML Şema tanım dili (XSD) veri türünü alır veya ayarlar.
Type	Üyenin türünü alır veya ayarlar.
TypeId	Türetilmiş bir sınıfta uygulandığında, bu Attributeiçin benzersiz bir tanımlayıcı alır. (Devralındığı yer: Attribute)

Yöntemler

Equals(Object)	Bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değeri döndürür. (Devralındığı yer: Attribute)
GetHashCode()	Bu örneğe ilişkin karma kodu döndürür. (Devralındığı yer: Attribute)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
IsDefaultAttribute()	Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin değerinin türetilmiş sınıf için varsayılan değer olup olmadığını gösterir. (Devralındığı yer: Attribute)
Match(Object)	Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin belirtilen bir nesneye eşit olup olmadığını belirten bir değer döndürür. (Devralındığı yer: Attribute)
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)

Şunlara uygulanır

Ayrıca bkz.

• XmlAttributeOverrides
• XmlAttributes
• XmlSerializer
• XmlText
• 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)