XmlSerializer.UnknownAttribute Gebeurtenis

Definitie

Naamruimte:

System.Xml.Serialization

Assembly's:

netstandard.dll, System.Xml.XmlSerializer.dll

Bron:

XmlSerializer.cs

Treedt op wanneer er XmlSerializer een XML-kenmerk van onbekend type optreedt tijdens deserialisatie.

public:
 event System::Xml::Serialization::XmlAttributeEventHandler ^ UnknownAttribute;

public event System.Xml.Serialization.XmlAttributeEventHandler UnknownAttribute;

member this.UnknownAttribute : System.Xml.Serialization.XmlAttributeEventHandler 

Public Custom Event UnknownAttribute As XmlAttributeEventHandler 

Gebeurtenistype

XmlAttributeEventHandler

Voorbeelden

In het volgende voorbeeld wordt informatie afgedrukt over onbekende kenmerken die zijn aangetroffen tijdens het deseriialiseren van een XML-document.

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("UnknownAttributes.xml");
   }
   private void Serializer_UnknownAttribute(object sender, XmlAttributeEventArgs e){
      Console.WriteLine("Unknown Attribute");
      Console.WriteLine("\t" + e.Attr.Name + " " + e.Attr.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.UnknownAttribute+=new XmlAttributeEventHandler(Serializer_UnknownAttribute);
      // A FileStream is needed to read the XML document.
     FileStream fs = new FileStream(filename, FileMode.Open);
     Group g = (Group) ser.Deserialize(fs);
     fs.Close();
    }
}

Imports System.IO
Imports System.Xml.Serialization
Imports System.Xml
Imports System.Xml.Schema

Public Class Group
   Public GroupName As String 
End Class

Public Class Test
   Shared Sub Main()
      Dim t As Test = new Test()
      ' Deserialize the file containing unknown elements.
      t.DeserializeObject("UnknownAttributes.xml")
   End Sub

   Private Sub Serializer_UnknownAttribute _
   (sender As Object , e As XmlAttributeEventArgs)
      Console.WriteLine("Unknown Attribute")
      Console.WriteLine(ControlChars.Tab & e.Attr.Name + " " & e.Attr.InnerXml)
      Console.WriteLine(ControlChars.Tab & e.LineNumber & ":"  & e.LineNumber)
      Console.WriteLine(ControlChars.Tab & e.LinePosition & ":"   & e.LinePosition)
      
      Dim x As Group = CType( e.ObjectBeingDeserialized, Group)
      Console.WriteLine (x.GroupName)
      Console.WriteLine (sender.ToString())
   End Sub
   
   Private Sub DeserializeObject(filename As String)
      Dim ser As XmlSerializer = new XmlSerializer(GetType(Group))
      ' Add a delegate to handle unknown element events.
      AddHandler ser.UnknownAttribute, _
      AddressOf Serializer_UnknownAttribute 
      ' A FileStream is needed to read the XML document.
     Dim fs As FileStream  = new FileStream(filename, FileMode.Open)
     Dim g  As Group = CType(ser.Deserialize(fs),Group)
     fs.Close()
   End Sub
End Class

Opmerkingen

Na het aanroepen van de Deserialize methode XmlSerializer worden standaard XML-kenmerken van onbekende typen genegeerd. U kunt deze gebeurtenis echter gebruiken om dergelijke knooppunttypen af te handelen.

Als het exemplaar van de klasse die wordt gedeserialiseerd een veld bevat dat een matrix met XmlAttribute objecten retourneert en een XmlAnyAttributeAttribute is toegepast op het veld, treedt de UnknownAttribute gebeurtenis niet op. In plaats daarvan worden alle onbekende XML-kenmerken verzameld in de matrix.

Zie ook

• XmlAnyAttributeAttribute
• CanDeserialize(XmlReader)
• Deserialize(Stream)
• UnknownNode
• XmlAttributes
• Inleiding tot XML-serialisatie
• Procedure: Geef een alternatieve elementnaam op voor een XML-stream
• XML-serialisatie beheren met behulp van kenmerken
• Voorbeelden van XML-serialisatie
• Xml Schema Definition Tool (Xsd.exe)