XmlAttributeEventArgs Klasse

Definition

Namespace:

System.Xml.Serialization

Assembly:

System.Xml.dll

Stellt Daten für das UnknownAttribute-Ereignis bereit.

public ref class XmlAttributeEventArgs : EventArgs

public class XmlAttributeEventArgs : EventArgs

type XmlAttributeEventArgs = class
    inherit EventArgs

Public Class XmlAttributeEventArgs
Inherits EventArgs

Vererbung

Object

EventArgs

XmlAttributeEventArgs

Beispiele

Im folgenden Beispiel wird eine Klasse, die aus einer Datei mit dem Namen UnknownAttributes.xmlbenannt Group ist, deserialisiert. Wenn ein Element in der Datei gefunden wird, das kein entsprechendes Element in der Klasse enthält, tritt das UnknownAttribute Ereignis auf. Zum Testen des Beispiels fügen Sie den folgenden XML-Code in eine Datei mit dem Namen UnknownAttributes.xmlein.

<?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" GroupType = 'Technical' GroupNumber = '42' GroupBase = 'Red'>
  <GroupName>MyGroup</GroupName>
</Group>

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

Hinweise

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter "Events Overview".

Das UnknownAttribute Ereignis tritt nur auf, wenn Sie die Deserialize Methode aufrufen.

Eigenschaften

Name	Beschreibung
Attr	Ruft ein Objekt ab, das das unbekannte XML-Attribut darstellt.
ExpectedAttributes	Ruft eine durch Trennzeichen getrennte Liste der XML-Attributnamen ab, die in einer XML-Dokumentinstanz erwartet werden.
LineNumber	Ruft die Zeilennummer des unbekannten XML-Attributs ab.
LinePosition	Ruft die Position in der Zeile des unbekannten XML-Attributs ab.
ObjectBeingDeserialized	Ruft das Objekt ab, das deserialisiert wird.

Methoden

Name	Beschreibung
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• XmlAttributeEventHandler