This documentation is archived and is not being maintained.

XmlSerializerNamespaces Class

Contains the XML namespaces and prefixes that the XmlSerializer uses to generate qualified names in an XML-document instance.

Namespace:  System.Xml.Serialization
Assembly:  System.Xml (in System.Xml.dll)

public class XmlSerializerNamespaces

The XmlSerializerNamespaces contains a collection of XML namespaces, each with an associated prefix. The XmlSerializer uses an instance of the XmlSerializerNamespaces class to create qualified names in an XML document.

XML namespaces contained by the XmlSerializerNamespaces must conform to the specification named Namespaces in XML.

XML namespaces provide a way to qualify the names of XML elements and attributes in XML documents. A qualified name consists of a prefix and a local name, separated by a colon. The prefix functions only as a placeholder; it is mapped to a URI that specifies a namespace. The combination of the universally-managed URI namespace and the local name produces a name that is guaranteed to be universally unique.

To create qualified names in an XML document:

  1. Create an XmlSerializerNamespaces instance.

  2. Add each prefix and namespace pair that you want to the instance.

  3. Apply the appropriate.NET attribute to each property or class that the XmlSerializer serializes into an XML document. The available attributes are:

  1. Set the Namespace property of each attribute to one of the namespace values from the XmlSerializerNamespaces object.

  2. Pass the XmlSerializerNamespaces to the Serialize method of the XmlSerializer.


The creation of an empty namespace and prefix pair is not supported. That is, you cannot create a pair using the following code:

No code example is currently available or this language may not be supported.

The following example creates an XmlSerializerNamespaces object, and adds two prefix and namespace pairs to it. The example then passes the XmlSerializerNamespaces to the Serialize method, which serializes a Books object into an XML document. Using the XmlSerializerNamespaces object, the Serialize method qualifies each XML element and attribute with one of the two namespaces.

No code example is currently available or this language may not be supported.
#using <mscorlib.dll>
#using <System.Xml.dll>
using namespace System;
using namespace System::IO;
using namespace System::Xml;
using namespace System::Xml::Serialization;

public __gc class Price
   [XmlAttributeAttribute(Namespace = S"")]
   String* currency;
   [XmlElement(Namespace = S"")]
   Decimal price;

[XmlType(Namespace =S"")]
public __gc class Book
   [XmlElement(Namespace = S"")]
   String* TITLE;
   [XmlElement(Namespace =S"")]
   Price* PRICE;

public __gc class Books
   [XmlElement(Namespace = S"")]
   Book* Book;

public __gc class Run
   static void main()
      Run* test = new Run();

   void SerializeObject(String* filename)
      XmlSerializer* s = new XmlSerializer(__typeof(Books));
      // Writing a file requires a TextWriter.
      TextWriter* t = new StreamWriter(filename);

      /* Create an XmlSerializerNamespaces object and add two
      prefix-namespace pairs. */
      XmlSerializerNamespaces* ns = new XmlSerializerNamespaces();
      ns->Add(S"books", S"");
      ns->Add(S"money", S"");

      // Create a Book instance.
      Book* b = new Book();
      b->TITLE = S"A Book Title";
      Price* p = new Price();
      p->price = (Decimal) 9.95;
      p->currency = S"US Dollar";
      b->PRICE = p;
      Books* bks = new Books();
      bks->Book = b;

int main()


Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360, Zune

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0

XNA Framework

Supported in: 3.0, 2.0, 1.0