XmlElementAttribute コンストラクター

定義

名前空間:: System.Xml.Serialization

アセンブリ:: System.Xml.dll, System.Xml.XmlSerializer.dll

アセンブリ:: netstandard.dll, System.Xml.ReaderWriter.dll

アセンブリ:: System.Xml.XmlSerializer.dll

アセンブリ:: System.Xml.ReaderWriter.dll

アセンブリ:: System.Xml.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

XmlElementAttribute クラスの新しいインスタンスを初期化します。

オーバーロード

名前	説明
XmlElementAttribute()	XmlElementAttribute クラスの新しいインスタンスを初期化します。
XmlElementAttribute(String)	XmlElementAttribute クラスの新しいインスタンスを初期化し、XML 要素の名前を指定します。
XmlElementAttribute(Type)	XmlElementAttribute クラスの新しいインスタンスを初期化し、XmlElementAttributeが適用されるメンバーの型を指定します。この型は、それを含むオブジェクトをシリアル化または逆シリアル化するときに、 XmlSerializer によって使用されます。
XmlElementAttribute(String, Type)	XmlElementAttributeの新しいインスタンスを初期化し、XML 要素の名前と、XmlElementAttributeが適用されるメンバーの派生型を指定します。このメンバー型は、 XmlSerializer がそれを含むオブジェクトをシリアル化するときに使用されます。

XmlElementAttribute()

ソース:: XmlElementAttribute.cs

ソース:: XmlElementAttribute.cs

ソース:: XmlElementAttribute.cs

ソース:: XmlElementAttribute.cs

ソース:: XmlElementAttribute.cs

XmlElementAttribute クラスの新しいインスタンスを初期化します。

public:
 XmlElementAttribute();

public XmlElementAttribute();

Public Sub New ()

例

次の例では、クラスに XmlElementAttribute を適用します。

public class MyClass
{
   [XmlElement()]
   public string TeacherName;
}

Public Class MyClass1
    <XmlElement()> Public TeacherName As String
End Class

適用対象

XmlElementAttribute(String)

ソース:: XmlElementAttribute.cs

ソース:: XmlElementAttribute.cs

ソース:: XmlElementAttribute.cs

ソース:: XmlElementAttribute.cs

ソース:: XmlElementAttribute.cs

XmlElementAttribute クラスの新しいインスタンスを初期化し、XML 要素の名前を指定します。

public:
 XmlElementAttribute(System::String ^ elementName);

public XmlElementAttribute(string elementName);

public XmlElementAttribute(string? elementName);

new System.Xml.Serialization.XmlElementAttribute : string -> System.Xml.Serialization.XmlElementAttribute

Public Sub New (elementName As String)

パラメーター

elementName: String

シリアル化されたメンバーの XML 要素名。

例

次の例は、 Vehiclesという名前の 1 つのフィールドを含む単純なクラスを示しています。この例では、フィールドに XmlElementAttribute を適用し、 elementName パラメーターを含めます。これにより、"Vehicles" ではなく "Cars" という名前の XML 要素を生成するように XmlSerializer に指示します。

public class Transportation
{
   [XmlElement("Cars")]
   public string Vehicles;
}

Public Class Transportation
    <XmlElement("Cars")> Public Vehicles As String
End Class

注釈

既定では、 XmlSerializer は、クラスインスタンスをシリアル化するときに、メンバー名を XML 要素名として使用します。たとえば、 Vehicle という名前のフィールドは、 Vehicleという名前の XML 要素を生成します。ただし、 Carsなどの別の要素が必要な場合は、 elementName パラメーターで渡します。

適用対象

XmlElementAttribute(Type)

ソース:: XmlElementAttribute.cs

ソース:: XmlElementAttribute.cs

ソース:: XmlElementAttribute.cs

ソース:: XmlElementAttribute.cs

ソース:: XmlElementAttribute.cs

XmlElementAttribute クラスの新しいインスタンスを初期化し、XmlElementAttributeが適用されるメンバーの型を指定します。この型は、それを含むオブジェクトをシリアル化または逆シリアル化するときに、 XmlSerializer によって使用されます。

public:
 XmlElementAttribute(Type ^ type);

public XmlElementAttribute(Type type);

public XmlElementAttribute(Type? type);

new System.Xml.Serialization.XmlElementAttribute : Type -> System.Xml.Serialization.XmlElementAttribute

Public Sub New (type As Type)

パラメーター

type: Type

メンバーの型から派生したオブジェクトの Type 。

例

次の例では、Instruments という名前の 1 つのフィールドを含む Orchestra という名前のクラスをシリアル化し、Instrument オブジェクトの配列を返します。 Brassという名前の 2 番目のクラスは、Instrument クラスから継承されます。この例では、Instruments フィールドにXmlElementAttributeを適用し、Brass型を指定して、Instruments フィールドがBrassオブジェクトを受け入れるようにします。この例では、 ElementName プロパティを設定して XML 要素の名前も指定します。

using System;
using System.IO;
using System.Xml.Serialization;

public class Orchestra
{
   public Instrument[] Instruments;
}

public class Instrument
{
   public string Name;
}

public class Brass:Instrument{
   public bool IsValved;
}

public class Run
{
    public static void Main()
    {
       Run test = new Run();
       test.SerializeObject("Override.xml");
       test.DeserializeObject("Override.xml");
    }

    public void SerializeObject(string filename)
    {
      // To write the file, a TextWriter is required.
      TextWriter writer = new StreamWriter(filename);

      XmlAttributeOverrides attrOverrides =
         new XmlAttributeOverrides();
      XmlAttributes attrs = new XmlAttributes();

      // Creates an XmlElementAttribute that overrides the Instrument type.
      XmlElementAttribute attr = new
      XmlElementAttribute(typeof(Brass));
      attr.ElementName = "Brass";

      // Adds the element to the collection of elements.
      attrs.XmlElements.Add(attr);
      attrOverrides.Add(typeof(Orchestra), "Instruments", attrs);

      // Creates the XmlSerializer using the XmlAttributeOverrides.
      XmlSerializer s =
      new XmlSerializer(typeof(Orchestra), attrOverrides);

      // Creates the object to serialize.
      Orchestra band = new Orchestra();

      // Creates an object of the derived type.
      Brass i = new Brass();
      i.Name = "Trumpet";
      i.IsValved = true;
      Instrument[] myInstruments = {i};
      band.Instruments = myInstruments;
      s.Serialize(writer,band);
      writer.Close();
   }

   public void DeserializeObject(string filename)
   {
      XmlAttributeOverrides attrOverrides =
         new XmlAttributeOverrides();
      XmlAttributes attrs = new XmlAttributes();

      // Creates an XmlElementAttribute that override the Instrument type.
      XmlElementAttribute attr = new
      XmlElementAttribute(typeof(Brass));
      attr.ElementName = "Brass";

      // Adds the element to the collection of elements.
      attrs.XmlElements.Add(attr);
      attrOverrides.Add(typeof(Orchestra), "Instruments", attrs);

      // Creates the XmlSerializer using the XmlAttributeOverrides.
      XmlSerializer s =
      new XmlSerializer(typeof(Orchestra), attrOverrides);

      FileStream fs = new FileStream(filename, FileMode.Open);
      Orchestra band = (Orchestra) s.Deserialize(fs);
      Console.WriteLine("Brass:");

      /* Deserializing differs from serializing. To read the
         derived-object values, declare an object of the derived
         type (Brass) and cast the Instrument instance to it. */
      Brass b;
      foreach(Instrument i in band.Instruments)
      {
         b= (Brass)i;
         Console.WriteLine(
         b.Name + "\n" +
         b.IsValved);
      }
   }
}

Option Strict
Option Explicit

Imports System.IO
Imports System.Xml.Serialization

Public Class Orchestra
    Public Instruments() As Instrument
End Class

Public Class Instrument
    Public Name As String
End Class

Public Class Brass
    Inherits Instrument
    Public IsValved As Boolean
End Class

Public Class Run
    
    Public Shared Sub Main()
        Dim test As New Run()
        test.SerializeObject("Override.xml")
        test.DeserializeObject("Override.xml")
    End Sub
    
    
    Public Sub SerializeObject(filename As String)
        ' To write the file, a TextWriter is required.
        Dim writer As New StreamWriter(filename)
        
        Dim attrOverrides As New XmlAttributeOverrides()
        Dim attrs As New XmlAttributes()
        
        ' Creates an XmlElementAttribute that overrides the Instrument type.
        Dim attr As New XmlElementAttribute(GetType(Brass))
        attr.ElementName = "Brass"
        
        ' Adds the element to the collection of elements.
        attrs.XmlElements.Add(attr)
        attrOverrides.Add(GetType(Orchestra), "Instruments", attrs)
        
        ' Creates the XmlSerializer using the XmlAttributeOverrides.
        Dim s As New XmlSerializer(GetType(Orchestra), attrOverrides)
        
        ' Creates the object to serialize.
        Dim band As New Orchestra()
        
        ' Creates an object of the derived type.
        Dim i As New Brass()
        i.Name = "Trumpet"
        i.IsValved = True
        Dim myInstruments() As Instrument = {i}
        band.Instruments = myInstruments
        s.Serialize(writer, band)
        writer.Close()
    End Sub
    
    
    Public Sub DeserializeObject(filename As String)
        Dim attrOverrides As New XmlAttributeOverrides()
        Dim attrs As New XmlAttributes()
        
        ' Create an XmlElementAttribute that override the Instrument type.
        Dim attr As New XmlElementAttribute(GetType(Brass))
        attr.ElementName = "Brass"
        
        ' Add the element to the collection of elements.
        attrs.XmlElements.Add(attr)
        attrOverrides.Add(GetType(Orchestra), "Instruments", attrs)
        
        ' Create the XmlSerializer using the XmlAttributeOverrides.
        Dim s As New XmlSerializer(GetType(Orchestra), attrOverrides)
        
        Dim fs As New FileStream(filename, FileMode.Open)
        Dim band As Orchestra = CType(s.Deserialize(fs), Orchestra)
        Console.WriteLine("Brass:")
        
        ' Deserializing differs from serializing. To read the
        ' derived-object values, declare an object of the derived
        ' type (Brass) and cast the Instrument instance to it. 
        Dim b As Brass
        Dim i As Instrument
        For Each i In  band.Instruments
            b = CType(i, Brass)
            Console.WriteLine((b.Name + ControlChars.Cr + b.IsValved.ToString()))
        Next i
    End Sub
End Class

注釈

基底クラスから派生した型を指定するには、 type パラメーターを使用します。たとえば、 MyAnimal という名前のプロパティが Animal オブジェクトを返したとします。オブジェクトを拡張して、Animal クラスから継承する Mammal という名前の新しいクラスを作成します。 MyAnimal プロパティをシリアル化するときにMammal クラスを受け入れるようにXmlSerializerに指示するには、Mammal クラスのTypeをコンストラクターに渡します。

適用対象

XmlElementAttribute(String, Type)

ソース:: XmlElementAttribute.cs

ソース:: XmlElementAttribute.cs

ソース:: XmlElementAttribute.cs

ソース:: XmlElementAttribute.cs

ソース:: XmlElementAttribute.cs

XmlElementAttributeの新しいインスタンスを初期化し、XML 要素の名前と、XmlElementAttributeが適用されるメンバーの派生型を指定します。このメンバー型は、 XmlSerializer がそれを含むオブジェクトをシリアル化するときに使用されます。

public:
 XmlElementAttribute(System::String ^ elementName, Type ^ type);

public XmlElementAttribute(string elementName, Type type);

public XmlElementAttribute(string? elementName, Type? type);

new System.Xml.Serialization.XmlElementAttribute : string * Type -> System.Xml.Serialization.XmlElementAttribute

Public Sub New (elementName As String, type As Type)

パラメーター

elementName: String

シリアル化されたメンバーの XML 要素名。

type: Type

メンバーの型から派生したオブジェクトの Type 。

例

using System;
using System.IO;
using System.Xml.Serialization;

public class Orchestra
{
   public Instrument[] Instruments;
}

public class Instrument
{
   public string Name;
}

public class Brass:Instrument{
   public bool IsValved;
}

public class Run
{
    public static void Main()
    {
       Run test = new Run();
       test.SerializeObject("Override.xml");
       test.DeserializeObject("Override.xml");
    }

    public void SerializeObject(string filename)
    {
      // To write the file, a TextWriter is required.
      TextWriter writer = new StreamWriter(filename);

      XmlAttributeOverrides attrOverrides =
         new XmlAttributeOverrides();
      XmlAttributes attrs = new XmlAttributes();

      // Creates an XmlElementAttribute that overrides the Instrument type.
      XmlElementAttribute attr = new
      XmlElementAttribute(typeof(Brass));
      attr.ElementName = "Brass";

      // Adds the element to the collection of elements.
      attrs.XmlElements.Add(attr);
      attrOverrides.Add(typeof(Orchestra), "Instruments", attrs);

      // Creates the XmlSerializer using the XmlAttributeOverrides.
      XmlSerializer s =
      new XmlSerializer(typeof(Orchestra), attrOverrides);

      // Creates the object to serialize.
      Orchestra band = new Orchestra();

      // Creates an object of the derived type.
      Brass i = new Brass();
      i.Name = "Trumpet";
      i.IsValved = true;
      Instrument[] myInstruments = {i};
      band.Instruments = myInstruments;
      s.Serialize(writer,band);
      writer.Close();
   }

   public void DeserializeObject(string filename)
   {
      XmlAttributeOverrides attrOverrides =
         new XmlAttributeOverrides();
      XmlAttributes attrs = new XmlAttributes();

      // Creates an XmlElementAttribute that override the Instrument type.
      XmlElementAttribute attr = new
      XmlElementAttribute(typeof(Brass));
      attr.ElementName = "Brass";

      // Adds the element to the collection of elements.
      attrs.XmlElements.Add(attr);
      attrOverrides.Add(typeof(Orchestra), "Instruments", attrs);

      // Creates the XmlSerializer using the XmlAttributeOverrides.
      XmlSerializer s =
      new XmlSerializer(typeof(Orchestra), attrOverrides);

      FileStream fs = new FileStream(filename, FileMode.Open);
      Orchestra band = (Orchestra) s.Deserialize(fs);
      Console.WriteLine("Brass:");

      /* Deserializing differs from serializing. To read the
         derived-object values, declare an object of the derived
         type (Brass) and cast the Instrument instance to it. */
      Brass b;
      foreach(Instrument i in band.Instruments)
      {
         b= (Brass)i;
         Console.WriteLine(
         b.Name + "\n" +
         b.IsValved);
      }
   }
}

Option Strict
Option Explicit

Imports System.IO
Imports System.Xml.Serialization

Public Class Orchestra
    Public Instruments() As Instrument
End Class

Public Class Instrument
    Public Name As String
End Class

Public Class Brass
    Inherits Instrument
    Public IsValved As Boolean
End Class

Public Class Run
    
    Public Shared Sub Main()
        Dim test As New Run()
        test.SerializeObject("Override.xml")
        test.DeserializeObject("Override.xml")
    End Sub
    
    
    Public Sub SerializeObject(filename As String)
        ' To write the file, a TextWriter is required.
        Dim writer As New StreamWriter(filename)
        
        Dim attrOverrides As New XmlAttributeOverrides()
        Dim attrs As New XmlAttributes()
        
        ' Creates an XmlElementAttribute that overrides the Instrument type.
        Dim attr As New XmlElementAttribute(GetType(Brass))
        attr.ElementName = "Brass"
        
        ' Adds the element to the collection of elements.
        attrs.XmlElements.Add(attr)
        attrOverrides.Add(GetType(Orchestra), "Instruments", attrs)
        
        ' Creates the XmlSerializer using the XmlAttributeOverrides.
        Dim s As New XmlSerializer(GetType(Orchestra), attrOverrides)
        
        ' Creates the object to serialize.
        Dim band As New Orchestra()
        
        ' Creates an object of the derived type.
        Dim i As New Brass()
        i.Name = "Trumpet"
        i.IsValved = True
        Dim myInstruments() As Instrument = {i}
        band.Instruments = myInstruments
        s.Serialize(writer, band)
        writer.Close()
    End Sub
    
    
    Public Sub DeserializeObject(filename As String)
        Dim attrOverrides As New XmlAttributeOverrides()
        Dim attrs As New XmlAttributes()
        
        ' Create an XmlElementAttribute that override the Instrument type.
        Dim attr As New XmlElementAttribute(GetType(Brass))
        attr.ElementName = "Brass"
        
        ' Add the element to the collection of elements.
        attrs.XmlElements.Add(attr)
        attrOverrides.Add(GetType(Orchestra), "Instruments", attrs)
        
        ' Create the XmlSerializer using the XmlAttributeOverrides.
        Dim s As New XmlSerializer(GetType(Orchestra), attrOverrides)
        
        Dim fs As New FileStream(filename, FileMode.Open)
        Dim band As Orchestra = CType(s.Deserialize(fs), Orchestra)
        Console.WriteLine("Brass:")
        
        ' Deserializing differs from serializing. To read the
        ' derived-object values, declare an object of the derived
        ' type (Brass) and cast the Instrument instance to it. 
        Dim b As Brass
        Dim i As Instrument
        For Each i In  band.Instruments
            b = CType(i, Brass)
            Console.WriteLine((b.Name + ControlChars.Cr + b.IsValved.ToString()))
        Next i
    End Sub
End Class

注釈

適用対象

フィードバック

このページはお役に立ちましたか?

次の方法で共有

XmlElementAttribute コンストラクター

定義

オーバーロード

XmlElementAttribute()

例

適用対象

XmlElementAttribute(String)

パラメーター

例

注釈

適用対象

XmlElementAttribute(Type)

パラメーター

例

注釈

適用対象

XmlElementAttribute(String, Type)

パラメーター

例

注釈

適用対象

フィードバック