閱讀英文版本

分享方式：

XmlElementEventHandler 代理人

  • 參考

定義

命名空間:
System.Xml.Serialization
組件:
netstandard.dll, System.Xml.XmlSerializer.dll
組件:
System.Xml.XmlSerializer.dll
組件:
System.Xml.dll
組件:
netstandard.dll

表示處理 UnknownElement 的 XmlSerializer 事件的方法。

C# 
public delegate void XmlElementEventHandler(object? sender, XmlElementEventArgs e);
C# 
public delegate void XmlElementEventHandler(object sender, XmlElementEventArgs e);

參數

sender
Object

事件的來源。

e
XmlElementEventArgs

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

備註

當您建立 XmlElementEventHandler 委派時，您會識別處理事件的方法。 若要使事件與您的事件處理常式產生關聯，請將委派的執行個體 (Instance) 加入至事件。 除非您移除委派，否則每當事件發生時就會呼叫事件處理常式。 如需事件處理常式委派的詳細資訊，請參閱 處理和引發事件。

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

擴充方法

GetMethodInfo(Delegate)

取得表示特定委派所代表之方法的物件。

適用於

產品 版本
.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