XmlAttributeEventHandler デリゲート

[アーティクル]
03/28/2008

UnknownAttribute イベントを処理するメソッドを表します。

<Serializable>
Public Delegate Sub XmlAttributeEventHandler( _   ByVal sender As Object, _   ByVal e As XmlAttributeEventArgs _)
[C#]
[Serializable]
public delegate void XmlAttributeEventHandler(   object sender,   XmlAttributeEventArgs e);
[C++]
[Serializable]
public __gc __delegate void XmlAttributeEventHandler(   Object* sender,   XmlAttributeEventArgs* e);

[JScript] JScript では、.NET Framework のデリゲートを利用することができます。ただし、独自に定義することはできません。

パラメータ [Visual Basic, C#, C++]

作成するイベントハンドラは、XmlAttributeEventHandler クラスのデリゲート定義と同一のパラメータを持つ必要があります。

sender
イベントのソース。
e
イベントデータを格納している XmlAttributeEventArgs 。

解説

XmlAttributeEventHandler デリゲートを作成する場合は、イベントを処理するメソッドを識別してください。イベントをイベントハンドラに関連付けるには、デリゲートのインスタンスをイベントに追加します。デリゲートを削除しない限り、そのイベントが発生すると常にイベントハンドラが呼び出されます。イベントハンドラデリゲートの詳細については、「イベントとデリゲート」を参照してください。

Deserialize メソッドでオブジェクトを逆シリアル化する場合に限り、 UnknownAttribute イベントが発生します。

使用例

[Visual Basic, C#, C++] UnknownAttributes.xml という名前のファイルから Group という名前のクラスを逆シリアル化する例を次に示します。クラス内に対応するメンバを持たないファイル内で要素が見つかると、必ず UnknownAttribute イベントが発生します。この例を試行するには、次の XML コードを UnknownAttributes.xml という名前のファイルに貼り付けます。

 
Imports System
Imports System.IO
Imports System.Xml.Serialization
Imports System.Xml
Imports System.Xml.Schema
Imports Microsoft.VisualBasic

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

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

[C++] 
#using <mscorlib.dll>
#using <System.Xml.dll>
#using <System.dll>
using namespace System;
using namespace System::IO;
using namespace System::Xml::Serialization;
using namespace System::Xml;
using namespace System::Xml::Schema;

public __gc class Group{
public:
   String* GroupName;
};

public __gc class Test{
public:
   static void main(){
      Test* t = new Test();
      // Deserialize the file containing unknown elements.
      t->DeserializeObject(S"UnknownAttributes.xml");
   }
private:
   void Serializer_UnknownAttribute(Object* sender, XmlAttributeEventArgs* e){
      Console::WriteLine(S"Unknown Attribute");
      Console::WriteLine(S"\t{0} {1}", e->Attr->Name, e->Attr->InnerXml);
      Console::WriteLine(S"\t LineNumber: {0}", __box(e->LineNumber));
      Console::WriteLine(S"\t LinePosition: {0}", __box(e->LinePosition));

      Group* x  = dynamic_cast<Group*> (e->ObjectBeingDeserialized);
      Console::WriteLine (x->GroupName);
      Console::WriteLine (sender);
   }
private:
   void DeserializeObject(String* filename){
      XmlSerializer* ser = new XmlSerializer(__typeof(Group));
      // Add a delegate to handle unknown element events.
      ser->UnknownAttribute+=new XmlAttributeEventHandler(this, &Test::Serializer_UnknownAttribute);
      // A FileStream is needed to read the XML document.
      FileStream* fs = new FileStream(filename, FileMode::Open);
      Group* g = dynamic_cast<Group*> (ser->Deserialize(fs));
      fs->Close();
   }
};

int main()
{
   Test::main();
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタボタンをクリックします。

必要条件

名前空間: System.Xml.Serialization

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

アセンブリ: System.Xml (System.Xml.dll 内)

参照

System.Xml.Serialization 名前空間 | XmlNodeEventHandler | Deserialize | XmlSerializer

次の方法で共有

XmlAttributeEventHandler デリゲート

パラメータ [Visual Basic, C#, C++]

解説

使用例

必要条件

参照

その他のリソース