XmlArrayAttribute Constructors

Definition

Initializes a new instance of the XmlArrayAttribute class.

Overloads

XmlArrayAttribute()

Initializes a new instance of the XmlArrayAttribute class.

XmlArrayAttribute(String)

Initializes a new instance of the XmlArrayAttribute class and specifies the XML element name generated in the XML document instance.

XmlArrayAttribute()

Source:
XmlArrayAttribute.cs
Source:
XmlArrayAttribute.cs
Source:
XmlArrayAttribute.cs

Initializes a new instance of the XmlArrayAttribute class.

C#
public XmlArrayAttribute();

Examples

The following example assigns the XmlArrayAttribute to two arrays.

C#
public class MyClass
{
    [XmlArrayAttribute()]
    public string [] MyStringArray;
    [XmlArrayAttribute()]
    public int [] MyIntegerArray;
}

Remarks

For more information about using attributes, see Attributes.

See also

Applies to

.NET 10 and other versions
Product Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0

XmlArrayAttribute(String)

Source:
XmlArrayAttribute.cs
Source:
XmlArrayAttribute.cs
Source:
XmlArrayAttribute.cs

Initializes a new instance of the XmlArrayAttribute class and specifies the XML element name generated in the XML document instance.

C#
public XmlArrayAttribute(string elementName);
C#
public XmlArrayAttribute(string? elementName);

Parameters

elementName
String

The name of the XML element that the XmlSerializer generates.

Examples

The following example assigns the XmlArrayAttribute to two arrays, and serializes a class instance that contains those arrays.

C#
using System;
using System.IO;
using System.Xml;
using System.Xml.Serialization;

public class MyClass{
   [XmlArrayAttribute("MyStrings")]
   public string [] MyStringArray;
   [XmlArrayAttribute(ElementName = "MyIntegers")]
   public int [] MyIntegerArray;
}

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

   public void SerializeObject(string filename)
   {
      // Creates a new instance of the XmlSerializer class.
      XmlSerializer s = new XmlSerializer(typeof(MyClass));
      // Needs a StreamWriter to write the file.
      TextWriter myWriter= new StreamWriter(filename);

      MyClass myClass = new MyClass();
      // Creates and populates a string array, then assigns
      // it to the MyStringArray property.
      string [] myStrings = {"Hello", "World", "!"};
      myClass.MyStringArray = myStrings;
      /* Creates and populates an integer array, and assigns
      it to the MyIntegerArray property. */
      int [] myIntegers = {1,2,3};
      myClass.MyIntegerArray = myIntegers;
      // Serializes the class, and writes it to disk.
      s.Serialize(myWriter, myClass);
      myWriter.Close();
   }
}
XML

<?xml version="1.0"?>
 <MyClass1 xmlns:xsi="http://www.w3.org/1999/XMLSchema-instance" xmlns:xsd="http://www.w3.org/1999/XMLSchema">
   <MyStrings>
     <string>Hello</string>
     <string>World</string>
     <string>!</string>
   </MyStrings>
   <MyIntegers>
     <int>1</int>
     <int>2</int>
     <int>3</int>
   </MyIntegers>
 </MyClass1>

Remarks

For more information about using attributes, see Attributes.

See also

Applies to

.NET 10 and other versions
Product Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0