XmlNodeEventHandler デリゲート

.NET Framework クラス ライブラリ リファレンス

XmlNodeEventHandler デリゲート

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

名前空間: System.Xml.Serialization
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Delegate Sub XmlNodeEventHandler
 ( _
    sender As Object, _
    e As XmlNodeEventArgs _
)

Visual Basic (使用法)

Dim instance As New XmlNodeEventHandler(AddressOf
 HandlerMethod)

C#

public delegate void XmlNodeEventHandler (
    Object sender,
    XmlNodeEventArgs e
)

C++

public delegate void XmlNodeEventHandler (
    Object^ sender, 
    XmlNodeEventArgs^ e
)

J#

/** @delegate */
public delegate void XmlNodeEventHandler (
    Object sender, 
    XmlNodeEventArgs e
)

JScript

JScript では、デリゲートは使用できますが、新規に宣言することはできません。

パラメータ

sender

イベントのソース。

e

イベント データを格納している XmlNodeEventArgs。

解説

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

UnknownNode イベントは、Deserialize メソッドを呼び出すときにだけ、発生します。

使用例

XmlSerializer を作成し、UnknownNode イベントにイベント ハンドラを追加し、オブジェクトを逆シリアル化する例を次に示します。

Visual Basic

Private Sub DeserializeItem(ByVal
 filename As String)
    Dim mySerializer As New
 XmlSerializer(GetType(ObjectToDeserialize))
    ' Add an instance of the delegate to the event.
    AddHandler mySerializer.UnknownNode, AddressOf
 Serializer_UnknownNode
    ' A FileStream is needed to read the file to deserialize.
    Dim fs As New FileStream(filename,
 FileMode.Open)
    Dim o As ObjectToDeserialize = _
        CType(mySerializer.Deserialize(fs), ObjectToDeserialize)
End Sub 'DeserializeItem


Private Sub Serializer_UnknownNode _
                (ByVal sender As Object,
 _
                 ByVal e As XmlNodeEventArgs)
    
    Console.WriteLine("UnknownNode Name: " & e.Name)
    Console.WriteLine("UnknownNode LocalName: " &
 e.LocalName)
    Console.WriteLine("UnknownNode Namespace URI: "
 & e.NamespaceURI)
    Console.WriteLine("UnknownNode Text: " & e.Text)
    
    Dim o As Object = e.ObjectBeingDeserialized
    Console.WriteLine("Object being deserialized "
 & o.ToString())
    
    Dim myNodeType As XmlNodeType = e.NodeType
    Console.WriteLine(myNodeType)
End Sub

C#

private void DeserializeItem(string
 filename) {
    XmlSerializer mySerializer = 
        new XmlSerializer(typeof(ObjectToDeserialize));
    // Add an instance of the delegate to the event.
    mySerializer.UnknownNode += new XmlNodeEventHandler
        (Serializer_UnknownNode);
    // A FileStream is needed to read the file to deserialize.
    FileStream fs = new FileStream(filename, FileMode.Open);
    ObjectToDeserialize o = (ObjectToDeserialize)mySerializer.Deserialize(fs);
}
 
private void Serializer_UnknownNode
    (object sender, XmlNodeEventArgs e) {
    
    Console.WriteLine("UnknownNode Name: "
                      + e.Name);
    Console.WriteLine("UnknownNode LocalName: "
                      + e.LocalName);
    Console.WriteLine("UnknownNode Namespace URI: "
                      + e.NamespaceURI);
    Console.WriteLine("UnknownNode Text: "
                      + e.Text);
 
    object o = e.ObjectBeingDeserialized;
    Console.WriteLine("Object being deserialized " 
                      + o.ToString());
       
    XmlNodeType myNodeType = e.NodeType;
    Console.WriteLine(myNodeType);
}

C++

private:
   void DeserializeItem( String^ filename )
   {
      XmlSerializer^ mySerializer = gcnew XmlSerializer( ObjectToDeserialize::typeid
 );

      // Add an instance of the delegate to the event.
      mySerializer->UnknownNode += gcnew XmlNodeEventHandler( this,
 &Class1::Serializer_UnknownNode );

      // A FileStream is needed to read the file to deserialize.
      FileStream^ fs = gcnew FileStream( filename,FileMode::Open );
      ObjectToDeserialize^ o = dynamic_cast<ObjectToDeserialize^>(mySerializer->Deserialize(
 fs ));
   }

   void Serializer_UnknownNode( Object^ sender, XmlNodeEventArgs^
 e )
   {
      Console::WriteLine( "UnknownNode Name: {0}", e->Name );
      Console::WriteLine( "UnknownNode LocalName: {0}", e->LocalName
 );
      Console::WriteLine( "UnknownNode Namespace URI: {0}", e->NamespaceURI
 );
      Console::WriteLine( "UnknownNode Text: {0}", e->Text );
      Object^ o = e->ObjectBeingDeserialized;
      Console::WriteLine( "Object being deserialized {0}", o );
      XmlNodeType myNodeType = e->NodeType;
      Console::WriteLine( myNodeType );
   }

J#

private void DeserializeItem(String fileName)
{
    XmlSerializer mySerializer =
        new XmlSerializer(ObjectToDeserialize.class.ToType());

    // Add an instance of the delegate to the event.
    mySerializer.add_UnknownNode(
        new XmlNodeEventHandler(Serializer_UnknownNode));

    // A FileStream is needed to read the file to deserialize.
    FileStream fs = new FileStream(fileName, FileMode.Open);
    ObjectToDeserialize o =
        (ObjectToDeserialize)mySerializer.Deserialize(fs);
} //DeserializeItem

protected void Serializer_UnknownNode(Object
 sender, XmlNodeEventArgs e)
{
    Console.WriteLine("UnknownNode Name: " + e.get_Name());
    Console.WriteLine("UnknownNode LocalName: " + e.get_LocalName());
    Console.WriteLine("UnknownNode Namespace URI: " + e.get_NamespaceURI());
    Console.WriteLine("UnknownNode Text: " + e.get_Text());

    Object o = e.get_ObjectBeingDeserialized();
    Console.WriteLine("Object being deserialized " + o.ToString());

    XmlNodeType myNodeType = e.get_NodeType();
    Console.WriteLine(myNodeType);
} //Serializer_UnknownNode

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
System.Xml.Serialization 名前空間
Deserialize
XmlSerializer