XmlElementEventArgs 類別

定義

提供 UnknownElement 事件的資料。

C#
public class XmlElementEventArgs : EventArgs
繼承
XmlElementEventArgs

範例

下列範例會從名為 UnknownElements.xml 的檔案還原序列化名為 Group 的類別。 每當在類別中沒有對應成員的檔案中找到專案時,就會 UnknownElement 發生此事件。 若要嘗試此範例,請將下列 XML 程式碼貼到名為 UnknownElements.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">  
  <GroupName>MyGroup</GroupName>  
  <GroupSize>Large</GroupSize>  
  <GroupNumber>444</GroupNumber>  
  <GroupBase>West</GroupBase>  
</Group>  
C#
using System;
using System.IO;
using System.Xml.Serialization;
using System.Xml;
using System.Xml.Schema;

public class Group{
   public string GroupName;
}

public class Test{
   static void Main(){
      Test t = new Test();
      // Deserialize the file containing unknown elements.
      t.DeserializeObject("UnknownElements.xml");
   }
   private void Serializer_UnknownElement(object sender, XmlElementEventArgs e){
      Console.WriteLine("Unknown Element");
      Console.WriteLine("\t" + e.Element.Name + " " + e.Element.InnerXml);
      Console.WriteLine("\t LineNumber: " + e.LineNumber);
      Console.WriteLine("\t LinePosition: " + e.LinePosition);
      
      Group x  = (Group) e.ObjectBeingDeserialized;
      Console.WriteLine (x.GroupName);
      Console.WriteLine (sender.ToString());
   }
   private void DeserializeObject(string filename){
      XmlSerializer ser = new XmlSerializer(typeof(Group));
      // Add a delegate to handle unknown element events.
      ser.UnknownElement+=new XmlElementEventHandler(Serializer_UnknownElement);
      // A FileStream is needed to read the XML document.
     FileStream fs = new FileStream(filename, FileMode.Open);
     Group g = (Group) ser.Deserialize(fs);
     fs.Close();
    }
}

備註

如需處理事件的詳細資訊,請參閱 處理和引發事件處理和引發事件

只有在 UnknownElement 您呼叫 方法時, Deserialize 才會發生此事件。

屬性

Element

取得表示未知 XML 項目的物件。

ExpectedElements

取得應該在 XML 文件執行個體中之 XML 項目名稱的逗號分隔清單。

LineNumber

如果 XML 讀取器 (Reader) 是 XmlTextReader,取得遇到未知項目的行號。

LinePosition

如果 XML 讀取器是 XmlTextReader,取得未知項目在行中發生的位置。

ObjectBeingDeserialized

取得 XmlSerializer 所還原序列化的物件。

方法

Equals(Object)

判斷指定的物件是否等於目前的物件。

(繼承來源 Object)
GetHashCode()

做為預設雜湊函式。

(繼承來源 Object)
GetType()

取得目前執行個體的 Type

(繼承來源 Object)
MemberwiseClone()

建立目前 Object 的淺層複製。

(繼承來源 Object)
ToString()

傳回代表目前物件的字串。

(繼承來源 Object)

適用於

產品 版本
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1