Partager via


XElement.GetDefaultNamespace Method

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

Gets the default XNamespace of this XElement.

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

Syntax

'Declaration
Public Function GetDefaultNamespace As XNamespace
public XNamespace GetDefaultNamespace()

Return Value

Type: System.Xml.Linq.XNamespace
An XNamespace that contains the default namespace of this XElement.

Remarks

Namespace declarations may be persisted as attributes in the XML tree. These special attributes declare namespaces, including default namespaces. This method finds the namespace declaration that declares the default namespace, if there is one, and returns the XNamespace for the default namespace.

If there is no attribute that declares the default namespace, then this method returns XNamespace.None.

When creating XML trees using C#, even if an XML tree would be serialized with a default namespace, if the namespace is not persisted in the XML tree as an attribute, this method will not report the namespace as the default namespace.

When creating XML trees using Visual Basic and XML literals, if you create the XML in a default namespace using the Imports statement, then a namespace attribute will be created in the tree by the Visual Basic compiler, and this method will report that namespace.

Examples

The following example creates an XML tree that has a default namespace. It then uses this method to retrieve the default namespace.

Dim output As New StringBuilder
'add the following line to the the Imports section:
'Imports <xmlns="https://www.adventure-works.com">

Dim e As XElement = <root/>
output.Append(String.Format("Default namespace: {0}", e.GetDefaultNamespace()))
output.Append(Environment.NewLine)

OutputTextBlock.Text = output.ToString()
StringBuilder output = new StringBuilder();
String xml = "<root xmlns='https://www.adventure-works.com'/>";
XElement e = XElement.Parse(xml);
output.Append("Default namespace: " + e.GetDefaultNamespace() + Environment.NewLine);

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.