This documentation is archived and is not being maintained.

XmlTextReader.GetNamespacesInScope Method

Note: This method is new in the .NET Framework version 2.0.

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
)
public IDictionary<String,String> GetNamespacesInScope (
	XmlNamespaceScope scope
)
public function GetNamespacesInScope (
	scope : XmlNamespaceScope
) : IDictionary<String,String>

Parameters

scope

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

Return Value

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.

NoteNote

In the Microsoft .NET Framework version 2.0 release, the recommended practice is to create XmlReader instances using the System.Xml.XmlReader.Create method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

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

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Supported in: 2.0

.NET Compact Framework

Supported in: 2.0
Show: