XmlTextReader.GetNamespacesInScope(XmlNamespaceScope) Method

Definition

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

public:
 System::Collections::Generic::IDictionary<System::String ^, System::String ^> ^ GetNamespacesInScope(System::Xml::XmlNamespaceScope scope);
public System.Collections.Generic.IDictionary<string,string> GetNamespacesInScope (System.Xml.XmlNamespaceScope scope);
member this.GetNamespacesInScope : System.Xml.XmlNamespaceScope -> System.Collections.Generic.IDictionary<string, string>
Public Function GetNamespacesInScope (scope As XmlNamespaceScope) As IDictionary(Of String, String)

Parameters

scope
XmlNamespaceScope

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

Returns

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.

Remarks

Note

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

Applies to

See also