Share via


XmlConvert.DecodeName Method

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Decodes a name. This method does the reverse of the EncodeName and EncodeLocalName methods.

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

Syntax

'Declaration
Public Shared Function DecodeName ( _
    name As String _
) As String
public static string DecodeName(
    string name
)

Parameters

Return Value

Type: System.String
The decoded name.

Remarks

The names are decoded using the following rules:

  • Names are decoded from left to right.

  • Any sequence _x HHHH_ (where HHHH stands for a valid, four digit hexadecimal UCS-2 code) that has not been decoded is transformed into the corresponding Unicode 2.1 (Unicode 3.0 if supported by the application) character.

  • No shortforms are recognized. They are passed on without translation. For example, _x20_ or __ are not decoded.

NoteNote:

The actual encoding of the character is application-specific. For example, Order_x0020_Details becomes Order Details. Even escaped characters that are invalid in XML names will be recognized and decoded.

Examples

Dim output As New StringBuilder()
' Encode and decode a name with spaces.
Dim name1 As String = XmlConvert.EncodeName("Order Detail")
output.AppendLine("Encoded name: " + name1)
output.AppendLine("Decoded name: " + XmlConvert.DecodeName(name1))

' Encode and decode a local name.
Dim name2 As String = XmlConvert.EncodeLocalName("a:book")
output.AppendLine("Encoded local name: " + name2)
output.AppendLine("Decoded local name: " + XmlConvert.DecodeName(name2))

' Display the output to the TextBlock control
OutputTextBlock.Text = output.ToString()

StringBuilder output = new StringBuilder();
// Encode and decode a name with spaces.
string name1 = XmlConvert.EncodeName("Order Detail");
output.AppendLine("Encoded name: " + name1 );
output.AppendLine("Decoded name: " + XmlConvert.DecodeName(name1));

// Encode and decode a local name.
string name2 = XmlConvert.EncodeLocalName("a:book");
output.AppendLine("Encoded local name: " + name2);
output.AppendLine("Decoded local name: " + XmlConvert.DecodeName(name2));

// Display the output to the TextBlock control
OutputTextBlock.Text = output.ToString();

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.