XmlSerializerNamespaces.Add(String, String) Method

Reference

Definition

Namespace:: System.Xml.Serialization

Assemblies:: System.Xml.dll, System.Xml.XmlSerializer.dll

Assemblies:: netstandard.dll, System.Xml.ReaderWriter.dll

Assembly:: System.Xml.XmlSerializer.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Source:: XmlSerializerNamespaces.cs

Source:: XmlSerializerNamespaces.cs

Source:: XmlSerializerNamespaces.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Adds a prefix and namespace pair to an XmlSerializerNamespaces object.

public:
 void Add(System::String ^ prefix, System::String ^ ns);

public void Add(string prefix, string ns);

public void Add(string prefix, string? ns);

member this.Add : string * string -> unit

Public Sub Add (prefix As String, ns As String)

Parameters

prefix: String

The prefix associated with an XML namespace.

ns: String

An XML namespace.

Examples

The following example creates an XmlSerializerNamespaces object, and adds three prefix and namespace pairs to it by calling the Add method.

private:
   XmlSerializerNamespaces^ AddNamespaces()
   {
      XmlSerializerNamespaces^ xmlNamespaces =
         gcnew XmlSerializerNamespaces;
      
      // Add three prefix-namespace pairs.
      xmlNamespaces->Add( "money", "http://www.cpandl.com" );
      xmlNamespaces->Add( "books", "http://www.cohowinery.com" );
      xmlNamespaces->Add( "software", "http://www.microsoft.com" );

      return xmlNamespaces;
   }

private XmlSerializerNamespaces AddNamespaces()
{
   XmlSerializerNamespaces xmlNamespaces =
   new XmlSerializerNamespaces();

   // Add three prefix-namespace pairs.
   xmlNamespaces.Add("money", "http://www.cpandl.com");
   xmlNamespaces.Add("books", "http://www.cohowinery.com");
   xmlNamespaces.Add("software", "http://www.microsoft.com");

   return xmlNamespaces;
}

Private Function AddNamespaces() As XmlSerializerNamespaces
    Dim xmlNamespaces As New XmlSerializerNamespaces()
    
    ' Add three prefix-namespace pairs.
    xmlNamespaces.Add("money", "http://www.cpandl.com")
    xmlNamespaces.Add("books", "http://www.cohowinery.com")
    xmlNamespaces.Add("software", "http://www.microsoft.com")
    
    Return xmlNamespaces
End Function

Remarks

If you want the XmlSerializer to qualify the element and attribute names in an XML document, you must Add the prefix and namespace pairs to an XmlSerializerNamespaces object.

Any namespaces that you add must conform to the W3C Namespaces in XML specification.

Applies to

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

Share via