XmlTextReader::GetNamespacesInScope Method (XmlNamespaceScope)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets a collection that contains all namespaces currently in-scope.

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

public:
IDictionary<String^, String^>^ GetNamespacesInScope(
	XmlNamespaceScope scope
)

Parameters

scope
Type: System.Xml::XmlNamespaceScope

An XmlNamespaceScope value that specifies the type of namespace nodes to return.

Return Value

Type: System.Collections.Generic::IDictionary<String^, String^>^

An IDictionary object that contains all the current in-scope namespaces. If the reader is not positioned on an element, an empty dictionary (no namespaces) is returned.

System_CAPS_noteNote

Starting with the .NET Framework 2.0, we recommend that you create XmlReader instances by using the XmlReader::Create method to take advantage of new functionality.

The dictionary consists of a collection of namespace names keyed by prefix. It can be used to enumerate the in-scope namespaces. The dictionary is a disconnected copy of the namespace list of the reader. It remains unchanged as the reader position, current in-scope namespace list, changes.

The following table describes how the XmlNamespaceScope enumeration value affects the whether or not the default and built-in namespaces are returned by GetNamespacesInScope.

XmlNamespaceScope Value

xmlns:xml

xmlns:xmlns

xmlns=""

All

yes

no

no

ExcludeXml

no

no

no

Local

no

no

yes

.NET Framework
Available since 2.0
Return to top
Show: