Adding an XML Content File to a Visual Studio Project

Describes how to add custom game data as an XML file through the Content Pipeline.

Adding XML files to game content

Custom game data that is expressed in an XML format can be easily integrated into your game through the XNA Game Studio Content Pipeline.

This example demonstrates the procedure for integrating custom XML data into the content project of a simple XNA Game Studio game for the Windows platform.

To define game data

Within the XNA Game Studio solution,you create a new Windows Game Library project.

Right-click the solution node,point toAdd,clickNew Project,and then select the Windows Game Library template.

Note
A Windows Game Library project is created instead of a Content Pipeline Extension Library project so that the class we will define can be used by both the content importer that runs at build-time and the content loader at game runtime.

In theNameBox,typeMyDataTypes,and then clickOK.
InSolution Explorer,double-click Class1.cs to edit the new library project file.

Replace the default template with the following code to define the class.

@H_502_75@

namespace MyDataTypes
{
    public class PetData
    {
        public string Name;
        public string Species;
        public float Weight;
        public int Age;
    }
}

To add an XML file to game content

In this procedure,the "MyDataTypes" library is added as a reference in the content project.

A new content item is created next.
In theAdd New Itemdialog Box,selectXML file (.xml)in the Templates pane.
The new "pets.xml" file automatically opens for editing.

Replace the contents of the template file with the following XML code:

@H_502_75@

XML

<?xml version="1.0" encoding="utf-8" ?>
<XnaContent>
  <Asset Type="MyDataTypes.PetData[]">
    <Item>
      <Name>Fifi</Name>
      <Species>Dog</Species>
      <Weight>11</Weight>
      <Age>6</Age>
    </Item>
    <Name>Bruno</Weight>21</Age>12</Name>Chloe</Species>Cat</Weight>6</Age>3</Name>Pickles</Species>Hamster</Weight>0.4</Age>1</Item>
  </Asset>
</XnaContent>

When you press F6 to build the solution,it should build successfully,including the custom game content imported from the XML file.

Loading XML Content at Runtime

Describes how to load custom game data at game runtime through the Content Pipeline.

This example concludes the procedure begun in the tutorialAdding an XML Content File to a Visual Studio Project.

Once custom game data is integrated as game content from an XML file through the Content Pipeline,it exists within your game runtime package in binary format. The data can beloaded at runtimethrough theContentManager.

To load the custom data in the game

The "MyDataTypes" library is added as a reference in the game project.

Add the using declaration for the MyDataTypes namespace.
@H_502_75@
using MyDataTypes;
Add a data declaration for an array of type PetData,the class defined in the "MyDataTypes" library.
@H_502_75@
PetData[] pets;
In theLoadContentoverride function,load the custom content.
@H_502_75@
protected override void LoadContent() { // Load the pet data table pets = Content.Load<PetData[]>("pets"); }
The custom game data now resides in the array of PetData objects.

ML Elements

The following base elements are recognized byXmlImporter Class:

Element	Parent	Children	Description
<XnaContent>	—	<Asset>	Top-level tag for XNA Content.
<Item>	Marks the asset. TheTypeattribute specifies the corresponding namespace and class of the matching data type.
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.

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:

@H_502_75@

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:

@H_502_75@

XML

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

XNA使用XML

Adding an XML Content File to a Visual Studio Project

Adding XML files to game content

To define game data

To add an XML file to game content

Loading XML Content at Runtime

To load the custom data in the game

XML Elements for XMLImporter

ML Elements

Example 1: Single Object

猜你在找的XML相关文章