XML Elements for XMLImporter

XML Elements

The following base elements are recognized by XmlImporter Class:

Element Parent Children Description
<XnaContent> <Asset> Top-level tag for XNA Content.
<Asset> <XnaContent> <Item> Marks the asset. The Type attribute specifies the corresponding namespace and class of the matching data type.
<Item> <Asset> When the asset contains multiple objects (as in an array), marks a single object within the group. The child elements correspond to the properties of the data type's class definition.

Examples

Example 1: Single Object

This example demonstrates an XML file that defines an asset that consists of a single item (not an array).

Assume that the XML file is to define a single object of data for the class that is defined as:

namespace XMLTest
{
    class MyTest
    {
        public int elf;
        public string hello;
    }
}
        

The XML file that specifies the data that the Content Loader will read into the object would appear as:

<?xml version="1.0" encoding="utf-8"?>
<XnaContent>
  <Asset Type="XMLTest.MyTest">
    <elf>23</elf>
    <hello>Hello World</hello>
  </Asset>
</XnaContent>
      

Example 2: Multiple Objects

This example demonstrates an XML file that defines an asset that is an array of objects.

Assume that the XML file is to define an array of data for the class that is defined as:

namespace MyDataTypes
{
    public class CatData
    {
        public string Name;
        public float Weight;
        public int Lives;
    }
}

The XML file that specifies the data that the Content Loader will read into the object array would appear as:

<?xml version="1.0" encoding="utf-8"?>
<XnaContent>
  <Asset Type="MyDataTypes.CatData[]">
    <Item>
      <Name>Rhys</Name>
      <Weight>17</Weight>
      <Lives>9</Lives>
    </Item>
    <Item>
      <Name>Boo</Name>
      <Weight>11</Weight>
      <Lives>5</Lives>
    </Item>
  </Asset>
</XnaContent>
      

See Also

Using an XML File to Specify Content
Adding Content to a Game