XmlTextAttribute 類別

定義

命名空間:

System.Xml.Serialization

組件:

System.Xml.XmlSerializer.dll

組件:

System.Xml.ReaderWriter.dll

組件:

System.Xml.dll

組件:

netstandard.dll

表示 XmlSerializer 在序列化或還原序列化包含它的類別之後，應該將成員視為 XML 文字。

C#

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

繼承

Object

Attribute

XmlTextAttribute

屬性

AttributeUsageAttribute

範例

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();
   }
}

備註

XmlTextAttribute屬於一系列屬性，可控制如何 XmlSerializer 透過物件的 Serialize 和 Deserialize 方法 () 序列化和還原序列化物件。 如需類似屬性的完整清單，請參閱 控制 XML 序列化的屬性。

類別中只能套用一個實例 XmlTextAttribute 。

您可以將 套用 XmlTextAttribute 至傳回基本型別和列舉型別的公用欄位和公用讀取/寫入屬性。

您可以將 套用 XmlTextAttribute 至傳回字串陣列的欄位或屬性。 您也可以將 屬性套用至 類型的 Object 陣列，但必須將 屬性設定 Type 為字串。 在此情況下，插入陣列中的任何字串會序列化為 XML 文字。

XmlTextAttribute也可以套用至傳回 XmlNode 或 物件陣列的 XmlNode 欄位。

根據預設，會將 XmlSerializer 類別成員序列化為 XML 專案。 不過，如果您將 套用 XmlTextAttribute 至成員，則會 XmlSerializer 將其值轉譯成 XML 文字。 這表示值會編碼為 XML 專案的內容。

從 XML 架構定義 (XSD) 檔案建立類別時， XML 架構定義工具 (#A) 0 偶爾會產生 XmlTextAttribute 。 當架構包含 complexType 具有混合內容的 時，就會發生這種情況;在此情況下，對應的類別會包含成員，該成員會傳回套用 的 XmlTextAttribute 字串陣列。 例如，當 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>  

下列類別會產生 (額外的空格，而且已移除備註) ：

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;
        }
    }
}

如需使用屬性的詳細資訊，請參閱 屬性。

注意

您可以在程式碼中使用這個字， XmlText 而不是較長 XmlTextAttribute 的 。

建構函式

XmlTextAttribute()	初始化 XmlTextAttribute 類別的新執行個體。
XmlTextAttribute(Type)	初始化 XmlTextAttribute 類別的新執行個體。

屬性

DataType	取得或設定 XmlSerializer 所產生之文字的XML 結構描述定義語言 (XSD) 資料型別。
Type	取得或設定成員的類型。
TypeId	在衍生類別中實作時，取得這個 Attribute 的唯一識別碼。 (繼承來源 Attribute)

方法

Equals(Object)	傳回值，這個值指出此執行個體是否與指定的物件相等。 (繼承來源 Attribute)
GetHashCode()	傳回這個執行個體的雜湊碼。 (繼承來源 Attribute)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IsDefaultAttribute()	在衍生類別中覆寫時，表示這個執行個體的值是衍生類別的預設值。 (繼承來源 Attribute)
Match(Object)	在衍生類別中覆寫時，會傳回值，表示這個執行個體是否等於指定物件。 (繼承來源 Attribute)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

明確介面實作

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	將一組名稱對應至一組對應的分派識別項 (Dispatch Identifier)。 (繼承來源 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	擷取物件的類型資訊，可以用來取得介面的類型資訊。 (繼承來源 Attribute)
_Attribute.GetTypeInfoCount(UInt32)	擷取物件提供的類型資訊介面數目 (0 或 1)。 (繼承來源 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	提供物件所公開的屬性和方法的存取權。 (繼承來源 Attribute)

適用於

另請參閱

• XmlAttributeOverrides
• XmlAttributes
• XmlSerializer
• XmlText
• XML 序列化簡介
• HOW TO：指定 XML 資料流的替代元素名稱
• 使用屬性控制 XML 序列化
• XML 序列化的範例
• XML Schema Definition Tool (Xsd.exe)